NAME

vmregister.pl - registers/unregisters virtual machine


SYNOPSIS

vmregister.pl --url <web service URL> --username <server login name> --password <server login password> --operation <register/unregister> --vmname <virtual machine name> [--hostname <name of the host>] [--vmxpath <Path of the vmx location>] [--respool <resource pool>] [--datacenter <datacenter name>]


DESCRIPTION

This VI Perl command-line utility allows users to register a VM to a specified host and resource pool. Operations are register and unregister.


OPTIONS

GENERAL OPTIONS

operation

Required. Operation to be performed. Must be one of the following: register (register a virtual machine to a specified host and resource pool) unregister (unregister an already registered virtual machine).

vmname

Required.For register, name of the virtual machine to register and unregister operation, the name of the virtual machine to unregister.

REGISTER OPTIONS

operation

Required. register (register a virtual machine to a specified host and resource pool)

vmname

Required.For register, name of the virtual machine to register.

respool

Required. Resource Pool to add virtual machine to.

datacenter

Required. Name of the Data Center.

hostname

Required. ESX host name to register the virtual machine.

vmxpath

Required. Path of the vmx location.

UNREGISTER OPTIONS

operation

Required. unregister (unregister an already registered virtual machine).

vmname

Required.For unregister operation, the name of the virtual machine to unregister.


EXAMPLES

Registering a virtual machine

   vmregister.pl  --url https://192.168.111.52/sdk/vimService --username administrator
               --password mypassword --operation register --vmname FC5
               --hostname MYESX.InterraIT.info --vmxpath [lazy_100gb]FC/FC.vmx
               --respool PoolABC --datacenter Datacenter2

Unregistering a virtual machine

   vmregister.pl --url https://192.168.111.52/sdk/vimService --username administrator
              --password mypassword --operation unregister --vmname FC5
              --hostname MYESX.InterraIT.info


SUPPORTED PLATFORMS

All operations work with VMware VirtualCenter 2.0 or later.

All operations work with VMware ESX Server 3.0 or later.