Get-SCVMCheckpoint
从 VMM 数据库获取虚拟机检查点对象。
语法
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>]说明
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变量中。
最后一个命令显示有关存储在 VM01) 的最新检查点对象$Checkpoint (存储的检查点的硬件配置文件的信息。
示例 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 显示 .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 对象。