powershellscripts.com

Tutorials  PowerShell Cmdlet Help for Restore-Computer



NAME
Restore-Computer

SYNOPSIS
Starts a system restore on the local computer.

SYNTAX
Restore-Computer [-RestorePoint] [-Confirm] [-WhatIf] []


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
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 []
Prompts you for confirmation before executing the command.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-WhatIf []
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


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 paramet
er 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 resto
re operation. Because the Restore-Computer command forces a restart, this command would be entered when the compute
r restarted.






RELATED LINKS
Online version: http://go.microsoft.com/fwlink/?LinkID=135254
Get-ComputerRestorePoint
Enable-ComputerRestore
Disable-ComputerRestore
Restart-Computer