Creates a system restore point on the local computer.
Syntax
Checkpoint-Computer [-Description] <string> [[-RestorePointType] <string>] [<CommonParameters>]
Description
The Checkpoint-Computer cmdlet creates a system restore point on the local computer. This cmdlet runs only on Windows Vista and Windows XP.
Parameters
-Description <string>
Specifies a descriptive name for the restore point. This parameter is required.
|
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.
|
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.
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 Checkpoint-Computer. |
|
Outputs |
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.
Example 1
C:\PS>checkpoint-computer -description "Install MyApp" This command creates a system restore point called "Install MyApp". It uses the default APPLICATION_INSTALL restore point type.
Example 2
C:\PS>checkpoint-computer -description "ChangeNetSettings" -RestorePointType MODIFY_SETTINGS This command creates a MODIFY_SETTINGS system restore point called "ChangeNetSettings".
See Also