Checkpoint-Computer

  • 参考
模块:
Microsoft.PowerShell.Management

在本地计算机上创建系统还原点。

语法

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

说明

Checkpoint-Computer cmdlet 在本地计算机上创建系统还原点。

系统还原点和 Checkpoint-Computer cmdlet 仅在客户端操作系统（如 Windows 10 或 Windows 11）上受支持。 Checkpoint-Computer 不能每天创建多个检查点。

示例

示例 1：创建系统还原点

Checkpoint-Computer -Description "Install MyApp"

此命令将创建一个名为 Install MyApp 的系统还原点。 它使用默认 APPLICATION_INSTALL 还原点类型。

示例 2：创建系统 MODIFY_SETTINGS 还原点

Checkpoint-Computer -Description "ChangeNetSettings" -RestorePointType MODIFY_SETTINGS

此命令创建名为 MODIFY_SETTINGS “ChangeNetSettings”的系统还原点。

参数

-Description

指定还原点的描述性名称。 此参数是必需的。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-RestorePointType

指定还原点的类型。 默认为 APPLICATION_INSTALL。

此参数的可接受值为：

  • APPLICATION_INSTALL
  • APPLICATION_UNINSTALL
  • DEVICE_DRIVER_INSTALL
  • MODIFY_SETTINGS
  • CANCELLED_OPERATION

cmdlet 接受 CANCELLED_OPERATION ，但不再支持这种类型的还原点操作。 有关这些类型的详细信息，请参阅 “还原点说明文本 ”文档。

类型:String
别名:RPT
接受的值:APPLICATION_INSTALL, APPLICATION_UNINSTALL, DEVICE_DRIVER_INSTALL, MODIFY_SETTINGS, CANCELLED_OPERATION
Position:1
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

None

不能通过管道将对象传递给 Checkpoint-Computer。

输出

None

此 cmdlet 将不生成任何输出。

备注

  • 此 cmdlet 对 BEGIN_SYSTEM_CHANGE 事件使用 SystemRestore 类的 CreateRestorePoint 方法。

  • 从 Windows 8 开始，Checkpoint-Computer 每日创建的系统还原点不能超过一个。 如果你尝试在 24 小时内再创建一个新的还原点，则 Windows PowerShell 将生成以下错误：

    "A new system restore point cannot be created because one has already been created within the past 24 hours. Please try again later."