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]  [-cte]  [-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] [-cte] [-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] [-cte] [-dx] [-dr] objectPath [prop[,...]]
36
37       wbemein    [-nl] [-h] [-t] [-dx] [-dr] objectPath
38
39       wbemai       [-nl]   [-h]  [-t]  [-cte]  [-dx]  [-dr]  [-ac assocClass]
40       [-arc resultClass] [-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]  [-cte]  [-dx]  [-dr]  [-arc resultClass]
46       [-ar role] 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 objectPath should be enclosed  in  single  quotes  so  that  double
74       quoted
75              strings  are  perserved  by the command line shell. Refer to the
76              examples section.
77
78       The only scheme supported is http. Example:
79                   http://krz:xyz@localhost:5988/root/cimv2:rpm_pack‐
80              age.name=glibc
81
82       The  prop=value[,...]  parameter  is used to specify <Property>=<Value>
83       pairs for the ci, mi and sp operations.   Only  one  <Property>=<Value>
84       pair must be specified for the sp operation.
85
86       Example:
87              stringProp="a string",booleanProp=true,numericProp=25
88
89       Arrays of property values are supported by specifying additional values
90              separated by commas
91
92       Example:
93              stringProp="a string","another string",numericProp=25,49,12
94
95       The  prop[,...] parameter specifies the properties to be returned.  One
96       prop must be specified for the gp operation. For other operations  this
97       parameter  is  optional,  if  none are specified all properties will be
98       returned.
99
100       Example:
101              stringProp,booleanProp,numericProp
102
103       The method[.param=value[,...] parameter is  used  to  specify  <Parame‐
104       ter>=<Value> pairs for the cm operation.
105
106       Example:
107              Method2Execute.stringParam="a string",booleanParam=true,numeric‐
108              Param=25
109
110       Arrays of property values are supported by specifying additional values
111              separated by commas
112
113       Example:
114              Method2Execute.stringParam="a string","another  string",numeric‐
115              Param=25,49,12
116

OPERATIONS:

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

OPTIONS

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

LIBRARIES

198       wbemcli  requires  either  libghttp,  libwww,  or winhttp, depending on
199       build options used.
200

Example

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

Host indirection support

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

ENVIRONMENT

242       WBEMCLI_CURL_SSLVERSION
243              Specifies the SSL protocol that will be used.  Valid values  are
244              SSLv2, SSLv3, TLSv1, TLSv1.0, TLSv1.1 or TLSv1.2.  If this vari‐
245              able is not set, wbemcli will attempt to figure out  the  remote
246              SSL protocol version.
247

FILES

249       /etc/pki/Pegasus/client.pem
250              The default CA certificate file. Can be overriden with -cacert.
251

EXIT CODES

253       0      Normal termination.
254
255       16     Abnormal  termination,  see  diagnostics printed to the standard
256              error.
257

AUTHOR

259       Adrian Schuur <schuur@de.ibm.com>
260

BUGS

262       The SBLIM project maintains a mailing list to which you  should  direct
263       all  questions  regarding  sfcb,  sfcc,  wbemcli,  or  any of the SBLIM
264       providers.  To subscribe to this mailing list visit
265
266              http://lists.sourceforge.net/lists/listinfo/sblim-issues
267
268       The SBLIM Project Bug tracking page can be found at
269
270              http://sourceforge.net/tracker/?group_id=128809&atid=712784
271

COPYRIGHT

273       (C) Copyright IBM Corp. 2002, 2004, 2005, 2009
274

AVAILABILITY

276       wbemcli is a part of the SBLIM project.  The  most  recent  version  is
277       available on the web at
278
279              http://sblim.sourceforge.net/
280