Método DefineSystem de la clase Msvm_VirtualSystemManagementService
Crea una nueva instancia de máquina virtual. Las propiedades que no se especifican se rellenarán con valores predeterminados.
Sintaxis
uint32 DefineSystem(
[in] string SystemSettings,
[in] string ResourceSettings[],
[in] CIM_VirtualSystemSettingData REF ReferenceConfiguration,
[out] CIM_ComputerSystem REF ResultingSystem,
[out] CIM_ConcreteJob REF Job
);
Parámetros
-
SystemSettings [in]
-
Tipo: cadena
Instancia insertada de la clase Msvm_VirtualSystemSettingData que se usa para definir los atributos de la máquina virtual que se van a crear. Este parámetro es obligatorio.
-
ResourceSettings [in]
-
Tipo: string[]
Número de instancias incrustadas de la clase Msvm_ResourceAllocationSettingData (o clases derivadas de la misma). Juntas estas instancias describen los recursos virtuales de la máquina virtual. Se creará un conjunto predeterminado de dispositivos para la máquina virtual, independientemente de si se establece este parámetro. Por ejemplo, el procesador y la memoria se crean y configuran automáticamente con valores predeterminados.
-
ReferenceConfiguration [in]
-
Tipo: CIM_VirtualSystemSettingData
Referencia a una instancia de la clase Msvm_VirtualSystemSettingData que es el objeto de nivel superior de una configuración de máquina virtual de referencia. La configuración de referencia se usa para complementar la configuración de la nueva máquina virtual si los parámetros SystemSettings y ResourceSettings no proporcionaron información respectiva.
-
ResultsSystem [out]
-
Tipo: CIM_ComputerSystem
Referencia a una instancia de la clase CIM_ComputerSystem que representa la máquina virtual recién creada.
-
Trabajo [out]
-
Tipo: CIM_ConcreteJob
Si la operación se realiza de forma asincrónica, este método devolverá 4096 y este parámetro contendrá una referencia a un objeto derivado de CIM_ConcreteJob.
Valor devuelto
Tipo: uint32
Si este método se ejecuta de forma sincrónica, devuelve 0 si se ejecuta correctamente. Si este método se ejecuta de forma asincrónica, devuelve 4096 y el parámetro de salida job se puede usar para realizar un seguimiento del progreso de la operación asincrónica. Cualquier otro valor devuelto indica un error.
-
Completado sin error (0)
-
No compatible (1)
-
Error (2)
-
Tiempo de espera (3)
-
Parámetro no válido (4)
-
DMTF Reserved (..)
-
Parámetros del método activados: trabajo iniciado (4096)
-
Método Reservado (4097..32767)
-
Específico del proveedor (32768..65535)
Comentarios
El acceso a la clase Msvm_VirtualSystemManagementService podría estar restringido por el filtrado de UAC. Para obtener más información, vea Control de cuentas de usuario y WMI.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2012 [solo aplicaciones de escritorio] |
| Espacio de nombres |
Root\Virtualization\V2 |
| MOF |
|
| Archivo DLL |
|