Set-SCVMCheckpoint
修改 VMM 中虛擬機器檢查點物件的屬性。
Syntax
Set-SCVMCheckpoint
-VMCheckpoint <VMCheckpoint>
[-Description <String>]
[-Name <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Description
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 變數中。
最後一個命令會修改 VM03 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 提示 (PRO 提示的識別碼) 。 此參數可讓您稽核 PRO 秘訣。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
表示作業會以非同步方式執行，讓控制項立即返回命令殼層。
| 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 來擷取。