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 nicht, dass eine nachfolgende Migration aufgrund der dynamischen Ressourcenverfügbarkeit immer erfolgreich ist.

Rückgabecodebeschreibung:

Hinweis: Diese Methode ist nur als Übergangslösung vorgesehen, 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-ComputerSystemverweis auf das zu migrierende virtuelle Quellcomputersystem.

DestinationHost [ In]

Zielhostsystem für die Migration.

Akzeptable Formate für diesen Parameter werden durch Werte von Elementen der DestinationHostFormatsSupported-Arrayeigenschaft in der Instanz der CIM [ ] _ VirtualSystemMigrationCapabilities vermittelt, die durch die _ CIM-ElementCapabilities-Zuordnung zugeordnet ist.

MigrationSettingData [ In]

Eine Zeichenfolge, die eine eingebettete Instanz der CIM _ VirtualSystemMigrationSettingData-Klasse enthält, die migrationseinstellungen darstellt, die für den Migrationsvorgang gelten.

NewSystemSettingData [ In]

Eine Zeichenfolge, die eine eingebettete Instanz 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 Instanz der _ CIM-Klasse ResourceAllocationSettingData enthalten, die neue Eigenschaften darstellt, die nach der Migration auf virtuelle Ressourcen im Bereich des virtuellen Systems anwendbar sind.

IsMigratable [ out]

Das Migrationsüberprüfungsergebnis, das angibt, ob das virtuelle System erfolgreich migriert werden kann.

Rückgabewert

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

Rückgabecode/-wert Beschreibung
Abgeschlossen ohne Fehler
0
Durchgeführte Überprüfung; Ergebnis, das über den Wert des [ Out ] IsMigratable-Parameters gemeldet wird.
Nicht unterstützt
1
Methode, die von der Implementierung nicht unterstützt wird. Über den Wert des Out [ ] IsMigratable-Parameters wird kein Ergebnis gemeldet.
Fehler
2
Fehler bei der Überprüfung aus nicht angegebenen Gründen. Über den Wert des Out [ ] IsMigratable-Parameters wird kein Ergebnis gemeldet.
Timeout
3
Check timed out (Timed beim Überprüfen). Über den Wert des Out [ ] IsMigratable-Parameters wird kein Ergebnis gemeldet.
Ungültiger Parameter
4
Mindestens ein Parameter ist formal ungültig. Beispielsweise hätte der Wert des Parameters DestinationHost in einem nicht unterstützten Format angegeben werden können. Über den Wert des Out [ ] IsMigratable-Parameters wird kein Ergebnis gemeldet.
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 ermöglicht. dies kann eine vorübergehende Bedingung sein. Über den Wert des Out [ ] IsMigratable-Parameters wird kein Ergebnis gemeldet.
Inkompatible Parameter
6
Mindestens ein Eingabeparameter ist als Satz oder in Bezug auf den Zielhost inkompatibel. Der Wert des Parameters MigrationNewSettingData enthält beispielsweise Eigenschaften, die nicht vom Zielhostsystem unterstützt werden, das durch den Wert des DestinationHost-Parameters identifiziert wird. Über den Wert des Out [ ] IsMigratable-Parameters wird kein Ergebnis gemeldet.
DMTF Reserved
..
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
\Stammvirtualisierung \ v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Siehe auch

CIM _ VirtualSystemMigrationService