Checkpoint-Computer

Applies To: Windows PowerShell 2.0

Creates a system restore point on the local computer.

Checkpoint-Computer [-Description] <string> [[-RestorePointType] <string>] [<CommonParameters>]

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 7, Windows Vista, and Windows XP.

Specifies a descriptive name for the restore point. This parameter is required.

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.

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

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.

This cmdlet uses the CreateRestorePoint method of the SystemRestore class with a BEGIN_SYSTEM_CHANGE event.

C:\PS>checkpoint-computer -description "Install MyApp"

Description
-----------
This command creates a system restore point called "Install MyApp". It uses the default APPLICATION_INSTALL restore point type.

C:\PS>checkpoint-computer -description "ChangeNetSettings" -RestorePointType MODIFY_SETTINGS

Description
-----------
This command creates a MODIFY_SETTINGS system restore point called "ChangeNetSettings".

Disable-ComputerRestore
Enable-ComputerRestore
Get-ComputerRestorePoint
Restore-Computer