6.5

Table Of Contents

vSphere SDK for Perl Programming Guide

56 VMware, Inc.

Returns

ReturnsaSOAP::SOMobjectthatcanbeusedtoeithercheckforerrors($result->fault)ortoparsethe

results($result->result).TheSOAPobjectincludesaheaderanddatainXMLformat.

PullRelease

AnoverloadedmethodthatperformsaPulloperationoraReleaseoperation.

Arguments

Acceptsthefollowingarguments:

Get

Retrievesaninstanceofaclass.

Arguments

Acceptsthefollowingnamedarguments:

WSMan::WSBasic Examples

ThissectionshowsafewcodeexamplesforWSMan::WSBasic.

Using Enumeration Modes

TouseoneoftheenumerationmodeslikeEnumerateEPRorEnumerateEPRandObject,calltheEnumerate

operationwithEnumerationModeenabled.Youcanalsospecifytheenumerationmodeintheconstructor.

$result = $client->Enumerate(class_name => 'CIM_Processor',

#namespace => 'root/cimv2', #if needed.

enummode => 'EnumerateEPR'

);

Registering Classes

Toperformoperationsonvendor‐specificclasses,youmustregisterthemfirstwiththeclient.TheactualURL

dependsonyourWS‐Managementsoftware.

$client->register_class_ns(Linux => 'http://www.dmtf.org/linux');

Using Enumerate and Pull Operations

#!/usr/bin/perl -w

use strict;

use WSMan::WSBasic; #Import the module.

my ($enumid, result, $client); #declaring variables.

Argument Description

enumid EnumerationIDthatthePullorReleaseoperationshoulduse.Thisargumentispassedasastring.

action Specifiestheoperationtoperform,PullorRelease.Thisargumentispassedasastring.

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.

Argument Description

class_name Theclasswhoseinstanceyouwanttoretrieve.Thisargumentispassedasastring.

options PasseskeysfortheparticularinstanceonwhichyouwanttoperformaGetoperation.Passedasa

referencetoahashcontainingthekeysinname‐valuepairs.

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.