リファレンス ガイド › AutoShell › AutoShell ロード可能モジュールのコマンド リファレンス › CA Microsoft Hyper-V AutoShell コマンド › dpmhv-createTemplateFromVM（Funclet）コマンド -- VM からテンプレートを作成する

dpmhv-createTemplateFromVM（Funclet）コマンド -- VM からテンプレートを作成する

dpmhv-createTemplateFromVM コマンドは、既存の VM を使用してテンプレートを作成します。 テンプレートを使用して複数の VM を作成できます。

テンプレートによって、VM の仕様および VM に接続された仮想ハード ディスクがコピーされます。 スナップショットを持つ VM を使用してテンプレートを作成する場合、スナップショットなしで現在の状態のみがエクスポートされます。 このコマンドは、各 Hyper-V Server のテンプレート カタログを作成します。 テンプレート カタログは以下の場所に保持され、以下の場所から照会できます： %ALLUSERSPROFILE%¥ca¥vpm¥Hyper-V_Templates¥TemplateCatalog.xml

このコマンドの形式は、以下のとおりです。

dpmhv-createTemplateFromVM 
-host hostname 
-vm vmname|-vmid vmguid 
-template templatename 
[-async] 
[-path pathname] 
[-description description]
[-retval] 
[-silent]

-host hostname

Hyper-V Server ホストの名前を指定します。

-vm vmname

VM の名前を指定します。

-vmid vmguid

VM の一意の ID を指定します。

-template templatename

（オプション）テンプレート カタログで作成された汎用テンプレートの名前を指定します。

注： テンプレート名はローカル テンプレート カタログ内で一意である必要があります。

-async

（オプション）コマンドを非同期で実行するには、このオプションを指定します。 デフォルトでは、このコマンドは同期して実行されます。

注： このオプションを実行する前にこのコマンドの実行が完了した場合、操作ステータスの確認に使用するジョブ ID が返されます。

-dest pathname

（オプション）作成する VM のパスを指定します（テンプレートが格納されます）。 このオプションを指定しない場合、VM は Hyper-V Server のデフォルトの場所に作成されます。 作成されたテンプレートの名前は次の場所に保存されます： %ALLUSERSPROFILE%¥ca¥vpm¥Hyper-V_Templates。

注： Hyper-V のデフォルトの場所に VM を作成しないことをお勧めします。 テンプレートを使用して VM を作成すると、仮想ディスク イメージ ファイル名が競合します。

-description description

（オプション）テンプレートの説明を指定します。

-retval

後で処理できるように値を返します。

-silent

画面に出力しないように指定します。

戻り値

dpmhv-createTemplateFromVM コマンドが同期で実行される場合、このコマンドは空の文字列を返します。 非同期で実行される場合、ジョブ ID を表す文字列が dpmhv-getJobErrorInfo、dpmhv-getJobInfo、または dpmhv-getJobStatus に渡されます。 実行中にエラーが発生した場合、コマンドは例外をレポートします。

例： VM からテンプレートを作成する

この例では、VM「TestVM」からテンプレート「MyTemplate」を作成します。

dpmhv-createTemplateFromVM -vm TestVM -template MyTemplate -host hvserver