Get-SCVMCheckpoint

Get-SCVMCheckpoint

Gets virtual machine checkpoint objects from the VMM database.

構文

Parameter Set: Connection
Get-SCVMCheckpoint [-OnBehalfOfUser <System.String> ] [-OnBehalfOfUserRole <Microsoft.SystemCenter.VirtualMachineManager.UserRole> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: ID
Get-SCVMCheckpoint [-ID <Guid]> ] [-OnBehalfOfUser <System.String> ] [-OnBehalfOfUserRole <Microsoft.SystemCenter.VirtualMachineManager.UserRole> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: VM
Get-SCVMCheckpoint [-MostRecent] [-OnBehalfOfUser <System.String> ] [-OnBehalfOfUserRole <Microsoft.SystemCenter.VirtualMachineManager.UserRole> ] [-VM <VM> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

詳細説明

The Get-SCVMCheckpoint cmdlet gets one or more virtual machine checkpoint objects from the Virtual Machine Manager (VMM) database.

A virtual machine checkpoint is a point-in-time snapshot of a virtual machine. You can use the checkpoint to revert a virtual machine to a previous state. For more information about VMM checkpoints, type Get-Help New-VMCheckpoint -detailed.

パラメーター

-ID<Guid]>

Specifies the numerical identifier as a globally unique identifier (GUID) for a specific object.

-MostRecent

Specifies the most recent VMM virtual machine checkpoint object.

-OnBehalfOfUser<System.String>

-OnBehalfOfUserRole<Microsoft.SystemCenter.VirtualMachineManager.UserRole>

-VM<VM>

Specifies a virtual machine object.

-VMMServer<ServerConnection>

Specifies a VMM server object.

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

• VMCheckpoint

例

Example 1: Get all existing checkpoints for each virtual machine

This command gets all existing checkpoint objects for each virtual machine managed by VMMServer01, and then displays information about these checkpoint objects.

PS C:\> Get-SCVMCheckpoint -VMMServer "VMMServer01.Contoso.com"

Example Example 2: Get all checkpoints for one or more virtual machines with a specific name.

The first command gets all checkpoint objects for virtual machine VM01, and then stores the objects in the $Checkpoints object array.

The second command displays information about the checkpoint objects in $Checkpoints.

PS C:\> $Checkpoints = Get-SCVMCheckpoint -VM "VM01"
PS C:\> $Checkpoints

Example Example 3: Get the hardware profile of the most recently created checkpoint on a VM deployed on a Hyper-V host.

The first command gets the virtual machine object named VM01, and then stores the object in the $VM variable.

The second command gets the most recent checkpoint object created for VM01, and then stores the object in the $Checkpoint variable.

The last command displays information about the hardware profile for checkpoint stored in $Checkpoint. This is the most recent checkpoint object created for VM01.

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Checkpoint = $VM | Get-SCVMCheckpoint -MostRecent
PS C:\> $Checkpoint.CheckpointHWProfile

Example 4: Display the .NET type, events, methods, and properties for checkpoint objects

The first command gets all checkpoint objects on VMMServer01, and then stores the objects in the $Checkpoints object array.

The second command passes each checkpoint object in $Checkpoints to the Get-Member cmdlet, which displays the .NET TypeName and the Name, MemberType, and Definition for each event, method, and property associated with this object type.

The last command is the same as the second command except that it passes the output to the Format-List cmdlet by using the pipeline operator so that you can see the complete definition for each event, method, and property for the checkpoint object type.

PS C:\> $Checkpoints = Get-SCVMCheckpoint -VMMServer "VMMServer01.Contoso.com"
PS C:\> $Checkpoints | Get-Member
PS C:\> $Checkpoints | Get-Member | Format-List

関連トピック

New-SCVMCheckpoint

Remove-SCVMCheckpoint

Restore-SCVMCheckpoint

Set-SCVMCheckpoint

Get-SCVirtualMachine