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
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
チェックポイントの説明を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| 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 |
-Name
VMM オブジェクトの名前を指定します。
| 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 |
-VM
仮想マシン オブジェクトを指定します。
| Type: | VM |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| 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 |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
出力
VMCheckpoint
このコマンドレットは 、VMCheckpoint オブジェクトを返します。