Get-SCVMCheckpoint

参考

模块:: VirtualMachineManager

从 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变量中。

最后一个命令显示有关存储在$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 显示与此对象类型关联的每个事件、方法和属性的 .NET TypeName 和 Name、MemberType 和 Definition。

最后一个命令与第二个命令相同，只不过它通过管道将输出传递给 Format-List cmdlet，以便可以查看检查点对象类型的每个事件、方法和属性的完整定义。

参数

-ID

将数字标识符指定为特定对象的全局唯一标识符或 GUID。

类型:	Guid
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MostRecent

指定最新的 VMM 虚拟机检查点对象。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OnBehalfOfUser

指定用户的名称。此 cmdlet 将代表用户设置为此参数指定的用户。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OnBehalfOfUserRole

指定用户角色。若要获取用户角色，请使用 Get-SCUserRole cmdlet。此 cmdlet 代表此参数指定的用户角色运行。

类型:	UserRole
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VM

指定虚拟机对象。

类型:	VM
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-VMMServer

指定 VMM 服务器对象。

类型:	ServerConnection
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

输出

VMCheckpoint

此 cmdlet 返回 VMCheckpoint 对象。

通过