MigrateVirtualSystemToSystem method of the Msvm_VirtualSystemMigrationService class

Moves, migrates, or relocates a virtual system to a target system.

Syntax

uint32 MigrateVirtualSystemToSystem(
  [in]  CIM_ComputerSystem REF ComputerSystem,
  [in]  CIM_System         REF DestinationSystem,
  [in]  string                 MigrationSettingData,
  [in]  string                 NewSystemSettingData,
  [in]  string                 NewResourceSettingData[],
  [out] CIM_ComputerSystem REF NewComputerSystem,
  [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 be migrated.

DestinationSystem [in]

A reference to an instance of the Msvm_ComputerSystem class that represents the system to be migrated to.

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.

NewComputerSystem [out]

A reference to an instance of the Msvm_ComputerSystem class that represents the new migrated system.

Job [out]

If the operation is performed asynchronously, this method will return 4096, and this parameter will contain a reference to an object derived from CIM_ConcreteJob.

Return value

This method returns one of the following values.

Completed with No Error (0)

Not Supported (1)

Failed (2)

Timeout (3)

Invalid Parameter (4)

Invalid State (5)

Incompatible Parameters (6)

DMTF Reserved (..)

Method Parameters Checked - Job Started (4096)

Method Reserved (4097..32767)

Vendor Specific (32768..65535 )

Requirements

Requirement Value
Minimum supported client
Windows 8 [desktop apps only]
Minimum supported server
Windows Server 2012 [desktop apps only]
Namespace
Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

See also

Msvm_VirtualSystemMigrationService