CheckVirtualSystemIsMigratableToHost-Methode der CIM_VirtualSystemMigrationService-Klasse
Methode zum Durchführen einer Vorabüberprüfung, um zu bestimmen, ob ein virtuelles System wahrscheinlich erfolgreich zu einem Zielhost migriert wird, der durch einen Netzwerknamen oder eine IP-Adresse angegeben wird. Diese Methode garantiert aufgrund der dynamischen Ressourcenverfügbarkeit nicht, dass eine nachfolgende Migration immer erfolgreich ist.
Rückgabecodebeschreibung:
Hinweis: Diese Methode ist nur als Übergangslösung gedacht, bis die Modellierung der Clusterunterstützung verfügbar ist.
Syntax
uint32 CheckVirtualSystemIsMigratableToHost(
[in] CIM_ComputerSystem REF ComputerSystem,
[in] string DestinationHost,
[in] string MigrationSettingData,
[in] string NewSystemSettingData,
[in] string NewResourceSettingData[],
[out] boolean IsMigratable
);
Parameter
-
ComputerSystem [in]
-
Ein CIM_ComputerSystem Verweis auf das 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.
-
IsMigratable [out]
-
Das Ergebnis der Migrationsprüfung, das angibt, ob das virtuelle System erfolgreich migriert werden kann.
Rückgabewert
Gibt bei Erfolg eine 0 zurück; Gibt andernfalls einen Fehler zurück.
| Rückgabecode/-wert | Beschreibung |
|---|---|
|
Überprüfung durchgeführt; Ergebnis, das über den Wert des [Out] IsMigratable-Parameters gemeldet wird. |
|
Die Methode wird von der Implementierung nicht unterstützt. Über den Wert des [Out] IsMigratable-Parameters wird kein Ergebnis gemeldet. |
|
Fehler bei der Überprüfung aus nicht angegebenen Gründen. Über den Wert des [Out] IsMigratable-Parameters wird kein Ergebnis gemeldet. |
|
Timeout für Check. Über den Wert des [Out] IsMigratable-Parameters wird kein Ergebnis gemeldet. |
|
Mindestens ein Parameter ist formal ungültig. Beispielsweise könnte der Wert des DestinationHost-Parameters in einem nicht unterstützten Format angegeben worden sein. Über den Wert des [Out] IsMigratable-Parameters wird kein Ergebnis gemeldet. |
|
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. Über den Wert des [Out] IsMigratable-Parameters wird kein Ergebnis gemeldet. |
|
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. Über den Wert des [Out] IsMigratable-Parameters wird kein Ergebnis gemeldet. |
|
|
|
|
|
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 8.1 |
| Unterstützte Mindestversion (Server) |
Windows Server 2012 R2 |
| Namespace |
Root\virtualization\v2 |
| MOF |
|
| DLL |
|