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 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       -v     Show version information
167
168       -dx    Show XML messages payload as received from CIMOM
169
170       -dr    Delineate references with { } pairs
171
172       -noverify
173              Do not verify the server certificate for https URLs (useful  for
174              testing)
175
176       -cacert
177              CA certificate file (required for https URLS unless -noverify is
178              specified)
179
180       -clientcert
181              Client certificate file (if the CIM server requires client  cer‐
182              tificates)
183
184       -clientkey
185              Client private key file (required if -clientcert is specified)
186
187       -ac    association class name (ai, ain only)
188
189       -arc   result class name (ai, ain, rin, ri only)
190
191       -ar    role name (ai, ain, rin, ri only)
192
193       -arr   result role name (ai, ain only)
194

LIBRARIES

196       wbemcli  requires  either  libghttp,  libwww,  or winhttp, depending on
197       build options used.
198

Example

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

Host indirection support

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

FILES

240       /etc/Pegasus/client.pem
241              The default CA certificate file. Can be overriden with -cacert.
242

AUTHOR

244       Adrian Schuur <schuur@de.ibm.com>
245

BUGS

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

COPYRIGHT

258       (C) Copyright IBM Corp. 2002, 2004, 2005
259

AVAILABILITY

261       wbemcli is a part of the SBLIM project.  The  most  recent  version  is
262       available on the web at
263
264              http://sblim.sourceforge.net/
265