Metodo DefineSystem della classe Msvm_VirtualSystemManagementService
Crea una nuova istanza di macchina virtuale. Le proprietà non specificate verranno popolate con valori predefiniti.
Sintassi
uint32 DefineSystem(
[in] string SystemSettings,
[in] string ResourceSettings[],
[in] CIM_VirtualSystemSettingData REF ReferenceConfiguration,
[out] CIM_ComputerSystem REF ResultingSystem,
[out] CIM_ConcreteJob REF Job
);
Parametri
-
SystemSettings [in]
-
Tipo: stringa
Istanza incorporata della classe Msvm_VirtualSystemSettingData usata per definire gli attributi della macchina virtuale da creare. Questo parametro è obbligatorio.
-
ResourceSettings [in]
-
Tipo: string[]
Numero di istanze incorporate della classe Msvm_ResourceAllocationSettingData (o classi derivate). Insieme queste istanze descrivono le risorse virtuali della macchina virtuale. Verrà creato un set predefinito di dispositivi per la macchina virtuale indipendentemente dal fatto che questo parametro sia impostato. Ad esempio, il processore e la memoria vengono creati e configurati automaticamente con valori predefiniti.
-
ReferenceConfiguration [in]
-
Tipo: CIM_VirtualSystemSettingData
Riferimento a un'istanza della classe Msvm_VirtualSystemSettingData che è l'oggetto principale di una configurazione di macchina virtuale di riferimento. La configurazione di riferimento viene usata per integrare la configurazione della nuova macchina virtuale se i parametri SystemSettings e ResourceSettings non hanno fornito le rispettive informazioni.
-
RisultanteSystem [out]
-
Tipo: CIM_ComputerSystem
Riferimento a un'istanza della classe CIM_ComputerSystem che rappresenta la macchina virtuale appena creata.
-
Processo [out]
-
Tipo: CIM_ConcreteJob
Se l'operazione viene eseguita in modo asincrono, questo metodo restituirà 4096 e questo parametro conterrà un riferimento a un oggetto derivato da CIM_ConcreteJob.
Valore restituito
Tipo: uint32
Se questo metodo viene eseguito in modo sincrono, restituisce 0 se ha esito positivo. Se questo metodo viene eseguito in modo asincrono, restituisce 4096 e il parametro output job può essere usato per tenere traccia dello stato di avanzamento dell'operazione asincrona. Qualsiasi altro valore restituito indica un errore.
-
Completato senza errore (0)
-
Non supportato (1)
-
Errore (2)
-
Timeout (3)
-
Parametro non valido (4)
-
DMTF Riservato (..)
-
Parametri del metodo controllati - Processo avviato (4096)
-
Metodo riservato (4097..32767)
-
Fornitore specifico (32768..65535)
Commenti
L'accesso alla classe Msvm_VirtualSystemManagementService potrebbe essere limitato dal filtro dell'interfaccia utente. Per altre informazioni, vedere Controllo account utente e WMI.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 8 [solo app desktop] |
| Server minimo supportato |
Windows Server 2012 [solo app desktop] |
| Spazio dei nomi |
Root\Virtualization\V2 |
| MOF |
|
| DLL |
|