DefineVirtualSystem method of the CIM_VirtualSystemManagementService class

Creates a new virtual computer system instance.

Syntax

uint32 DefineVirtualSystem(
  [in]  string                           SystemSettingData,
  [in]  string                           ResourceSettingData[],
  [in]  CIM_VirtualSystemSettingData REF SourceSetting,
  [out] CIM_ComputerSystem           REF DefinedSystem,
  [out] CIM_ConcreteJob              REF Job
);

Parameters

SystemSettingData [in]

An Embedded instance of the CIM_VirtualSystemSettingData class.

ResourceSettingData [in]

An optional parameter that contains a number of embedded instances of the CIM_ResourceAllocationSettingData class (or derived classes thereof). Together these instances describe the virtual resources of the virtual computer system. A default set of devices will be created for the virtual system regardless of whether this parameter is set. For example, processor and memory are automatically created and configured with default values

SourceSetting [in]

reference to an existing instance of CIM_VirtualSystemSettingData to use as a template for the new virtual computer system.

DefinedSystem [out]

A reference to the newly created virtual computer system.

Job [out]

An optional reference that is returned if the operation is executed asynchronously.

Requirements

Namespace
Root\virtualization
MOF
WindowsVirtualization.mof

See also

CIM_VirtualSystemManagementService