powershellscripts.com

Tutorials  PowerShell Cmdlet Help for Get-ComputerRestorePoint



NAME
Get-ComputerRestorePoint

SYNOPSIS
Gets the restore points on the local computer.

SYNTAX
Get-ComputerRestorePoint [[-RestorePoint] ] []

Get-ComputerRestorePoint -LastStatus []


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 seq
uence number to identify a restore point for the Restore-Computer cmdlet.


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


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 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 y
ou 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 PowerShe
ll with the "Run as administrator" option.

This cmdlet uses the Windows Management Instrumentation (WMI) SystemRestore class.


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

C:\PS>get-computerrestorepoint


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





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

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


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





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

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

C:\PS>get-computerrestorepoint | format-table SequenceNumber, @{Label="Date"; Expression={$_.ConvertToDateTime($_.C
reationTime)}}, 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 --------------------------

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.






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