wbemcli(1)

1
2wbemcli(1)                  General Commands Manual                 wbemcli(1)
3
4
5

NAME

7       wbemcli - independent command line CIM Client
8

SYNOPSIS

10       wbemcli  gc|gcd|dc|ec|ecn|gi|ci|mi|di|ei|ein|ai|ain|ri|rin|gp|sp|cm|cmx
11       [-nl]   [-h]    [-t]    [-dx]    [-dr]    [-noverify]    [-cacert file]
12       [-clientcert file]   [-clientkey file]  [-ac assocClass]  [-arc result‐
13       Class]  [-ar role]  [-arr resultRole]   objectPath   [prop=value[,...]]
14       [prop[,...]]
15

Alternate formats:

17       wbemgc     [-nl] [-h] [-t] [-dx] [-dr] objectPath [prop[,...]]
18
19       wbemgcd    [-nl] [-h] [-t] [-dx] [-dr] objectPath
20
21       wbemdc     [-nl] [-h] [-t] [-dx] [-dr] objectPath
22
23       wbemec     [-nl] [-h] [-t] [-dx] [-dr] objectPath [prop[,...]]
24
25       wbemecn    [-nl] [-h] [-t] [-dx] [-dr] objectPath
26
27       wbemgi     [-nl] [-h] [-t] [-dx] [-dr] objectPath [prop[,...]]
28
29       wbemci     [-nl] [-h] [-t] [-dx] [-dr] objectPath [prop=value[,...]]
30
31       wbemmi     [-nl] [-h] [-t] [-dx] [-dr] objectPath [prop=value[,...]]
32
33       wbemdi     [-nl] [-h] [-t] [-dx] [-dr] objectPath
34
35       wbemei     [-nl] [-h] [-t] [-dx] [-dr] objectPath [prop[,...]]
36
37       wbemein    [-nl] [-h] [-t] [-dx] [-dr] objectPath
38
39       wbemai      [-nl]  [-h] [-t] [-dx] [-dr] [-ac assocClass] [-arc result‐
40       Class] [-ar role] [-arr resultRole] objectPath [prop[,...]]
41
42       wbemain    [-nl] [-h] [-t] [-dx] [-dr]  [-ac assocClass]  [-arc result‐
43       Class] [-ar role] [-arr resultRole] objectPath
44
45       wbemri      [-nl]  [-h]  [-t] [-dx] [-dr] [-arc resultClass] [-ar role]
46       objectPath [prop[,...]]
47
48       wbemrin    [-nl] [-h] [-t] [-dx]  [-dr]  [-arc resultClass]  [-ar role]
49       objectPath
50
51       wbemgp     [-nl] [-h] [-t] [-dx] [-dr] objectPath prop
52
53       wbemsp     [-nl] [-h] [-t] [-dx] [-dr] objectPath prop=value
54
55       wbemcm         [-nl]     [-h]     [-t]     [-dx]    [-dr]    objectPath
56       method[.param=value[,...]]
57
58       wbemcmx       [-nl]    [-h]     [-t]     [-dx]     [-dr]     objectPath
59       method[.param=value[,...]]
60

DESCRIPTION

62       wbemcli  is  a  command  line  based  CIM  Client.  It  uses one of the
63       gc|gcd|dc|ec|ecn|gi|ci|mi|di|ei|ein|ai|ain|ri|rin|gp|sp|cm|cmx   opera‐
64       tions and the fully qualified path to the CIM Object to get to the host
65       and execute the specified  operation.   This  implementation  is  CIMOM
66       library  independent  and  can  be  used  with all WBEM compliant CIMOM
67       implementations.  The objectPath parameter is used to  locate  the  CIM
68       object and has the following format:
69
70            <scheme>://[user:pwd@]<host>:<port>/<namespace[/..]>:<class‐
71       name>[.<key=value[,..]>]
72
73       The only scheme supported is http. Example:
74                   http://krz:xyz@localhost:5988/root/cimv2:rpm_pack‐
75              age.name=glibc
76
77       The  prop=value[,...]  parameter  is used to specify <Property>=<Value>
78       pairs for the ci, mi and sp operations.   Only  one  <Property>=<Value>
79       pair must be specified for the sp operation.
80
81       Example:
82              stringProp="a string",booleanProp=true,numericProp=25
83
84       Arrays of property values are supported by specifying additional values
85              separated by commas
86
87       Example:
88              stringProp="a string","another string",numericProp=25,49,12
89
90       The  prop[,...] parameter specifies the properties to be returned.  One
91       prop must be specified for the gp operation. For other operations  this
92       parameter  is  optional,  if  none are specified all properties will be
93       returned.
94
95       Example:
96              stringProp,booleanProp,numericProp
97
98       The method[.param=value[,...] parameter is  used  to  specify  <Parame‐
99       ter>=<Value> pairs for the cm operation.
100
101       Example:
102              Method2Execute.stringParam="a string",booleanParam=true,numeric‐
103              Param=25
104
105       Arrays of property values are supported by specifying additional values
106              separated by commas
107
108       Example:
109              Method2Execute.stringParam="a string","another  string",numeric‐
110              Param=25,49,12
111

OPERATIONS:

113       Supported operations are:
114
115       gc     get class
116
117       gcd    get class definition
118
119       dc     delete class
120
121       ec     enumerate classes
122
123       ecn    enumerate class names
124
125       gi     get instance
126
127       ci     create instance
128
129       mi     modify instance
130
131       di     delete instance
132
133       ei     enumerate instances
134
135       ein    enumerate instance names
136
137       ai     enumerate association instances
138
139       ain    enumerate association instance names
140
141       ri     enumerate reference instances
142
143       rin    enumerate reference instance names
144
145       gp     get property
146
147       sp     set property
148
149       cm     call method
150
151       cmx    call method (return XML)
152

OPTIONS

154       -h     Print a help message
155
156       -nl    Start a new line for every property returned
157
158       -t     Append array ([]), reference (&) and key property (#) indicators
159              to property names
160
161       -v     Show version information
162
163       -dx    Show XML messages payload as received from CIMOM
164
165       -dr    Delineate references with { } pairs
166
167       -noverify
168              Do not verify the server certificate for https URLs (useful  for
169              testing)
170
171       -cacert
172              CA certificate file (required for https URLS unless -noverify is
173              specified)
174
175       -clientcert
176              Client certificate file (if the CIM server requires client  cer‐
177              tificates)
178
179       -clientkey
180              Client private key file (required if -clientcert is specified)
181
182       -ac    association class name (ai, ain only)
183
184       -arc   result class name (ai, ain, rin, ri only)
185
186       -ar    role name (ai, ain, rin, ri only)
187
188       -arr   result role name (ai, ain only)
189

LIBRARIES

191       wbemcli  requires  either  libghttp,  libwww,  or winhttp, depending on
192       build options used.
193

Example

195       To get all instances of rpm_packages, i.e. all installed  rpm  packages
196       on the local system, the following command can be used:
197
198        wbemcli ei 'http://localhost:5988/root/cimv2:rpm_package'
199
200       The  get  instance  operation  can be specified to get more information
201       about a certain package:
202
203        wbemcli gi 'http://localhost:5988/root/cimv2:rpm_package.name="glibc"'
204        The  create  instance (ci) operation can be called using the following
205        format example.  Property values can  also  be  specified/add  to  the
206        sytax.
207
208        wbemcli    ci    'http://localhost:5988/root/cimv2:TST_InstanceProper‐
209        ties.CreationClassName="TST_InstanceProperties",Id="Instance      #2"'
210        'CreationClassName="TST_InstanceProperties",Id="Instance     #2",Prop‐
211        erty_string2="This is instance#2",Property_uint8=250'
212
213        More command line examples  can  be  found  from  the  wbemcli/samples
214        directory.
215
216
217

Host indirection support

219       The scheme and host specification in the object path can be replaced by
220       an arbitrary token that will be used to locate the  proper  scheme  and
221       host specification in ./wbemcli.ind or any file specified via the WBEM‐
222       CLI_IND environment variable.  The format of this file is as follows:
223
224            <token>: <scheme>://[user:pwd@]<host>:<port>
225
226       Assuming the following entry in ./wbemcli.ind:
227
228            myCimom: http://localhost:5988
229
230       The example in the previous section can then be specified as:
231
232             wbemcli gi 'myCimom/root/cimv2:rpm_package.name="glibc"'
233

FILES

235       /etc/Pegasus/client.pem
236              The default CA certificate file. Can be overriden with -cacert.
237

AUTHOR

239       Adrian Schuur <schuur@de.ibm.com>
240

BUGS

242       The SBLIM project maintains a mailing list to which you  should  direct
243       all  questions  regarding  sfcb,  sfcc,  wbemcli,  or  any of the SBLIM
244       providers.  To subscribe to this mailing list visit
245
246              http://lists.sourceforge.net/lists/listinfo/sblim-issues
247
248       The SBLIM Project Bug tracking page can be found at
249
250              http://sourceforge.net/tracker/?group_id=128809&atid=712784
251

COPYRIGHT

253       (C) Copyright IBM Corp. 2002, 2004, 2005
254

AVAILABILITY

256       wbemcli is a part of the SBLIM project.  The  most  recent  version  is
257       available on the web at
258
259              http://sblim.sourceforge.net/
260