Checkpoint-Computer
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.
System restore points and the Checkpoint-Computer
cmdlet are supported only on client operating
systems, such as Windows 10 or Windows 11. Checkpoint-Computer
cannot create more than one
checkpoint each day.
Examples
Example 1: Create a system restore point
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: Create a system MODIFY_SETTINGS restore point
Checkpoint-Computer -Description "ChangeNetSettings" -RestorePointType MODIFY_SETTINGS
This command creates a MODIFY_SETTINGS
system restore point called "ChangeNetSettings".
Parameters
-Description
Specifies a descriptive name for the restore point. This parameter is required.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RestorePointType
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
The cmdlet accepts CANCELLED_OPERATION
but this type of restore point operation is no longer
supported. For more information about these types, see the
Restore Point Description Text documentation.
Type: | String |
Aliases: | RPT |
Accepted values: | APPLICATION_INSTALL, APPLICATION_UNINSTALL, DEVICE_DRIVER_INSTALL, MODIFY_SETTINGS, CANCELLED_OPERATION |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
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.
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."