Checkpoint-Computer

Article
04/20/2010

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".

Share via