共用方式為

Get-SCVMCheckpoint

  • 參考
模組:
VirtualMachineManager

從 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 物件。