Restore-SCVMCheckpoint
指定したチェックポイントに仮想マシンを復元します。
構文
Restore-SCVMCheckpoint
-VMCheckpoint <VMCheckpoint>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]説明
Restore-SCVMCheckpoint コマンドレットは、仮想マシンを指定されたチェックポイントに復元します。 仮想マシン チェックポイントは、仮想マシンの特定の時点の "スナップショット" です。 チェックポイントを使用して、仮想マシンを以前の状態に戻すことができます。
復元操作が成功した場合、 Restore-VMCheckpoint コマンドレットはチェックポイント オブジェクトを返します。 操作が失敗した場合は、エラー メッセージを返します。
仮想マシンを以前のチェックポイントに復元すると、最新のチェックポイントが作成されてから仮想マシンに加えられたすべての変更が破棄されます。 ただし、仮想マシンを復元するチェックポイントの後に行われたチェックポイントを含め、すべてのチェックポイントは引き続き使用できます。 そのため、仮想マシンを復元する前に新しいチェックポイントを作成し、復元操作後に仮想マシンの現在の状態を使用できるようにすることをお勧めします。
例
例 1: 仮想マシンを最新のチェックポイントに復元する
PS C:\> Get-SCVMCheckpoint -VM "VM01" -MostRecent | Restore-SCVMCheckpointこのコマンドは、仮想マシン VM01 の最新のチェックポイント オブジェクトを取得し、VM01 を最新のチェックポイントが作成された時点の状態に復元します。
例 2: 指定したチェックポイントに仮想マシンを復元する
PS C:\> $Checkpoints = Get-SCVMCheckpoint -VM "VM02"
PS C:\> Restore-SCVMCheckpoint -VMCheckpoint $Checkpoints[$Checkpoints.count - 2]最初のコマンドは、仮想マシン VM02 のすべてのチェックポイント オブジェクトを取得し、$Checkpoints オブジェクト配列にオブジェクトを格納します。
2 番目のコマンドは、VM02 を最後から 2 番目のチェックポイントに復元します (この例では、少なくとも 2 つのチェックポイントがあることを前提としています)。 VMM は、復元先のチェックポイントの後に作成されたチェックポイントを保持し、仮想マシンを後のチェックポイントに復元できるようにします。 仮想マシンを最新のチェックポイントに復元するには、例 1 を参照してください。
例 3: 仮想マシンで最後に復元されたチェックポイントのハードウェア プロファイルを表示する
PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $VM.LastRestoredVMCheckpoint.CheckpointHWProfile最初のコマンドは、VM02 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。この例では、仮想マシンがいずれかのチェックポイントに復元されていることを前提としています。
2 番目のコマンドは、VM02 で最後に復元されたチェックポイントのハードウェア プロファイルに関する情報を表示します。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。
| Type: | String |
| 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 |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソース最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMCheckpoint
仮想マシン マネージャー (VMM) 仮想マシン チェックポイント オブジェクトを指定します。
| Type: | VMCheckpoint |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
出力
VMCheckpoint
このコマンドレットは 、VMCheckpoint オブジェクトを返します。
メモ
- Get-SCVMCheckpoint コマンドレットを使用して取得できる VMM チェックポイント オブジェクトが必要です。