NAME

vmmigrate.pl - Migrates one or more virtual machines within the current host or from the current host to another host.


SYNOPSIS

 vmmigrate.pl [options]


DESCRIPTION

This VI Perl command-line utility provides an interface to migrate one or more virtual machines within the current host or from the current host to another host.


OPTIONS

GENERAL OPTIONS

vmname

Required. Name of the virtual machine.

targethost

Required. Host name containing virtual machines to be evacuated.

sourcehost

Required. Host name to transfer virtual machines to.

targetdatastore

Required. Datastore of target host to transfer virtual machines to.

targetpool

Required. Resource pool to associate with the virtual machine.

priority

Optional. The priority of the migration task: default, high, low. Default is 'defaultPriority'.

state

Optional. State of the virtual machine: poweredOn, poweredOff, suspended. If specified, the virtual machine migrates only if its state matches the specified state.


EXAMPLES

Migrate a virtual machine named VM1 from host 'ABC' to host 'XYZ'

 vmmigrate.pl --url https://<host>:<port>/sdk/vimService
                --username myuser --password mypassword
                --sourcehost ABC --targethost XYZ --targetdatastore storage1
                --targetpool Pool9 --vmname VM1

Migrate a virtual machine named VM1 within the current host to pool 'Pool123' and let the migration priority be 'low'.

 vmmigrate.pl --url https://<host>:<port>/sdk/vimService
              --username myuser --password mypassword
              --sourcehost ABC --targethost XYZ --targetdatastore storage1
              --targetpool Pool9 --piority lowPriority --vmname VM1


SUPPORTED PLATFORMS

All operations work with VMware VirtualCenter 2.0.1

No operation work when VMware ESX Server 3.0.1 directly accessed.