vSphere SDK for Perl Programming Guide - Documentation - VMware

Appendix A Web Services for Management Perl Library
#Construct the client.
$client = WSMan::WSBasic->new(
path => 'wsman',
username => 'wsman',
password => 'secret',
port => '8889',
address => 'http://something.somewhere.com'
);
#Execute the Enumerate method.
$result = $client->Enumerate(class_name => 'CIM_Processor',
#namespace => 'root/cimv2'
);
if($result->fault){
#If a fault occurred, then print the faultstring
die $result->faultstring;
}
else{
#If no fault occurred then get the enumid.
$enumid = $result->result;
}
$result = $client->PullRelease(
class_name => 'CIM_Processor',
enumid => $enumid,
action => 'Pull',
#namespace => 'root/cimv2'
);
if($result->fault){
#If a fault occurred, then print the faultstring
die $result->faultstring;
}
else{
# Do stuff with $result, which is a SOAP::SOM object containing a deserialized XML reply.
# It is better to use the Generic Operations module, built on top of this module.
}
Generic CIM Operations with WSMan::GenericOps
The GenericOps module implements some of the generic operations specified in the WS‐Management CIM
bindings published by the DMTF. Not all generic operations are implemented. The Perl module is located at
Perl/lib/WSMan/GenericOps.pm.
The WSBasic module discussed in “SOAP Message Construction with WSMan::WSBasic” on page 53 provides
more primitive intrinsic WS‐Management operations. The GenericOps module requires the WSMan::WSBasic
module.
Table A‐4 lists the methods the GenericOps class provides, which are discussed in more detail below.
Table A-4. Methods in WSMan::GenericOps
Method Description
WSMan::GenericOps‐>new Constructor.
register_xml_ns Registers extra XML namespaces that might be required for proprietary tags in the
SOAP message.
register_class_ns Registers extra CIM namespaces that the WS‐Management server might require.
Identify Performs the wsmid:Identify operation, which causes the WS‐Management server
to identify itself.
EnumerateInstances Enumerates the instances of a given class.
EnumerateInstanceNames Enumerates only the key values of the instances of a given class.
EnumerateAssociatedInstances Returns the instances related to the source object through an association.
EnumerateAssociatedInstanceNames Returns objects with only the key values of the associated instance populated.
EnumerateAssociationInstances Returns objects containing association instances of which the class is a part.
VMware, Inc. 57