PowerShell Logo Small

Get-ComputerRestorePoint



This is the built-in help made by Microsoft for the command 'Get-ComputerRestorePoint', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Gets the restore points on the local computer.

SYNTAX


Get-ComputerRestorePoint [[-RestorePoint] [<Int32[]>]] [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}] [-InformationVariable
[<System.String>]] [<CommonParameters>]
Get-ComputerRestorePoint [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}] [-InformationVariable [<System.String>]] -LastStatus
[<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Get-ComputerRestorePoint cmdlet gets the restore points on the local computer. This cmdlet can also display the status of the most recent attempt to restore the computer.


You can use the information returned by Get-ComputerRestorePoint to select a restore point, and you can use the sequence number to identify a restore point for the
Restore-Computer cmdlet.


System restore points and the Get-ComputerRestorePoint cmdlet are supported only on client operating systems, such as Windows 7, Windows Vista, and Windows XP.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/p/?linkid=290489
Checkpoint-Computer
Disable-ComputerRestore
Enable-ComputerRestore
Restart-Computer
Restore-Computer

REMARKS

<

Examples


-------------------------- EXAMPLE 1 --------------------------

PS C:\>get-computerrestorepoint



This command gets all of the restore points on the local computer.










-------------------------- EXAMPLE 2 --------------------------

PS C:\>get-computerrestorepoint -restorepoint 232, 240, 245



This command gets the restore points with sequence numbers 232, 240, and 245.










-------------------------- EXAMPLE 3 --------------------------

PS C:\>get-computerrestorepoint -laststatus
The last restore failed.



This command displays the status of the most recent system restore operation on the local computer.










-------------------------- EXAMPLE 4 --------------------------

PS C:\>get-computerrestorepoint | format-table SequenceNumber, @{Label="Date"; Expression={$_.ConvertToDateTime($_.CreationTime)}}, Description -auto

SequenceNumber Date Description
-------------- ---- -----------
253 8/5/2008 3:19:20 PM Windows Update
254 8/6/2008 1:53:24 AM Windows Update
255 8/7/2008 12:00:04 AM Scheduled Checkpoint
...



This command displays the restore points in a table for easy reading.

The Format-Table command includes a calculated property that uses the ConvertToDateTime method to convert the value of the CreationTime property from WMI format to a
DateTime object.










-------------------------- EXAMPLE 5 --------------------------

PS C:\>((get-computerrestorepoint)[-1]).sequencenumber



This command gets the sequence number of the most recently created restore point on the computer.

The command uses the -1 index to get the last item in the array that Get-ComputerRestorePoint returns.