Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Checkpoint-Computer

Checkpoint-Computer

microsoft.powershell.commands.management.dll

Synopsis

Creates a system restore point on the local computer.

Syntax

Checkpoint-Computer [-Description] [-RestorePointType] [<CommonParameters>]

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

Beginning in Windows 8, Checkpoint-Computer cannot create more than one checkpoint each day.

Parameters

-Description <String>

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

Aliases

None

Required?

true

Position

1

Default value

None

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.

Aliases

None

Required?

false

Position

2

Default value

APPLICATION_INSTALL

Accept pipeline input?

false

Accept wildcard characters?

false

Input Type

None

Return Type

None

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

Examples

-------------------------- EXAMPLE 1 --------------------------

This command creates a system restore point called "Install MyApp". It uses the default APPLICATION_INSTALL restore point type.

PS C:\>Checkpoint-Computer -Description "Install MyApp"

-------------------------- EXAMPLE 2 --------------------------

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

PS C:\>Checkpoint-Computer -Description "ChangeNetSettings" -RestorePointType MODIFY_SETTINGS

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