Get-SCVMCheckpoint
從 VMM 資料庫取得虛擬機器檢查點物件。
Syntax
Get-SCVMCheckpoint
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Get-SCVMCheckpoint
[-VM <VM>]
[-VMMServer <ServerConnection>]
[-MostRecent]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Get-SCVMCheckpoint
[-VMMServer <ServerConnection>]
[-ID <Guid>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Description
Get-SCVMCheckpoint Cmdlet 會從 Virtual Machine Manager (VMM) 資料庫取得一或多個虛擬機器檢查點物件。
虛擬機器檢查點是虛擬機器的時間點「快照集」。
您可以使用檢查點將虛擬機器還原為先前的狀態。
如需 VMM 檢查點的詳細資訊，請輸入 Get-Help New-VMCheckpoint -Detailed 。
範例
範例 1：取得每個虛擬機器的所有現有檢查點
PS C:\> Get-SCVMCheckpoint -VMMServer "VMMServer01.Contoso.com"此命令會取得 VMMServer01 所管理之每部虛擬機器的所有現有檢查點物件，並向使用者顯示這些檢查點物件的相關資訊。
範例 2：取得具有特定名稱之一或多部虛擬機器的所有檢查點
PS C:\> $Checkpoints = Get-SCVMCheckpoint -VM "VM01"
PS C:\> $Checkpoints第一個命令會取得虛擬機器 VM01 的所有檢查點物件，並將物件儲存在$Checkpoints物件陣列中。
第二個命令會顯示$Checkpoints中檢查點物件的相關資訊。
範例 3：取得部署在 Hyper-V 主機上之 VM 上最近建立檢查點的硬體設定檔
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Checkpoint = $VM | Get-SCVMCheckpoint -MostRecent
PS C:\> $Checkpoint.CheckpointHWProfile第一個命令會取得名為 VM01 的虛擬機器物件，並將物件儲存在 $VM 變數中。
第二個命令會取得為 VM01 建立的最新檢查點物件，並將物件儲存在$Checkpoint變數中。
最後一個命令會顯示儲存在 $Checkpoint (VM01) 所建立之最新檢查點物件之硬體設定檔的相關資訊。
範例 4：顯示檢查點物件的 .NET 類型、事件、方法和屬性
PS C:\> $Checkpoints = Get-SCVMCheckpoint -VMMServer "VMMServer01.Contoso.com"
PS C:\> $Checkpoints | Get-Member
PS C:\> $Checkpoints | Get-Member | Format-List第一個命令會取得 VMMServer01 上的所有檢查點物件，並將物件儲存在$Checkpoints物件陣列中。
第二個命令會將$Checkpoints中的每個檢查點物件傳遞至 Get-Member Cmdlet，此 Cmdlet 會顯示與這個物件類型相關聯的每個事件、方法和 Definition 的 .NET TypeName 和 Name、MemberType 和 Definition。
最後一個命令與第二個命令相同，不同之處在于它會使用管線將輸出傳送至 Format-List Cmdlet，讓您可以查看檢查點物件類型之每個事件、方法和屬性的完整定義。
參數
-ID
將數值識別碼指定為特定物件的全域唯一識別碼或 GUID。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MostRecent
指定最近期的 VMM 虛擬機器檢查點物件。
| Type: | SwitchParameter |
| 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
指定使用者角色。 若要取得使用者角色，請使用 Get-SCUserRole Cmdlet。 此 Cmdlet 代表此參數所指定的使用者角色運作。
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VM
指定虛擬機器物件。
| Type: | VM |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMMServer
指定 VMM 伺服器物件。
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
輸出
VMCheckpoint
此 Cmdlet 會傳回 VMCheckpoint 物件。