创建新的虚拟机实例。 未指定的属性将使用默认值填充。
语法
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)
备注
UAC 筛选可能会限制对 Msvm_VirtualSystemManagementService 类的访问。 有关详细信息，请参阅 用户帐户控制和 WMI。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows 8 [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2012 [仅限桌面应用] |
| 命名空间 |
Root\Virtualization\V2 |
| MOF |
|
| DLL |
|