Msvm_VirtualSystemManagementService クラスの DefineSystem メソッド

新しい仮想マシン インスタンスを作成します。 指定されていないプロパティには既定値が設定されます。

構文

uint32 DefineSystem(
  [in]  string                           SystemSettings,
  [in]  string                           ResourceSettings[],
  [in]  CIM_VirtualSystemSettingData REF ReferenceConfiguration,
  [out] CIM_ComputerSystem           REF ResultingSystem,
  [out] CIM_ConcreteJob              REF Job
);

パラメーター

SystemSettings [in]

型: string

作成する仮想マシンの属性を定義するために使用される Msvm_VirtualSystemSettingData クラスの埋め込みインスタンス。 このパラメーターは必須です。

ResourceSettings [in]

型: string[]

Msvm_ResourceAllocationSettingData クラス (またはその派生クラス) の埋め込みインスタンスの数。 これらのインスタンスを組み合わせて、仮想マシンの仮想リソースについて説明します。 このパラメーターが設定されているかどうかに関係なく、仮想マシンの既定のデバイス セットが作成されます。 たとえば、プロセッサとメモリは自動的に作成され、既定値で構成されます。

ReferenceConfiguration [in]

種類: CIM_VirtualSystemSettingData

参照仮想マシン構成の最上位オブジェクトである Msvm_VirtualSystemSettingData クラスのインスタンスへの参照。 SystemSettings パラメーターと ResourceSettings パラメーターがそれぞれの情報を提供しなかった場合は、新しい仮想マシンの構成を補完するために参照構成が使用されます。

ResultingSystem [out]

種類: CIM_ComputerSystem

新しく作成された仮想マシンを表す CIM_ComputerSystem クラスのインスタンスへの参照。

ジョブ [out]

種類: CIM_ConcreteJob

操作が非同期に実行された場合、このメソッドは 4096 を返し、このパラメーターには CIM_ConcreteJob から派生したオブジェクトへの参照が含 まれます。

戻り値

型: uint32

このメソッドを同期的に実行すると、成功した場合は 0 が返されます。 このメソッドを非同期に実行すると、4096 が返され、 Job 出力パラメーターを使用して非同期操作の進行状況を追跡できます。 その他の戻り値はエラーを示します。

エラーなしで完了 (0)

サポートされていません (1)

失敗 ( 2)

タイムアウト (3)

無効なパラメーター (4)

DMTF 予約済み (..)

チェックされたメソッド パラメーター - ジョブの開始 (4096)

メソッド予約済み (4097..32767)

ベンダー固有 (32768..65535)

注釈

UAC フィルター処理によって 、Msvm_VirtualSystemManagementService クラスへのアクセスが制限される場合があります。 詳細については、「 ユーザー アカウント制御と WMI」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリのみ]
名前空間	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
[DLL]	Vmms.exe

こちらもご覧ください

Msvm_VirtualSystemManagementService