DefineSystem-Methode der Msvm_VirtualSystemManagementService-Klasse

Erstellt einen neuen virtuellen Computer instance. Nicht angegebene Eigenschaften werden mit Standardwerten aufgefüllt.

Syntax

uint32 DefineSystem(
  [in]  string                           SystemSettings,
  [in]  string                           ResourceSettings[],
  [in]  CIM_VirtualSystemSettingData REF ReferenceConfiguration,
  [out] CIM_ComputerSystem           REF ResultingSystem,
  [out] CIM_ConcreteJob              REF Job
);

Parameter

SystemSettings [in]

Typ: Zeichenfolge

Eine eingebettete instance der Msvm_VirtualSystemSettingData-Klasse, die zum Definieren der Attribute des zu erstellenden virtuellen Computers verwendet wird. Dieser Parameter ist erforderlich.

ResourceSettings [in]

Typ: string[]

Eine Reihe eingebetteter Instanzen der Msvm_ResourceAllocationSettingData -Klasse (oder deren abgeleitete Klassen). Zusammen beschreiben diese Instanzen die virtuellen Ressourcen des virtuellen Computers. Ein Standardsatz von Geräten wird für den virtuellen Computer erstellt, unabhängig davon, ob dieser Parameter festgelegt ist. Beispielsweise werden Prozessor und Arbeitsspeicher automatisch erstellt und mit Standardwerten konfiguriert.

ReferenceConfiguration [in]

Typ: CIM_VirtualSystemSettingData

Ein Verweis auf einen instance der Msvm_VirtualSystemSettingData-Klasse, die das Objekt der obersten Ebene einer Vm-Referenzkonfiguration ist. Die Referenzkonfiguration wird verwendet, um die Konfiguration des neuen virtuellen Computers zu ergänzen, wenn die Parameter SystemSettings und ResourceSettings keine entsprechenden Informationen bereitgestellt haben.

ResultSystem [out]

Typ: CIM_ComputerSystem

Ein Verweis auf einen instance der CIM_ComputerSystem-Klasse, die den neu erstellten virtuellen Computer darstellt.

Auftrag [out]

Typ: CIM_ConcreteJob

Wenn der Vorgang asynchron ausgeführt wird, gibt diese Methode 4096 zurück, und dieser Parameter enthält einen Verweis auf ein von CIM_ConcreteJob abgeleitetes Objekt.

Rückgabewert

Typ: uint32

Wenn diese Methode synchron ausgeführt wird, gibt sie 0 zurück, wenn sie erfolgreich ist. Wenn diese Methode asynchron ausgeführt wird, gibt sie 4096 zurück, und der Job-Ausgabeparameter kann verwendet werden, um den Fortschritt des asynchronen Vorgangs nachzuverfolgen. Jeder andere Rückgabewert gibt einen Fehler an.

Ohne Fehler abgeschlossen (0)

Nicht unterstützt (1)

Fehler (2)

Timeout (3)

Ungültiger Parameter (4)

DMTF Reserviert (..)

Methodenparameter überprüft – Auftrag gestartet (4096)

Methode Reserviert (4097..32767)

Herstellerspezifisch (32768..65535)

Bemerkungen

Der Zugriff auf die Msvm_VirtualSystemManagementService-Klasse kann durch die UAC-Filterung eingeschränkt werden. Weitere Informationen finden Sie unter Benutzerkontensteuerung und WMI.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Namespace	Stamm\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Siehe auch

Msvm_VirtualSystemManagementService