前のトピック: dpmhv-createVM(Funclet)コマンド -- VM を作成する次のトピック: dpmhv-createVMFromTemplateEx(Funclet)コマンド -- テンプレートを使用して VM を作成する


dpmhv-createVMFromTemplate(Funclet)コマンド -- テンプレートを使用して VM を作成する

dpmhv-createVMFromTemplate コマンドは、以前に作成した Microsoft System Center Virtual Machine Manager(SCVMM)テンプレートから VM を作成します。また、オプションで Windows イメージの設定をカスタマイズします。

1 つのテンプレートを使用して任意の数の仮想マシンを作成できるように、テンプレートは変更せずに保持されます。 このコマンドは SCVMM がホストするテンプレートのみをサポートします。 SCVMM を使用しないローカル テンプレートのサポートについては、dpmhv-createVMFromTemplateEx を参照してください。

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

dpmhv-createVMFromTemplate 
-host hostname 
-vm vmname 
-template templatename 
-dest pathname
-scvmmHost  scvmmHostname
-adminPass adminPW
[-computerName computerName] 
[-ip4addr ip4addr] 
[-ip4dhcp ip4dhcpInt] 
[-ip4mask ip4mask] 
[-ip4gw ip4gw]
[-ip4metric ip4metric] 
[-ip4dns ip4dns]
[-productKey key]
[-userName UserName]
[-organization orgname] 
[-domain domainname] 
[-domainAdmin domad] 
[-domainAdminPass dompw] 
[-workgroup wgname] 
[-adminUser adminUser] 
[-adminUserPass adminUserPW]
[-mem mem]
[-cpus cpus]
[-hardwareProf hwprof]
[-guestOSProf osprof]
[-startVM]
-host hostname

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

-vm vmname

VM の名前を指定します。

-template templatename

VM の作成に使用するソース テンプレートの名前を指定します。

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

-dest pathname

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

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

-scvmmHost scvmmHostname

(オプション) Microsoft System Center Virtual Machine Manager (SCVMM)ライブラリ サーバのホスト名を指定します。 VM のプロビジョニングで SCVMM の統合を使用する場合に、このパラメータは有効です。

-adminPass adminPW

(オプション)このオプションは、VM のデフォルト管理者アカウントのパスワードを設定するために使用されます。 このパラメータをサポートするには、Sysprep ツールを使用して作成された Windows イメージが必要です。 非同期実行の場合、このパラメータは無視されます。

注: このオプションを正常に設定するには、Sysprep ツールを使用して、Windows サーバ管理者のパスワードを空に設定します。

-computerName computerName

(オプション)VM のコンピュータ名を指定します。 このパラメータをサポートするには、Sysprep ツールを使用するイメージが必要です。 このオプションは、コマンドを非同期で実行する場合は無効です。

-ip4addr ip4addr

(オプション)VM のインターフェースに割り当てる静的 IPv4 アドレスを指定します。 特定のインターフェースの IP アドレスを設定するには、IP アドレスの前に、既知のインターフェース名と区切り記号として「#」が付けられます。 たとえば、
-ip4addr "Local Area Connection#192.168.1.200" などです。 テンプレート イメージに複数のネットワーク アダプタがある場合、IP アドレスは最初のインターフェースに割り当てられます。 このオプションは、コマンドを非同期で実行する場合は無効です。

-ip4dhcp ip4dhcpInt

(オプション)VM の特定のインターフェースの DHCP をオンにするオプションを指定します。 このオプションにはインターフェース名も指定できます。 たとえば、
-ip4dhcp "Local Area Connection" などです。テンプレート イメージに複数のネットワーク アダプタがある場合、最初のインターフェースの DHCP がオンになります。 このオプションは、コマンドを非同期で実行する場合は無効です。

デフォルト: local

-ip4mask ip4mask

(オプション)VM に割り当てるサブネット マスクを指定します。 このオプションは、
-ip4ddr オプションと共に使用されます。 インターフェース名を
-ip4addr オプションに指定する場合、このオプションにも同じインターフェース名を使用する必要があります。 このパラメータをサポートするには、Sysprep ツールを使用して作成された Windows イメージが必要です。 このオプションは、コマンドを非同期で実行する場合は無効です。

-ip4gw ip4gw

(オプション)VM のゲートウェイを設定するオプションを指定します。 このオプションは、-ip4ddr オプションと共に使用します。 このパラメータをサポートするには、Sysprep ツールを使用して作成された Windows イメージが必要です。 このオプションは、コマンドを非同期で実行する場合は無効です。

注: インターフェース名を
-ip4addr オプションに指定する場合、このオプションにも同じインターフェース名を使用する必要があります。

-ip4metric ip4metric

(オプション)VM に設定するインターフェース メトリックを指定します。 このオプションは、-ip4ddr オプションと共に使用します。 インターフェース名を
-ip4addr オプションに指定する場合、このオプションにも同じインターフェース名を使用する必要があります。 このパラメータをサポートするには、Sysprep ツールを使用して作成された Windows イメージが必要です。 このオプションは、コマンドを非同期で実行する場合は無効です。

デフォルト: 1

-ip4dns ip4dns

(オプション)VM に設定する DNS サーバを指定します。 このオプションは、-ip4ddr オプションと共に使用します。 インターフェース名を
-ip4addr オプションに指定する場合、このオプションにも同じインターフェース名を使用する必要があります。 このパラメータをサポートするには、Sysprep ツールを使用して作成された Windows イメージが必要です。 このオプションは、コマンドを非同期で実行する場合は無効です。

-adminPass adminPW

(オプション)このオプションは、VM のデフォルト管理者アカウントのパスワードを設定するために使用されます。 このパラメータをサポートするには、Sysprep ツールを使用して作成された Windows イメージが必要です。 非同期実行の場合、このパラメータは無視されます。

注: このオプションを正常に設定するには、Sysprep ツールを使用して、Windows Server 2003 の管理者パスワードを空に設定します。

-productKey key

(オプション)VM の Windows 製品アクティベーション キーを指定します。 このパラメータをサポートするには、Sysprep ツールを使用して作成された Windows イメージが必要です。 このオプションは、コマンドを非同期で実行する場合は無効です。

-userName UserName

(オプション)新しい VM にインストールされる、(sysprep ツールを使用して作成された)Windows イメージのユーザ名を指定します。 このパラメータをサポートするには、Sysprep ツールを使用して作成された Windows イメージが必要です。 このオプションは、コマンドを非同期で実行する場合は無効です。

-organization orgname

(オプション)新しい VM にインストールされる、(sysprep ツールを使用して作成された)Windows イメージの組織名を指定します。 このパラメータをサポートするには、Sysprep ツールを使用して作成された Windows イメージが必要です。 このオプションは、コマンドを非同期で実行する場合は無効です。

-domain domainname

(オプション)VM のドメイン名を指定します。 このパラメータをサポートするには、Sysprep ツールを使用して作成された Windows イメージが必要です。 このオプションは、コマンドを非同期で実行する場合は無効です。 ドメインとワークグループの仕様を同時に指定することはできません。

-domainAdmin domad

(オプション)ドメインに作成するドメイン管理者のユーザ アカウントを指定します。 このパラメータをサポートするには、Sysprep ツールを使用して作成された Windows イメージが必要です。 このオプションは、コマンドを非同期で実行する場合は無効です。

-domainAdminPass dompw

(オプション)ドメインに作成するドメイン管理者ユーザ アカウントのパスワードを指定します。 このパラメータをサポートするには、Sysprep ツールを使用して作成された Windows イメージが必要です。 このオプションは、コマンドを非同期で実行する場合は無効です。

-workgroup wgname

(オプション)VM 用に作成するワークグループを指定します。 このパラメータをサポートするには、Sysprep ツールを使用して作成された Windows イメージが必要です。 ドメインとワークグループの仕様を同時に指定することはできません。 このオプションは、コマンドを非同期で実行する場合は無効です。

-adminUser adminUser

(オプション)デフォルトの Administrators グループの一部として作成する管理者ユーザ名を指定します。 このパラメータをサポートするには、Sysprep ツールを使用して作成された Windows イメージが必要です。 このオプションは、コマンドを非同期で実行する場合は無効です。

-adminUserPass adminUserPW

(オプション)デフォルトの Administrators グループの一部として作成する管理者ユーザ アカウントのパスワードを指定します。 このパラメータをサポートするには、Sysprep ツールを使用して作成された Windows イメージが必要です。 このオプションは、コマンドを非同期で実行する場合は無効です。

-mem mem

(オプション)作成する VM の RAM メモリをメガバイト(MB)で指定します。

デフォルト: -1

-cpus cpus

(オプション) VM に割り当てる CPU コアの数を指定します。

デフォルト: -1

-scvmmHost scvmmHostname

(オプション) Microsoft System Center Virtual Machine Manager (SCVMM)ライブラリ サーバのホスト名を指定します。 VM のプロビジョニングで SCVMM の統合を使用する場合に、このパラメータは有効です。

-hardwareProf hwprof

(オプション) Microsoft System Center Virtual Machine Manager (SCVMM)ライブラリ サーバで定義されているハードウェア プロファイルの名前を指定します。 このパラメータは、SCVMM テンプレートに保存されているハードウェア設定を上書きします。 VM のプロビジョニングで SCVMM の統合を使用する場合に、このパラメータは有効です。

-guestOSProf osprof

(オプション) Microsoft System Center Virtual Machine Manager (SCVMM)ライブラリ サーバで定義されているゲスト オペレーティング システム プロファイルの名前を指定します。 このパラメータは、SCVMM テンプレートに保存されているオペレーティング システム設定を上書きします。 VM のプロビジョニングで SCVMM の統合を使用する場合に、このパラメータは有効です。

-startVM

(オプション)VM の作成後に VM を自動的に起動するためのオプションを指定します。 デフォルトでは、新しい VM は電源がオフの状態です。 VM を起動するのに必要な IP 設定オプションをカスタマイズする必要があります。

戻り値

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

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

この例では、SCVMM テンプレートから VM を作成し、ハードウェアおよびゲスト OS プロファイルを指定するオプションを使用します。

dpmhv-createVMFromTemplate -host hvserver -vm NewVM -dest c:¥VMs¥NewBox -template Win2k3Clean 
-scvmmHost SCVMMLibSrv -hardwareProf hw_def -guestOSProf os_def -async -adminPass #admin#

関連項目

dpmhv-createVMFromTemplateEx(Funclet)コマンド -- テンプレートを使用して VM を作成する