Gets the restore points on the local computer.

Syntax

  Copy Code
Get-ComputerRestorePoint [[-RestorePoint] <Int32[]>] [<CommonParameters>]

Get-ComputerRestorePoint -LastStatus [<CommonParameters>]

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.

Parameters

-LastStatus

Gets the status of the most recent system restore operation.

Required?

true

Position?

named

Default Value

False

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RestorePoint <Int32[]>

Gets the restore points with the specified sequence numbers. Enter the sequence numbers of one or more restore points. By default, Get-ComputerRestorePoint gets all restore points on the local computer.

Required?

false

Position?

1

Default Value

All restore points

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This command supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, OutBuffer, OutVariable, WarningAction, and WarningVariable. For more information, see about_CommonParameters.

Inputs and Outputs

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet returns.

Inputs

None

You cannot pipe objects to this cmdlet.

Outputs

System.Management.ManagementObject#root\default\SystemRestore or String.

Get-ComputerRestore returns a SystemRestore object, which is an instance of the WMI SystemRestore class. When you use the LastStatus parameter, this cmdlet returns a string.

Notes

To run a Get-ComputerRestorePoint 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

  Copy Code
C:\PS>get-computerrestorepoint

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






Example 2

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

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






Example 3

  Copy Code
C:\PS>get-computerrestorepoint -laststatus

The last restore failed.

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






Example 4

  Copy Code
C:\PS>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
...

Description
-----------
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

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

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






See Also