6.5

vSphere SDK for Perl Programming Guide
14 VMware, Inc.
2Runsave_session.pl.Youmustsupplyconnectionparametersandthenameofasessionfileinwhich
thescriptcansaveanauthenticationcookie.
perl save_session.pl --savesessionfile <location> --server <esxi_host>
Forexample:
perl save_session.pl --savesessionfile C:\Temp\my_session --server my_server
Ifyouspecifyaserverbutnousernameorpassword,thescriptpromptsyou.
3Youcannowrunscriptsinthe\appsor\samplesdirectoryoryourownscriptsandpassinthesession
fileusingthe--sessionfileparameterasfollows:
<command> --sessionfile <sessionfile_location> <command_options>
Forexample:
perl hostinfo.pl --sessionfile C:\Temp\my_session
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).
--<optionname> <optionvalue>
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 <server> --username snow\-white --password dwarf\$ --vmname <name>
vminfo.pl --server <server> --username ‘snow-white’ --password ‘dwarf$’ --vmname <name>
Windows
vminfo.pl --server <server> --username “snow-white” --password “dwarf$” --vmname <name>
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 = <server>
VI_USERNAME = <usr>
VI_PASSWORD = <root_password>
NOTEIfyouuseasessionfile,anyotherconnectionparametersareignored.