MigrateVirtualSystemToHost method of the Msvm_VirtualSystemMigrationService class

Migrates a virtual system or the storage of a virtual system to a destination host specified by a hostname.

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
);

Parameters

ComputerSystem [in]

A reference to an instance of the Msvm_ComputerSystem class that represents the virtual computer system to migrate.

DestinationHost [in]

The name of the host system for the migration. The format of this name is specified by the DestinationHostFormatsSupported property of the Msvm_VirtualSystemMigrationCapabilities class associated with this class.

MigrationSettingData [in]

An embedded instance of the Msvm_VirtualSystemMigrationSettingData class that represents settings for the migration operation.

NewSystemSettingData [in]

An embedded instance of the Msvm_VirtualSystemSettingData class that represents new properties applicable to the virtual system after it is migrated.

NewResourceSettingData [in]

An array of strings that contain an embedded instance of the Msvm_ResourceAllocationSettingData class that represents the new properties applicable to virtual resources of the virtual system after it is migrated.

Job [out]

A reference to an optional job for the operation if the operation is run asynchronously.

Return value

This method returns one of the following values.

Method Parameters Checked - Job Started (4096)

Failed (32768)

Access Denied (32769)

Not Supported (32770)

Status is unknown (32771)

Timeout (32772)

Invalid parameter (32773)

System is in used (32774)

Invalid state for this operation (32775)

Incorrect data type (32776)

System is not available (32777)

Out of memory (32778)

Requirements

See also

Msvm_VirtualSystemMigrationService