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]
-
類型： 字串
用來定義要建立之虛擬機器屬性 之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)
備註
Msvm_VirtualSystemManagementService 類別的 存取可能會受到 UAC 篩選的限制。 如需詳細資訊，請參閱 使用者帳戶控制和 WMI。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2012 [僅限傳統型應用程式] |
| 命名空間 |
Root\Virtualization\V2 |
| MOF |
|
| DLL |
|