vSphere SDK for Perl Programming Guide - Documentation - VMware

vSphere SDK for Perl Programming Guide
Table A-4. Methods in WSMan::GenericOps (Continued)
Method Description
EnumerateAssociationInstanceNames Returns objects containing key values of the association instances of which the class is
a part.
GetInstance Retrieves a particular instance of a class.
WSMan::GenericOps->new
Constructor that takes a hash argument containing key‐value pairs in the following form:
$client = WSMan::GenericOps->new(( address => 'http://www.abc.com/',
port => '80',
path => 'wsman',
username => 'wsman',
password => 'secret',
namespace => 'root/cimv2', #optional
timeout => ‘60’ #optional
));
Arguments
The constructor has the following arguments:
Argument Description
address URL of the WS‐Management server. Specify the transport protocol by adding the http prefix for
HTTP (basic user‐password authentication) or the https prefix for HTTP with SSL encryption.
port Port on which WS‐Management listens for requests.
path Path to the WS‐Management server. The path is combined with the address and port arguments to
form the complete URL of the WS‐Management server in http://address:port/path order.
username User name for the WS‐Management server.
password Password for the WS‐Management server.
namespace Default CIM namespace. Default is root/cimv2.
If the namespace is not root/cimv2, you must pass in the namespace of the class in this argument.
timeout
(optional)
register_xml_ns
Registers extra XML namespaces that might be required for proprietary tags in the SOAP message. Calling
register_xml_ns is not required unless you are trying to extend the class itself.
Arguments
A hash. Keys are the prefixes, values are the relative URLs as values.
Example
$client->register_xml_ns((wsen => 'http://www.dmtf.org/wsen'));
Declares a prefix wsen with the URL http://www.dmtf.org/wsen in the global XML namespace.
register_class_ns
Timeout for the HTTP request, in case of slow servers.
Registers extra ResourceURIs that the WS‐Management server might require. By default, the constructor
provides a set of ResourceURIs only for classes in the CIM schema. Classes with other schema names, such as
VMware_* classes, require a different ResourceURI when enumerated using the vSphere SDK for Perl.
You can find the ResourceURIs corresponding to other supported schemas in the OpenWSMan configuration
file, which is located in the serverʹs file system at /etc/openwsman/openwsman.conf. The ResourceURIs are
listed in the value of the vendor_namespaces configuration parameter.
58 VMware, Inc.