NAME

guest.pl - Lists attributes of guest and customizing some of these.


SYNOPSIS

 guest.pl --url <web service URL> --username <server login name>
         --password <server login password> --vmname <virtual machine name>
         --operation <display|customize> --filename <customization xml file>
         --schema <xsd schema file name>


DESCRIPTION

This VI Perl command-line utility provides an interface for displaying the attributes of guest and customizing some of these attributes.


OPTIONS

GENERAL OPTIONS

operation

Required. Operation to be performed. Must be one of the following: display (displays the attributes of guest) customize (reads the customization specification from an xml file and customizes those attributes).

vmname

Required. The name of the virtual machine. It will be used to select the virtual machine of which the guest properties will be displayed or customized.

DISPLAY OPTIONS

operation

Required. Operation to be performed. display (displays the attributes of guest)

vmname

Required. The name of the virtual machine. It will be used to select the virtual machine of which the guest properties will be displayed.

CUSTOMIZE OPTIONS

operation

Required. Operation to be performed. customize (reads the customization specification from an xml file and customizes those attributes)

vmname

Required. The name of the virtual machine. It will be used to select the virtual machine of which the guest properties will be customized.

filename

Required. The name of the customization specification xml file. This file specifies the properties to be modified and the new values to be set.

schema

Required. The name of the xsd file for validating.


EXAMPLES

Displays the attributes of guest under virtual machine specified:

   guest.pl --url https://192.168.111.52:443/sdk/webService
            --username administrator --password mypassword
            --vmname VirtualABC --operation display

Customize the attributes of guest, customizing the attributes as specified in the xml specification file.

   guest.pl --url https://192.168.111.52:443/sdk/webService
            --username administrator --password mypassword
            --vmname VirtualABC --operation customize
            --filename specification.xml
            --schema schema.xsd

Sample specification xml file

   <?xml version="1.0"?>
      <specification>
         <customizationspec>
            <autologon>1</autologon>
            <computername>VM9</computername>
            <timezone>033</timezone>
            <domain>InterraIT.info</domain>
            <domain_user_name>DildipK</domain_user_name>
            <domain_user_password>discussion8</domain_user_password>
            <fullname>admin</fullname>
            <orgname>InterraIT</orgname>
         </customizationspec>
      </specification>


SUPPORTED PLATFORMS

All operations work with VMware VirtualCenter 2.0.1.

Display operation works with VMware ESX server 3.0.1 or later. Customize operation is not supported.