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."
Related Links
PowerShell
Phản hồi
https://aka.ms/ContentUserFeedback.
Sắp ra mắt: Trong năm 2024, chúng tôi sẽ dần gỡ bỏ Sự cố với GitHub dưới dạng cơ chế phản hồi cho nội dung và thay thế bằng hệ thống phản hồi mới. Để biết thêm thông tin, hãy xem:Gửi và xem ý kiến phản hồi dành cho