Checkpoint-Computer

Creates a system restore point on the local computer.
Checkpoint-Computer [-Description*] <String> [[-RestorePointType] {APPLICATION_INSTALL | APPLICATION_UNINSTALL |DEVICE_DRIVER_INSTALL | MODIFY_SETTINGS | CANCELLED_OPERATION}] [<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 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>

  • This value is required

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

-RestorePointType [<String>]

Specifies the type of restore point. The default is APPLICATION_INSTALL.

The acceptable values for this parameter are:

— APPLICATION_INSTALL– APPLICATION_UNINSTALL– DEVICE_DRIVER_INSTALL– MODIFY_SETTINGS– CANCELLED_OPERATION

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,ErrorAction, ErrorVariable, WarningAction, WarningVariable,OutBuffer, PipelineVariable, and OutVariable.

Inputs

None

You cannot pipe objects to Checkpoint-Computer.

Outputs

None

This cmdlet does not generate any output.

Examples
  1. Create a system restore point:
    PS C:> Checkpoint-Computer -Description "Install MyApp"
    

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

  2. Create a system MODIFY_SETTINGS restore point:
    PS C:> Checkpoint-Computer -Description "ChangeNetSettings" -RestorePointType MODIFY_SETTINGS
    

    This command creates a MODIFY_SETTINGS system restore point called “ChangeNetSettings”.

Additional 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."
Related Links

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