Starts a system restore on the local computer. (Restore-Computer)
# NAME
Restore-Computer
# SYNOPSIS
Starts a system restore on the local computer.
# SYNTAX
Restore-Computer [-RestorePoint] <int> [-Confirm] [-WhatIf] [<CommonParameters>]
# DESCRIPTION
The Restore-Computer cmdlet restores the local computer to the specified system restore point.
A Restore-Computer command restarts the computer. The restore is completed during the restart operation.
# PARAMETERS
-RestorePoint <int>
Specifies the sequence number of the restore point. To find the sequence number, use Get-ComputerRestorePoint. This parameter is required.
Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before executing the command.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Describes what would happen if you executed the command without actually executing the command.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".
# INPUTS
None
You cannot pipe input to this cmdlet.
# OUTPUTS
None
This cmdlet does not generate any output.
# NOTES
To run a Restore-Computer command on Windows Vista and later versions of Windows, open Windows PowerShell with the "Run as administrator" option.
This cmdlet uses the Windows Management Instrumentation (WMI) SystemRestore class.
# EXAMPLE 1
C:\PS>restore-computer -RestorePoint 253
# Description
-----------
This command restores the local computer to the restore point with sequence number 253.
Because the RestorePoint parameter is positional, you can omit the parameter name.
# EXAMPLE 2
C:\PS>restore-computer 255 -confirm
Confirm
Are you sure you want to perform this action?
Performing operation "Restore-Computer" .
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
# Description
-----------
This command restores the local computer to the restore point with sequence number 255. It uses the Confirm parameter to prompt the user before actually performing the operation.
# EXAMPLE 3
C:\PS>Get-ComputerRestorePoint
C:\PS> Restore-Computer -RestorePoint 255
C:\PS> Get-ComputerRestorePoint -LastStatus
# Description
-----------
These commands run a system restore and then check its status.
The first command uses the Get-ComputerRestorePoint cmdlet to get the restore points on the local computer.
The second command uses Restore-Computer to restore the computer to the restore point with sequence number 255.
The third command uses the LastStatus parameter of Get-ComputerRestorePoint cmdlet to check the status of the restore operation. Because the Restore-Computer command forces a restart, this command would be entered when the computer restarted.
RELATED LINKS
Online version: http://go.microsoft.com/fwlink/?LinkID=135254
Get-ComputerRestorePoint
Enable-ComputerRestore
Disable-ComputerRestore
Restart-Computer
C:\Windows>powershell get-help Add-Computer -full
ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2014 Microsoft Corporation.