PowerShell Logo Small

Get-ComputerRestorePoint



This is the built-in help made by Microsoft for the command 'Get-ComputerRestorePoint', in PowerShell version 4 - as retrieved from Windows version 'Microsoft Windows 8.1 Enterprise' 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[]>] [<CommonParameters>]
Get-ComputerRestorePoint -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 c
omputer.


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 Re
store-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.