Metodo DefineSystem della classe Msvm_VirtualSystemManagementService

Articolo
06/13/2023

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	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Vedi anche

Msvm_VirtualSystemManagementService

Share via