Get-ComputerRestorePoint

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

Get-ComputerRestorePoint
    -LastStatus
    [<CommonParameters>]

The Get-ComputerRestorePoint cmdlet gets the local computer's system restore points. And, it can display the status of the most recent attempt to restore the computer.

You can use the information from Get-ComputerRestorePoint to select a restore point. For example, use a 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 10, Windows 7, Windows Vista, and Windows XP.

In this example, Get-ComputerRestorePoint gets all the local computer's system restore points.

Get-ComputerRestorePoint

CreationTime           Description                    SequenceNumber    EventType         RestorePointType
------------           -----------                    --------------    ---------         ----------------
7/30/2019 09:17:24     Windows Update                 4                 BEGIN_SYSTEM_C... 17
8/5/2019  08:15:37     Installed PowerShell 7-prev... 5                 BEGIN_SYSTEM_C... APPLICATION_INSTALL
8/7/2019  12:56:45     Installed PowerShell 6-x64     6                 BEGIN_SYSTEM_C... APPLICATION_INSTALL

This example gets system restore points for specific sequence numbers.

Get-ComputerRestorePoint -RestorePoint 4, 5

CreationTime           Description                    SequenceNumber    EventType         RestorePointType
------------           -----------                    --------------    ---------         ----------------
7/30/2019 09:17:24     Windows Update                 4                 BEGIN_SYSTEM_C... 17
8/5/2019  08:15:37     Installed PowerShell 7-prev... 5                 BEGIN_SYSTEM_C... APPLICATION_INSTALL

Get-ComputerRestorePoint uses the RestorePoint parameter to specify a comma-separated array of sequence numbers.

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

Get-ComputerRestorePoint -LastStatus

The last attempt to restore the computer failed.

Get-ComputerRestorePoint uses the LastStatus parameter to display the result of the most recent system restore.

Get-ComputerRestorePoint outputs the CreationTime as a Windows Management Instrumentation (WMI) date and time string.

In this example, a variable stores an expression that converts the CreationTime string to a DateTime object. To view CreationTime strings before they're converted, use a command such as ((Get-ComputerRestorePoint).CreationTime). For more information about the WMI date and time string, see CIM_DATETIME.

$date = @{Label="Date"; Expression={$_.ConvertToDateTime($_.CreationTime)}}
Get-ComputerRestorePoint | Select-Object -Property SequenceNumber, $date, Description

SequenceNumber   Date                 Description
--------------   ----                 -----------
             4   7/30/2019 09:17:24   Windows Update
             5   8/5/2019  08:15:37   Installed PowerShell 7-preview-x64
             6   8/7/2019  12:56:45   Installed PowerShell 6-x64

The $date variable stores a hash table with the expression that uses the ConvertToDateTime method. The expression converts the CreationTime property's value from a WMI string to a DateTime object.

Get-ComputerRestorePoint sends the system restore point objects down the pipeline. Select-Object uses the Property parameter to specify the properties to display. For each object in the pipeline, the expression in $date converts the CreationTime and outputs the result in the Date property.

This example gets a sequence number by using the SequenceNumber property and an array index. The output only contains the sequence number.

((Get-ComputerRestorePoint).SequenceNumber)[-1]

6

Get-ComputerRestorePoint uses the SequenceNumber property with an array index. The array index of -1 gets the most recent sequence number in the array.

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

You can't send objects down the pipeline to Get-ComputerRestorePoint.

Get-ComputerRestorePoint returns a SystemRestore object, which is an instance of the Windows Management Instrumentation (WMI) SystemRestore class.

When you use the LastStatus parameter, Get-ComputerRestorePoint returns a string.

To run a Get-ComputerRestorePoint command on Windows Vista and later versions of Windows, open PowerShell with the Run as administrator option.

Get-ComputerRestorePoint uses the WMI SystemRestore class.