Edit

Share via

Restore-Computer

  • Reference
Module:
Microsoft.PowerShell.Management

Starts a system restore on the local computer.

Syntax

Restore-Computer
       [-RestorePoint] <Int32>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

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.

Examples

Example 1: Restore the local computer

Restore-Computer -RestorePoint 253

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

Example 2: Restore the local computer with confirmation

PS> 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.

Example 3: Restore a computer and check the status

Get-ComputerRestorePoint
Restore-Computer -RestorePoint 255
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.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RestorePoint

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

Type:Int32
Aliases:SequenceNumber, SN, RP
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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 the Windows operating system, open Windows PowerShell by using the Run as administrator option.
  • This cmdlet uses the Windows Management Instrumentation (WMI) SystemRestore class.