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 コマンドレットは、仮想マシン マネージャー (VMM) データベースから 1 つ以上の仮想マシン チェックポイント オブジェクトを取得します。

仮想マシン チェックポイントは、仮想マシンの特定の時点の "スナップショット" です。 チェックポイントを使用して、仮想マシンを以前の状態に戻すことができます。 VMM チェックポイントの詳細については、「 Get-Help New-VMCheckpoint -Detailed.

例

例 1: 各仮想マシンのすべての既存のチェックポイントを取得する

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

このコマンドは、VMMServer01 によって管理される各仮想マシンのすべての既存のチェックポイント オブジェクトを取得し、これらのチェックポイント オブジェクトに関する情報をユーザーに表示します。

例 2: 特定の名前を持つ 1 つ以上の仮想マシンのすべてのチェックポイントを取得する

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

最初のコマンドは、仮想マシン VM01 のすべてのチェックポイント オブジェクトを取得し、$Checkpoints オブジェクト配列にオブジェクトを格納します。

2 番目のコマンドは、$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 変数に格納します。

2 番目のコマンドは、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 オブジェクト配列にオブジェクトを格納します。

2 番目のコマンドは、$Checkpoints内の各チェックポイント オブジェクトを Get-Member コマンドレットに渡します。このコマンドレットでは、このオブジェクト型に関連付けられている各イベント、メソッド、プロパティの .NET TypeName と Name、MemberType、Definition が表示されます。

最後のコマンドは、チェックポイント オブジェクトの種類のイベント、メソッド、およびプロパティの完全な定義を確認できるように、Format-List コマンドレットに出力をパイプする点を除いて、2 番目のコマンドと同じです。

パラメーター

-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

ユーザーの名前を指定します。 このコマンドレットは、このパラメーターが指定するユーザーとしてユーザーの代理を設定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

ユーザー ロールを指定します。 ユーザー ロールを取得するには、 Get-SCUserRole コマンドレットを 使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールの代わりに動作します。

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

このコマンドレットは 、VMCheckpoint オブジェクトを返します。