< Back
Reset-ComputerMachinePassword
Post
NAME Reset-ComputerMachinePassword
SYNOPSIS
Resets the machine account password for the computer.
SYNTAX
Reset-ComputerMachinePassword [-Confirm] [-Credential <PSCredential>] [-Server <String>] [-WhatIf] [<CommonParameters>]
DESCRIPTION
The Reset-ComputerMachinePassword cmdlet changes the computer account password that the computers use to authenticate to the domain controllers in
the domain. You can use it to reset the password of the local computer.
PARAMETERS
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Credential <PSCredential>
Specifies a user account that has permission to perform this action. The default is the current user.
Type a user name, such as User01 or Domain01\\User01, or enter a PSCredential object, such as one generated by the Get-Credential cmdlet. If
you type a user name, this cmdlet prompts you for a password.
This parameter was introduced in Windows PowerShell 3.0.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Server <String>
Specifies the name of a domain controller to use when this cmdlet sets the computer account password.
This parameter is optional. If you omit this parameter, a domain controller is chosen to service the command.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
You cannot pipe input to this cmdlet.
OUTPUTS
None
This cmdlet does not generate any output.
NOTES
Example 1: Reset the password for the local computer
PS C:\\>Reset-ComputerMachinePassword
This command resets the computer password for the local computer. The command runs with the credentials of the current user.
Example 2: Reset the password for the local computer by using a specified domain controller
PS C:\\>Reset-ComputerMachinePassword -Server "DC01" -Credential Domain01\\Admin01
This command resets the computer password of the local computer by using the DC01 domain controller. It uses the Credential parameter to specify a
user account that has permission to reset a computer password in the domain.
Example 3: Reset the password on a remote computer
PS C:\\>Invoke-Command -ComputerName "Server01" -ScriptBlock {Reset-ComputerMachinePassword}
This command uses the Invoke-Command cmdlet to run a Reset-ComputerMachinePassword command on the Server01 remote computer.
For more information about remote commands in Windows PowerShell, see about_Remote and Invoke-Command .
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=821623
SYNOPSIS
Resets the machine account password for the computer.
SYNTAX
Reset-ComputerMachinePassword [-Confirm] [-Credential <PSCredential>] [-Server <String>] [-WhatIf] [<CommonParameters>]
DESCRIPTION
The Reset-ComputerMachinePassword cmdlet changes the computer account password that the computers use to authenticate to the domain controllers in
the domain. You can use it to reset the password of the local computer.
PARAMETERS
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Credential <PSCredential>
Specifies a user account that has permission to perform this action. The default is the current user.
Type a user name, such as User01 or Domain01\\User01, or enter a PSCredential object, such as one generated by the Get-Credential cmdlet. If
you type a user name, this cmdlet prompts you for a password.
This parameter was introduced in Windows PowerShell 3.0.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Server <String>
Specifies the name of a domain controller to use when this cmdlet sets the computer account password.
This parameter is optional. If you omit this parameter, a domain controller is chosen to service the command.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
You cannot pipe input to this cmdlet.
OUTPUTS
None
This cmdlet does not generate any output.
NOTES
Example 1: Reset the password for the local computer
PS C:\\>Reset-ComputerMachinePassword
This command resets the computer password for the local computer. The command runs with the credentials of the current user.
Example 2: Reset the password for the local computer by using a specified domain controller
PS C:\\>Reset-ComputerMachinePassword -Server "DC01" -Credential Domain01\\Admin01
This command resets the computer password of the local computer by using the DC01 domain controller. It uses the Credential parameter to specify a
user account that has permission to reset a computer password in the domain.
Example 3: Reset the password on a remote computer
PS C:\\>Invoke-Command -ComputerName "Server01" -ScriptBlock {Reset-ComputerMachinePassword}
This command uses the Invoke-Command cmdlet to run a Reset-ComputerMachinePassword command on the Server01 remote computer.
For more information about remote commands in Windows PowerShell, see about_Remote and Invoke-Command .
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=821623