MigrateVirtualSystemToHost-Methode der CIM_VirtualSystemMigrationService-Klasse

Artikel
06/13/2023

Methode zum Verschieben, Migrieren oder Verschieben eines virtuellen Systems auf einen Zielhost, der durch einen Netzwerknamen oder eine IP-Adresse angegeben wird.

Hinweis

Diese Methode ist nur als Übergangslösung gedacht, bis die Modellierung der Clusterunterstützung verfügbar ist.

Syntax

uint32 MigrateVirtualSystemToHost(
  [in]  CIM_ComputerSystem REF ComputerSystem,
  [in]  string                 DestinationHost,
  [in]  string                 MigrationSettingData,
  [in]  string                 NewSystemSettingData,
  [in]  string                 NewResourceSettingData[],
  [out] CIM_ConcreteJob    REF Job
);

Parameter

ComputerSystem [in]

Zu migrierende virtuelle Quellcomputersystem.

DestinationHost [in]

Zielhostsystem für die Migration.

Zulässige Formate für diesen Parameter werden über Werte von Elementen der Arrayeigenschaft DestinationHostFormatsSupported[ ] im instance der CIM_VirtualSystemMigrationCapabilities übermittelt, die über die CIM_ElementCapabilities Zuordnung zugeordnet ist.

MigrationSettingData [in]

Zeichenfolge, die eine eingebettete instance der CIM_VirtualSystemMigrationSettingData-Klasse enthält, die migrationseinstellungen darstellt, die für den Migrationsvorgang gelten.

NewSystemSettingData [in]

Zeichenfolge, die eine eingebettete instance der CIM_VirtualSystemSettingData Klasse enthält, die neue Eigenschaften darstellt, die nach der Migration auf das virtuelle System anwendbar sind.

NewResourceSettingData [in]

Array von Zeichenfolgen, die jeweils eine eingebettete instance der CIM_ResourceAllocationSettingData-Klasse enthalten, die neue Eigenschaften darstellen, die nach der Migration für virtuelle Ressourcen im Bereich des virtuellen Systems gelten.

Auftrag [out]

Wenn der Vorgang lang ausgeführt wird, kann optional eine CIM_ConcreteJob zurückgegeben werden, die den Auftrag darstellt.

Rückgabewert

Gibt bei Erfolg eine 0 zurück; Gibt andernfalls einen Fehler zurück.

Rückgabecode/-wert	BESCHREIBUNG
Abgeschlossen ohne Fehler 0	Das virtuelle System wurde migriert.
Nicht unterstützt 1	Die Methode wird von der Implementierung nicht unterstützt.
Fehler 2	Fehler bei der Migration des virtuellen Systems aus nicht angegebenen Gründen.
Timeout 3	Timeout für die Migration virtueller Systeme; Der Zustand des virtuellen Systems ist unbekannt.
Ungültiger Parameter 4	Mindestens ein Parameter ist formal ungültig. Beispielsweise könnte der Wert des DestinationHost-Parameters in einem nicht unterstützten Format angegeben worden sein.
Ungültiger Zustand 5	Das virtuelle Quellsystem, das Quellhostsystem oder das Zielhostsystem befinden sich in einem Zustand, der die Initiierung der angeforderten Migration des virtuellen Systems zulässt. Dies kann eine vorübergehende Bedingung sein.
Inkompatible Parameter 6	Mindestens ein Eingabeparameter ist als Satz oder in Bezug auf den Zielhost nicht kompatibel. Beispielsweise enthält der Wert des Parameters MigrationNewSettingData Eigenschaften, die vom Zielhostsystem nicht unterstützt werden, das durch den Wert des DestinationHost-Parameters identifiziert wird.
DMTF Reserviert ..
Methodenparameter überprüft – Auftrag gestartet 4096
Reservierte Methode 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	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Siehe auch

CIM_VirtualSystemMigrationService

Freigeben über