New-SCVMCheckpoint
VMM によって管理されるホストに展開された仮想マシンのチェックポイントを作成します。
構文
New-SCVMCheckpoint
[-VM] <VM>
[-VMMServer <ServerConnection>]
[-Description <String>]
[-Name <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]説明
New-SCVMCheckpoint コマンドレットは、Virtual Machine Manager (VMM) によって管理されるホストにデプロイされた仮想マシンのチェックポイントを作成します。 チェックポイントを使用して、仮想マシンを以前の状態に復元できます。
一般的な用途は、更新プログラムをオペレーティング システムまたは仮想マシン上のアプリケーションにインストールする前にチェックポイントを作成して、更新が失敗した場合や仮想マシンに悪影響を与えた場合に、Restore-SCVMCheckpoint コマンドレットを使用して仮想マシンを以前の状態に戻すことができるようにすることです。
Hyper-V ホスト、VMware ESX ホスト、または Citrix XenServer ホストにデプロイされた仮想マシンの場合、VMM は仮想マシンを停止せずにチェックポイントを作成するため、サービスの中断は発生しません。
仮想マシンをチェックポイントに復元する前に、仮想マシン上のデータ ファイルをバックアップすることが重要です。 仮想マシンを復元すると、その仮想ハード ディスク上のユーザー データ ファイルが以前の状態に戻ります。
チェックポイントを使用すると、システムやアプリケーションの更新などの変更後に仮想マシンを以前の状態に復元できますが、チェックポイントではオペレーティング システム、アプリケーション、またはファイルの永続的なバックアップは提供されません。 チェックポイントは、ホスト上の仮想マシンと共に格納されます。 そのため、ホストが失敗した場合、そのホストにデプロイされている仮想マシンのチェックポイントは失われます。
仮想マシンのデータ保護を提供するには、ボリューム シャドウ コピー サービス (VSS) を使用します。 Data Protection Manager (DPM) などのバックアップ アプリケーションを使用して、任意の種類のホスト上の仮想マシンを外部ストレージにバックアップできます。
セルフサービス ユーザーに、仮想マシンのチェックポイントを作成および管理するためのアクセス許可を付与できます。
詳細については、「Get-Help Set-VMMUserRole -Detailed」と入力します。
例
例 1: 同じ名前を持ち、異なるホスト上に存在する仮想マシンの仮想マシン チェックポイントを作成する
PS C:\> $Checkpoints = Get-SCVirtualMachine -Name "VM01" | New-SCVMCheckpoint
PS C:\> $Checkpoints最初のコマンドは、VM01 という名前の仮想マシン オブジェクトを取得します (この例では、複数のホストに VM01 という名前の仮想マシンが含まれていることを前提としています)、仮想マシン オブジェクトごとにチェックポイントを作成し、チェックポイント オブジェクトを $Checkpoints オブジェクト配列に格納します。
2 番目のコマンドは、$Checkpointsに格納されている各チェックポイント オブジェクトに関する情報をユーザーに表示します。
例 2: 仮想マシンの仮想マシン チェックポイントを非同期的に作成する
PS C:\> Get-SCVirtualMachine -Name "VM02" | New-SCVMCheckpoint -RunAsynchronously -JobVariable "NewCheckpiontJob"
PS C:\> Write-Host $NewCheckpointJobこの例では、例 1 と同じ方法でチェックポイントを作成します。ただし、このコマンドは RunAsynchronously パラメーターを使用してすぐにコマンド シェルに制御を戻し、JobVariable パラメーターを使用してジョブの進行状況を追跡し、進行状況のレコードを NewCheckpointJob 変数に格納します。 JobVariable パラメーターを使用する場合は、ドル記号 ($) を使用して変数を作成しません。
2 番目のコマンドは、$NewCheckpointJobの内容を表示します。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
チェックポイントの説明を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
VMM オブジェクトの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザーの名前を指定します。 このコマンドレットは、このパラメーターが指定するユーザーとしてユーザーの代理を設定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。
| 型: | UserRole |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VM
仮想マシン オブジェクトを指定します。
| 型: | VM |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
| 型: | ServerConnection |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
出力
VMCheckpoint
このコマンドレットは、VMCheckpoint オブジェクトを返します。