Checkpoint-Computer

Applies To: Windows PowerShell 2.0

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

Parameters

-Description <string>

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

Required?

true

Position?

1

Default Value

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RestorePointType <string>

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.

Required?

false

Position?

2

Default Value

APPLICATION_INSTALL

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

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

Inputs and Outputs

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.

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.

Example 1

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.





Example 2

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

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





See Also

Concepts

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