DefineSystem-Methode der CIM_VirtualSystemManagementService-Klasse
Definiert ein virtuelles System.
Eingaben, die nicht vollständig angegeben sind, können mit Standardwerten ausgefüllt werden.
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]
-
Zeichenfolge, die eine eingebettete instance der Klasse CIM_VirtualSystemSettingData enthält, die zum Definieren von Attributen des zu erstellenden virtuellen Systems verwendet wird.
-
ResourceSettings [in]
-
Array von Zeichenfolgen, die jeweils eine eingebettete instance der Klasse CIM_ResourceAllocationSettingData enthalten, die die virtuellen Aspekte einer virtuellen Ressource beschreibt, die im Bereich des neuen virtuellen Systems erstellt werden soll.
-
ReferenceConfiguration [in]
-
Verweis auf ein CIM_VirtualSystemSettingDat-Objekt instance, das das Objekt der obersten Ebene einer Referenzkonfiguration des virtuellen Systems ist. Die Referenzkonfiguration wird verwendet, um die Konfiguration des neuen virtuellen Systems zu ergänzen, wenn die Parameter SystemSettings und ResourceSettings keine entsprechenden Informationen bereitgestellt haben.
-
ResultSystem [out]
-
Wenn ein virtuelles Computersystem erfolgreich definiert wurde, wird ein Verweis auf eine instance der Klasse CIM_ComputerSystem zurückgegeben, die das neu definierte virtuelle Computersystem darstellt.
-
Auftrag [out]
-
Wenn der Vorgang lang ausgeführt wird, kann optional ein Auftrag zurückgegeben werden. In diesem Fall wird die instance der Klasse CIM_ComputerSystem, die das neue virtuelle System darstellt, über die Zuordnung CIM_AffectedJobElement mit der Eigenschaft AffectedElement angezeigt, die auf die neue instance der Klasse CIM_ComputerSystem und der Eigenschaft ElementEffects verweist, die auf 5 (Erstellen) festgelegt ist.
Rückgabewert
Gibt bei Erfolg eine 0 zurück. Gibt andernfalls einen Fehler zurück.
-
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)
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows 8.1 |
Unterstützte Mindestversion (Server) |
Windows Server 2012 R2 |
Namespace |
Root\virtualization\v2 |
MOF |
|
DLL |
|