다음을 통해 공유

Checkpoint-Computer

모듈:
Microsoft.PowerShell.Management Module

Creates a system restore point on the local computer.

구문

Default (기본값) 

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.

예제

Example 1: Create a system restore point

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

Checkpoint-Computer -Description "ChangeNetSettings" -RestorePointType MODIFY_SETTINGS

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

매개 변수

-Description

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값: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.

매개 변수 속성

형식:String
Default value:None
허용되는 값:APPLICATION_INSTALL, APPLICATION_UNINSTALL, DEVICE_DRIVER_INSTALL, MODIFY_SETTINGS, CANCELLED_OPERATION
와일드카드 지원:False
DontShow:False
별칭:RPT

매개 변수 집합

(All)
Position:1
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

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

입력

None

You cannot pipe objects to Checkpoint-Computer.

출력

None

This cmdlet does not generate any output.

참고

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