Set-SCVMCheckpoint
修改 VMM 中虚拟机检查点对象的属性。
语法
Set-SCVMCheckpoint
-VMCheckpoint <VMCheckpoint>
[-Description <String>]
[-Name <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]说明
Set-SCVMCheckpoint cmdlet 修改 Virtual Machine Manager (VMM) 中的虚拟机检查点对象的属性。
有关创建 VMM 检查点的信息，请键入 Get-Help New-SCVMCheckpoint -Detailed。
示例
示例 1：将所有检查点的说明设置为指定的字符串
PS C:\> Get-SCVMCheckpoint | Set-SCVMCheckpoint -Description "All checkpoints created prior to upgrade"此命令从 VMM 数据库获取所有现有检查点对象，并更新这些检查点的说明。
示例 2：修改所有检查点的名称和说明
PS C:\> Get-SCVMCheckpoint | Set-SCVMCheckpoint -Name "Checkpoint Before Upgrade" -Description "Checkpoint was created prior to upgrade"此命令获取所有现有检查点对象，并修改每个对象的名称和说明。
示例 3：修改检查点数组中的特定检查点
PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> Set-SCVMCheckpoint -VMCheckpoint $VM.VMCheckpoints[0] -Description "First Checkpoint Before Upgrade"第一个命令获取名为 VM03 的虚拟机对象，并将该对象存储在$VM变量中。
最后一个命令修改 VMCheckpoints 数组中 VMCheckpoints 数组中第一个检查点对象的说明。
参数
-Description
指定检查点的说明。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
指定跟踪作业进度，并将其存储在此参数命名的变量中。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
指定 VMM 对象的名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
指定用户的名称。 此 cmdlet 将代表用户设置为此参数指定的用户。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
指定用户角色。 此 cmdlet 将代表用户角色设置为此参数指定的用户角色。 若要获取用户角色对象，请使用 Get-SCUserRole cmdlet。
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
指定触发此操作 (PRO 提示) 的性能和资源优化提示的 ID。 此参数允许审核 PRO 提示。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
指示作业异步运行，以便控件立即返回到命令 shell。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMCheckpoint
指定一个 VMM 虚拟机检查点对象。
| Type: | VMCheckpoint |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
输出
VMCheckpoint
此 cmdlet 返回 VMCheckpoint 对象。
备注
- 需要 VMM 检查点对象，可以使用 Get-SCVMCheckpoint cmdlet 进行检索。