0% found this document useful (0 votes)
44 views4 pages

Checkpoint-Computer (Microsoft - PowerShell.Management) - PowerShell - Microsoft Learn

The Checkpoint-Computer cmdlet in PowerShell creates a system restore point on local client operating systems like Windows 10 and 11, with a maximum of one checkpoint allowed per day. It requires a description for the restore point and optionally allows specifying a restore point type. The cmdlet does not generate output and cannot accept piped input.

Uploaded by

Sathi Natarajan
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
44 views4 pages

Checkpoint-Computer (Microsoft - PowerShell.Management) - PowerShell - Microsoft Learn

The Checkpoint-Computer cmdlet in PowerShell creates a system restore point on local client operating systems like Windows 10 and 11, with a maximum of one checkpoint allowed per day. It requires a description for the restore point and optionally allows specifying a restore point type. The cmdlet does not generate output and cannot accept piped input.

Uploaded by

Sathi Natarajan
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 4

7/8/25, 12:32 PM Checkpoint-Computer (Microsoft.PowerShell.

Management) - PowerShell | Microsoft Learn

Checkpoint-Computer
Module: Microsoft.PowerShell.Management

Creates a system restore point on the local computer.

Syntax
PowerShell

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


PowerShell

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


PowerShell

https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.management/checkpoint-computer?view=powershell-5.1 1/4
7/8/25, 12:32 PM Checkpoint-Computer (Microsoft.PowerShell.Management) - PowerShell | Microsoft Learn

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.

ノ Expand table

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.

https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.management/checkpoint-computer?view=powershell-5.1 2/4
7/8/25, 12:32 PM Checkpoint-Computer (Microsoft.PowerShell.Management) - PowerShell | Microsoft Learn

ノ Expand table

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 False


input:

Accept wildcard False


characters:

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:

https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.management/checkpoint-computer?view=powershell-5.1 3/4
7/8/25, 12:32 PM Checkpoint-Computer (Microsoft.PowerShell.Management) - PowerShell | Microsoft Learn

"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

https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.management/checkpoint-computer?view=powershell-5.1 4/4

You might also like