Skip to content

Latest commit

 

History

History
71 lines (49 loc) · 2.1 KB

Reset-LapsPassword.md

File metadata and controls

71 lines (49 loc) · 2.1 KB
description external help file Module Name online version schema Locale ms.date title
Causes Windows Local Administrator Password Solution (LAPS) to immediately rotate the password for the currently managed local account.
lapspsh.dll-Help.xml
LAPS
2.0.0
en-US
04/10/2023
Reset-LapsPassword

Reset-LapsPassword

SYNOPSIS

Causes Windows Local Administrator Password Solution (LAPS) to immediately rotate the password for the currently managed local account.

SYNTAX

Reset-LapsPassword [<CommonParameters>]

DESCRIPTION

The Reset-LapsPassword cmdlet tells LAPS to immediately rotate the password for the currently managed local account. This operation is performed regardless of the state of the current password, for example it doesn't matter whether the current password is considered expired or not.

Important

This cmdlet is intended and recommended only for rare situations that require an immediate password rotation, for example as a response to a machine security breach situation. Excessively frequent usage of this cmdlet isn't recommended.

The cmdlet doesn't return detailed information about the results of the operation. See Use Windows LAPS event logs for more information on querying the resultant event log entries to get specific information on the outcome of the operation.

EXAMPLES

Example 1

Reset-LapsPassword

This example forces immediate rotation of the managed local account.

PARAMETERS

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

None

OUTPUTS

System.Object

NOTES

RELATED LINKS

Windows LAPS Overview