vSphere SDK for Perl Programming Guide - Documentation - VMware

vSphere SDK for Perl Programming Guide
You can use the code in the \apps\session\save_session.pl utility application inside your own vSphere
SDK for Perl application. If a call to the server throws an exception, your application should terminate the
session to avoid session leaks. You could do this with an error handler that runs disconnect() or logout(),
for example:
eval {
# ... insert program here ...
};
if (@$) {
print "Fatal error: $@";
Util::disconnect();
exit(1);
}
You can also use the _END_ pseudo‐signal handler to perform a disconnect, as follows:
$SIG{__END__} = sub { Util::disconnect(); }
Passing Parameters at the Command Line
Pass parameters at the command line using option name and option value pairs (some options have no value).
--
The following example connects to the server as user snow-white with password dwarf$. The first example
(Linux) uses an escape character before each special character, the other examples use single quotes (Linux)
and double quotes (Windows).
Linux
vminfo.pl --server --username snow\-white --password dwarf\$ --vmname
vminfo.pl --server --username ‘snow-white’ --password ‘dwarf$’ --vmname
Windows
vminfo.pl --server --username “snow-white” --password “dwarf$” --vmname
Setting Environment Variables
You can set environment variables in a Linux profile, in the Environment properties dialog box of the
Microsoft Windows System control panel, or, for the current session, at the command line. Environment
variables are listed when you run a command with --help.
The following example shows the contents of a /root/.visdkrc file that uses environment variables:
VI_SERVER =
VI_USERNAME =
VI_PASSWORD =
VI_PROTOCOL = https
VI_PORTNUMBER = 443
Do not escape special characters in the file that specifies environment variables.
If you have set up your system to run this file, you can run scripts on the specified server afterwards.
Using a Configuration File
A configuration file is a text file that contains variable names and settings. Variables corresponding to the
connection options are shown in Table 1‐3. Use --config if the configuration information is saved in a
different file than ./visdkrc. If you specify --config, the system ignores the ./visdkrc settings.
CAUTION Limit read access to a configuration file, especially if it contains user credentials.
You can use the --config option to run a script with the configuration file, for example:
connect.pl --config --list
14 VMware, Inc.