.png)
Checkpoint-Computer
Published: February 29, 2012
Updated: November 12, 2012
Applies To: Windows PowerShell 2.0, Windows PowerShell 3.0
Checkpoint-Computer
Syntax
Parameter Set: Default Checkpoint-Computer [-Description] <String> [[-RestorePointType] <String> ] [ <CommonParameters>]
Detailed Description
The Checkpoint-Computer cmdlet creates a system restore point on the local computer.
System restore points and the Checkpoint-Computer cmdlet are supported only on client operating systems, such as Windows 8, Windows 7, Windows Vista, and Windows XP.
Beginning in Windows 8, Checkpoint-Computer cannot create more than one checkpoint each day.
Parameters
-Description<String>
Specifies a descriptive name for the restore point. This parameter is required.
|
Aliases |
none |
|
Required? |
true |
|
Position? |
1 |
|
Default Value |
none |
|
Accept Pipeline Input? |
false |
|
Accept Wildcard Characters? |
false |
-RestorePointType<String>
Specifies the type of restore point. The default is APPLICATION_INSTALL.
Valid values are APPLICATION_INSTALL, APPLICATION_UNINSTALL, DEVICE_DRIVER_INSTALL, MODIFY_SETTINGS, and CANCELLED_OPERATION.
|
Aliases |
none |
|
Required? |
false |
|
Position? |
2 |
|
Default Value |
APPLICATION_INSTALL |
|
Accept Pipeline Input? |
false |
|
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
-
None
You cannot pipe objects to Checkpoint-Computer.
Outputs
The output type is the type of the objects that the cmdlet emits.
-
None
This cmdlet does not generate any output.
Notes
-
This cmdlet uses the CreateRestorePoint method of the SystemRestore class with a BEGIN_SYSTEM_CHANGE event.
-
Beginning in Windows 8, Checkpoint-Computer cannot create more than one system restore point each day. If you try to create a new restore point before the 24-hour period has elapsed, Windows PowerShell generates the following error:
"A new system restore point cannot be created because one has already been created within the past 24 hours. Please try again later.
Examples
-------------------------- EXAMPLE 1 --------------------------
This command creates a system restore point called "Install MyApp". It uses the default APPLICATION_INSTALL restore point type.
PS C:\> Checkpoint-Computer -Description "Install MyApp"
-------------------------- EXAMPLE 2 --------------------------
This command creates a MODIFY_SETTINGS system restore point called "ChangeNetSettings".
PS C:\> Checkpoint-Computer -Description "ChangeNetSettings" -RestorePointType MODIFY_SETTINGS
Related topics
