6.5
Table Of Contents
- vSphere SDK for Perl Programming Guide
- Contents
- Getting Started with vSphere SDK for Perl
- Writing vSphere SDK for Perl Scripts
- Refining vSphere SDK for Perl Scripts
- Creating and Using Filters
- Filtering Views Selectively Using Properties
- Retrieving the ServiceInstance Object on a vSphere Host
- Saving and Using Sessions
- Using Multiple Sessions
- Learning About Object Structure Using Data::Dumper
- Specifying Untyped Arguments in Scheduled Tasks and Callbacks
- Using Advanced Subroutines
- vSphere SDK for Perl Subroutine Reference
- Web Services for Management Perl Library
- Credential Store Perl Library
VMware, Inc. 33
3
ThischapterdiscussessomeprogrammingtechniquesforyourvSphereSDKforPerlscripts.
Thechapterincludesthesetopics:
“CreatingandUsingFilters”onpage 33
“FilteringViewsSelectivelyUsingProperties”onpage 34
“RetrievingtheServiceInstanceObjectonavSphereHost”onpage 36
“SavingandUsingSessions”onpage 36
“UsingMultipleSessions”onpage 37
“LearningAboutObjectStructureUsingData::Dumper”onpage 38
“SpecifyingUntypedArgumentsinScheduledTasksandCallbacks”onpage 39
“UsingAdvancedSubroutines”onpage 40
Creating and Using Filters
YoucanusethevSphereSDKforPerltodefineandusefiltersthatselectobjectsbasedonpropertyvalues.
Filterscanreducealargeresultsettoonlythoseobjectswithcharacteristicsofinteresttoyou.
Using Filters with Vim::find_entity_view() or Vim::find_entity_views()
YoucancallVim::find_entity_view()orVim::find_entity_views()toretrieveobjectsfromthe
ESX/ESXihost.Vim::find_entity_view()returnsthefirstobjectitfindsthatmatchesthesearchcriteria.
Vim::find_entity_views()returnsallobjects.
WhenyoucallVim::find_entity_view()thefirstobjectfoundmightnotbetheoneyouarelookingfor.For
example,youmightwant
toretrieveonlythosevirtualmachineobjectswhosenamesbeginwithacertain
prefix.WhenyoucallVim::find_entity_views(),thecommandmightreturnmoreobjectsthanyouwant
toworkwith,forexampleallvirtualmachinesinadatacenter.Youcanapplyoneormorefiltersto
Vim::find_entity_view()andVim::find_entity_views()to
selectasubsetofobjectsbasedonproperty
values.
ToapplyafiltertotheresultsofVim::find_entity_view()orVim::find_entity_views(),yousupplyan
optionalfilterparameter.Thevalueoftheparameterisananonymoushashreferencecontainingoneor
morepairsoffiltercriteria.Eachofthecriteriaisa
propertypathandamatchvalue.Thematchvaluecanbe
eitherastringoraregularexpressionobject.Ifthematchvalueisastring,thevalueofthepropertymustmatch
thestringexactly(includingcase).TomatchBooleanvalues,usethestringstrueandfalse.
Thefollowing
filterparametermatchesavirtualmachinepowerstateofpoweredOff:
filter => { 'runtime.powerState' => 'poweredOff' }
Refining vSphere SDK for Perl Scripts
3