Restore-Computer

Starts a system restore on the local computer.
Restore-Computer [-RestorePoint*] <Int32> [-Confirm] [-WhatIf] [<CommonParameters>]

The Restore-Computer cmdlet restores the local computer to the specified system restore point.

Restore-Computer restarts the computer. The restore is completed during the restart operation.

System restore points and Restore-Computer are supported only on client operating systems, such as Windows 7, Windows Vista, and Windows XP.

Parameters
-RestorePoint <Int32>

  • This value is required

Specifies the sequence number of the restore point. To find the sequence number, use the Get-ComputerRestorePoint cmdlet. This parameter is required.

-Confirm [<SwitchParameter>]

  • Default value is false

Prompts you for confirmation before running the cmdlet.Prompts you for confirmation before running the cmdlet.

-WhatIf [<SwitchParameter>]

  • Default value is false

Shows what would happen if the cmdlet runs. The cmdlet is not run.Shows what would happen if the cmdlet runs. The cmdlet is not run.

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,ErrorAction, ErrorVariable, WarningAction, WarningVariable,OutBuffer, PipelineVariable, and OutVariable.

Inputs

None

You cannot pipe input to this cmdlet.

Outputs

None

This cmdlet does not generate any output.

Examples
  1. Restore the local computer:
    PS C:> Restore-Computer -RestorePoint 253
    

    This command restores the local computer to the restore point that has sequence number 253.

  2. Restore the local computer with confirmation:
    PS C:> Restore-Computer -RestorePoint 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"):
    

    This command restores the local computer to the restore point that has sequence number 255. It uses the Confirm parameter to prompt the user before actually performing the operation.

  3. Restore a computer and check the status:
    PS C:> Get-ComputerRestorePoint
    PS C:>  Restore-Computer -RestorePoint 255
    PS C:>  Get-ComputerRestorePoint -LastStatus
    

    These commands run a system restore and then check its status.

    The first command uses Get-ComputerRestorePoint to get the restore points on the local computer.

    The second command restores 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 Restore-Computer forces a restart, this command would be entered after the computer restarts.

Additional Notes
 To run a Restore-Computer command on Windows Vista and later versions of the Windows operating system, open 
 Windows PowerShell by using the Run as administrator option.
 This cmdlet uses the Windows Management Instrumentation (WMI) SystemRestore class.
Related Links

Checkpoint-Computer
Disable-ComputerRestore
Enable-ComputerRestore
Get-ComputerRestorePoint
Restart-Computer