Export (0) Print
Expand All

Checkpoint-Computer

Updated: August 9, 2015

Checkpoint-Computer

Creates a system restore point on the local computer.

Syntax

Parameter Set: Default
Checkpoint-Computer [-Description] <String> [[-RestorePointType] <String> {APPLICATION_INSTALL | APPLICATION_UNINSTALL | DEVICE_DRIVER_INSTALL | MODIFY_SETTINGS | CANCELLED_OPERATION} ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <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

-InformationAction<System.Management.Automation.ActionPreference>

Aliases

ia

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-InformationVariable<System.String>

Aliases

iv

Required?

false

Position?

named

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

RPT

Required?

false

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • None

    You cannot pipe objects to Checkpoint-Computer.


Outputs

The output type is the type of the objects that the cmdlet emits.

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

Examples

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

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


Checkpoint-Computer -Description "Install MyApp"

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

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


Checkpoint-Computer -Description "ChangeNetSettings" -RestorePointType MODIFY_SETTINGS

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2015 Microsoft