1 17. +++++ test Help Output
2 Usage: cimcli <command> <CIMObject> <Options> *<extra parameters>
3 -hc for <command> set and <CimObject> for each command
5 -h xx for <command> and <Example> for <xx> operation
9 The options for this command are:
11 This command executes single CIM Operations.
13 -count count. Expected count of objects returned if summary set.
14 Tests this count and displays difference.
15 Return nonzero status code if test fails. Default(29346)
16 -d debug. More detailed debug messages. Default(false)
17 -delay delay. Delay between connection and request. Default(0)
18 -p Password. Defines password for authentication. Default()
19 -l location. Specifies system and port (HostName:port).
20 Port is optional. Default()
21 -s ssl. Specifies to connect over HTTPS. Default(false)
22 --cert clientCert. Specifies a client certificate file path to present to the server.
23 This is optional and only has an effect on connections
24 made over HTTPS using -s. Default()
25 --key clientKey. Specifies a client private key file path.
26 This is optional and only has an effect on connections
27 made over HTTPS using -s. Default()
28 -u User. Defines User Name for authentication. Default()
29 -n namespace. Specifies namespace to use for operation. Default(root/cimv2)
30 -ic includeClassOrigin. If set includeClassOrigin parameter
31 set true on requests that honor this parameter. Default(false)
32 -di deepInheritance. If set deepInheritance parameter
33 set true. Default(false)
34 -lo localOnly. DEPRECATED. This was used to set LocalOnly.
35 However, default should be true and we cannot use True
36 as default. See -nlo. Default(true)
37 -nlo notLocalOnly. When set, sets LocalOnly = false on
38 operations. Default(false)
39 -iq includeQualifiers. DEPRECATED. Sets includeQualifiers = True.
40 Useful for instance operations where default is false. Default(false)
41 -niq notIncludeQualifiers. Sets includeQualifiers = false
42 on operations. Useful for class operations where
43 the default is true.. Default(false)
44 -pl propertyList. Defines a propertyNameList. Format is p1,p2,p3
45 (without spaces). Use "" for empty. Default(###!###)
46 -ac assocClass. Defines a assocation Class string for Associator calls. Default()
47 -ar assocRole. Defines a role string for Associators. AssocRole
49 -r role. Defines a role string for reference role parameter. Default()
50 -rc resultClass. Defines a resultClass string for References and
51 Associatiors. Default()
52 -rr resultRole. Defines a role string for associators operation resultRole
54 -ip inputParameters. This option deprecated and removed. Replaced by use of
55 the same name/value pair syntax as properties in create
56 and modify instance.. Default()
57 -f filter. Defines a filter to use for query. Single String input. Default()
58 -ql queryLanguage. Defines a Query Language to be used with a query filter.
60 -o outputformats. Output in xml, mof, txt, table. Default(mof)
61 -x xmlOutput. Output objects in xml format. Default(false)
62 --version version. Displays software Version. Default(false)
63 -v verbose. Verbose Display. Outputs detailed parameter input
64 display and other request processing information. Default(false)
65 --sum summary. Displays only summary count for enumerations,
66 associators, etc.. Default(false)
67 -h help. Prints help usage message. Default(false)
68 --help full help. Prints full help message with commands, options,
69 examples. Default(false)
70 -ho help options. Prints list of options. Default(false)
71 -hc help commands. Prints CIM Operation command list. Default(false)
72 --timeout connecttimeout. Set the connection timeout in seconds.. Default(0)
73 -i interactive. Interactively ask user to select instances.
74 Used with associator and reference operations. Default(false)
75 --setRtnHostNames setRtnHostNames. Set namespace component of reference and path outputs parameter.
76 Used to allow comparison of paths and instances without involving the variable of host namespaces.. Default()
77 -trace trace. Set Pegasus Common Components Trace. Sets the Trace level.
79 --r repeat. Number of times to repeat the operation.
80 Zero means one time. Default(0)
81 --t time. Measure time for the operation and present results. Default(false)
82 --sort sort. Sort the returned entities for multi-entity responses. Default(false)
84 Options vary by command consistent with CIM Operations
86 ni enumerateInstanceNames Enumerate instancenames of <classname>
87 niall enumallInstanceNames Enumerate all instance names in <namespace>.
88 ei enumerateInstances Enumerate instances of <classname>
89 nc enumerateClassNames Enumerate Class Names of [ <classname> ].
91 ec enumerateClasses Enumerate classes of [ <classname> ].
93 gc getClass Get class of <classname>
94 gi getInstance Get instance of <objectname> | <classname>
97 *<PropertyName=value> for equal property values.
98 ci createInstance Create Instance of <Class> *<name=param> with
100 ti testInstance Test instance of <objectname> *<name=value>
102 *<PropertyName=value>
105 di deleteInstance Delete Instance of <objectname> | <classname>
106 *<keyPropertyName=value> | interactive of <className>
107 cc createClass Not supported
108 mi modifyInstance Modify Instance of <objectname> *<name=value>
111 dc deleteClass Delete Class of <classname>
112 gp getProperty get single property of <object name>
113 sp setProperty set a single property of <object-name>
114 gq getQualifier Get Qualifier of <qualifiername>
115 sq setQualifier Not suported
116 eq enumerateQualifiers Enumerate all Qualifiers
117 dq deleteQualifier Delete qualifer of <qualifiername>
118 a associators Enumerate Associators of <classname> |
120 an associatorNames Enumerate Associator Names of <classname> |
122 r references Enumerate References of <classname> |
124 rn referenceNames Enumerate Reference Names <classname> |
126 im invokeMethod Invoke Method for <object> <method>
128 xq execQuery ExecQuery <query-expresssion>
130 ns enumerateNamespaces Enumerate all namespaces on the server.
131 son Turn On Statistics Turn on CIM Server Statistics Gathering
132 soff Turn Off Statistics Turn off CIM Server Statistics Gathering
133 ? show command options Show List of Commands -h for all help, -hc for commands, -ho for options
136 cimcli ni -n test/TestProvider TST_Person
137 -- Enumerate Instance Names of class TST_Person
139 cimcli niall -n root/cimv2
140 -- Enumerate Instance Names of all classes under
141 the namespace root/cimv2
143 cimcli ei PG_ComputerSystem -- Enumerate Instances of class
145 cimcli nc -- Enumerate class names from root/cimv2.
147 cimcli ec -n root/cimv2
148 -- Enumerate classes from namespace root/cimv2.
150 cimcli gc CIM_door -u guest -p guest
151 -- Get class user = guest and password = guest.
153 cimcli gi -n test/TestProvider TST_Person
154 -- Get Instance of class
156 cimcli ci -n test/TestProvider TST_Person Name=Mike SSN=333
157 -- Create Instance of class TST_Person with properties
158 Name= Mike and SSN= 333
160 cimcli ti -n test/TestProvider TST_Person Name=Mike SSN=333
161 -- Test Instance of class for equality of Name and SSN
162 properties. Returns error code if instance in server
163 does not have same properties and values as the
164 instance built from input
166 cimcli di -n test/TestProvider TST_Person
167 -- Delete Instance of class TST_Person interactively
169 cimcli di -n test/TestProvider TST_Person name=Mike
170 -- Delete Instance of class TEST_Persion with key property
171 name equal Mike using instance builder format to
174 cimcli di -n test/TestProvider TST_Person.name=\"Mike\"
175 -- Delete Instance of class TST_Persion with object path
176 TST_Person.name="Mike" using object path input format
178 Operation Not supported..
180 cimcli mi -n test/TestProvider TST_Person.Id=\"Mike\" SSN=444
181 -- Modifies the Instance if it exists using rules of DMTF
182 modifyInstance operation.
184 cimcli dc -n test/TestProvider TST_Person
185 -- Deletes the Class when there are no instances and
186 sub-classes for this class
188 cimcli gp -n test/TestProvider TST_Person.Id=\"Mike\" SSN
189 -- Get the property named SSN from the instance
190 defined by TST_Person.Id="Mike"
191 cimcli sp -n test/TestProvider TST_Person.Id=\"Mike\" SSN=333
192 -- Set the property named SSS in the instance
193 defined by TST_Person.Id="Mike")
194 cimcli gq Association
195 -- Get the qualifier named Association in mof output
196 in the default namespace (normally root/cimv2)
197 Operation Not supported..
199 cimcli eq -n test/TestProvider
200 -- Enumerate Qualifiers of namespace test/TestProvider
202 cimcli dq -n test/TestProvider ASSOCIATION
203 -- Delete Qualifier named ASSOCIATION in namespace
206 cimcli a TST_Person.name=\"Mike\" -n test/TestProvider -ac TST_Lineage
208 -- get associations for instances of association class
209 TST_Lineage and result class TST_Person
210 associated with instance of TST_person with key
211 "Mike" in namespace test/TestProvider
213 cimcli a TST_Person -n test/TestProvider -ac TST_Lineage
214 -- get associated classes for all instances of classes
215 associated with class TST_person and with
216 association class TST_Lineage
218 cimcli a TST_Person -n test/TestProvider -ac TST_Lineage -i
219 -- get associated instances by selecting interactively for
220 classes associated with class TST_person and with
221 association class TST_Lineage
223 cimcli an TST_Person.name=\"Mike\" -n test/TestProvider -ac TST_Lineage
225 cimcli an TST_Person -n test/TestProvider -ac TST_Lineage
227 cimcli r TST_Person.name=\"Mike\" -n test/TestProvider -rc TST_Lineage
228 -- get references for instances association class TST_Lineage
229 associated with instance of TST_person with key
230 "Mike" in namespace test/TestProvider
232 cimcli r TST_Person.name=\"Mike\" -n test/TestProvider
233 -- get references for all instances of classes
234 associated with instance of TST_person with key
235 "Mike" in namespace test/TestProvider
237 cimcli r TST_Person -n test/TestProvider -rc TST_Lineage
238 -- get reference classes for TST_Lineage association class and
239 subclasses in namespace test/TestProvider
241 cimcli rn TST_Person.name=\"Mike\" -n test/TestProvider -rc TST_Lineage
242 -- get referenceNames for instances association class
243 TST_Lineage associated with instance of TST_person with key
244 "Mike" in namespace test/TestProvider
246 cimcli rn TST_Person.name=\"Mike\" -n test/TestProvider
247 -- get referenceNames for all instances of classes
248 associated with instance of TST_person with key
249 "Mike" in namespace test/TestProvider
251 cimcli rn TST_Person -n test/TestProvider -rc TST_Lineage
252 -- get referenceNames for Class TST_Lineage in namespace
255 cimcli im Sample_MethodProviderClass.Name=\"mooo\" SayHello
256 -n root/SampleProvider -ip p1=fred
258 cimcli xq "select * from CIM_ComputerSystem"
259 -- This command will work when the code is compiled with
262 cimcli ns -- Enumerate all Namespaces in repository
264 cimcli son -- Switch On's the statistical information on CIMServer
266 cimcli soff -- Switch OFF's the statistical information on CIMServer
268 cimcli ? -- Displays help command
271 ni enumerateInstanceNames Enumerate instancenames of <classname>
272 niall enumallInstanceNames Enumerate all instance names in <namespace>.
273 ei enumerateInstances Enumerate instances of <classname>
274 nc enumerateClassNames Enumerate Class Names of [ <classname> ].
276 ec enumerateClasses Enumerate classes of [ <classname> ].
278 gc getClass Get class of <classname>
279 gi getInstance Get instance of <objectname> | <classname>
282 *<PropertyName=value> for equal property values.
283 ci createInstance Create Instance of <Class> *<name=param> with
285 ti testInstance Test instance of <objectname> *<name=value>
287 *<PropertyName=value>
290 di deleteInstance Delete Instance of <objectname> | <classname>
291 *<keyPropertyName=value> | interactive of <className>
292 cc createClass Not supported
293 mi modifyInstance Modify Instance of <objectname> *<name=value>
296 dc deleteClass Delete Class of <classname>
297 gp getProperty get single property of <object name>
298 sp setProperty set a single property of <object-name>
299 gq getQualifier Get Qualifier of <qualifiername>
300 sq setQualifier Not suported
301 eq enumerateQualifiers Enumerate all Qualifiers
302 dq deleteQualifier Delete qualifer of <qualifiername>
303 a associators Enumerate Associators of <classname> |
305 an associatorNames Enumerate Associator Names of <classname> |
307 r references Enumerate References of <classname> |
309 rn referenceNames Enumerate Reference Names <classname> |
311 im invokeMethod Invoke Method for <object> <method>
313 xq execQuery ExecQuery <query-expresssion>
315 ns enumerateNamespaces Enumerate all namespaces on the server.
316 son Turn On Statistics Turn on CIM Server Statistics Gathering
317 soff Turn Off Statistics Turn off CIM Server Statistics Gathering
318 ? show command options Show List of Commands -h for all help, -hc for commands, -ho for options
319 The options for this command are:
321 This command executes single CIM Operations.
323 -count count. Expected count of objects returned if summary set.
324 Tests this count and displays difference.
325 Return nonzero status code if test fails. Default(29346)
326 -d debug. More detailed debug messages. Default(false)
327 -delay delay. Delay between connection and request. Default(0)
328 -p Password. Defines password for authentication. Default()
329 -l location. Specifies system and port (HostName:port).
330 Port is optional. Default()
331 -s ssl. Specifies to connect over HTTPS. Default(false)
332 --cert clientCert. Specifies a client certificate file path to present to the server.
333 This is optional and only has an effect on connections
334 made over HTTPS using -s. Default()
335 --key clientKey. Specifies a client private key file path.
336 This is optional and only has an effect on connections
337 made over HTTPS using -s. Default()
338 -u User. Defines User Name for authentication. Default()
339 -n namespace. Specifies namespace to use for operation. Default(root/cimv2)
340 -ic includeClassOrigin. If set includeClassOrigin parameter
341 set true on requests that honor this parameter. Default(false)
342 -di deepInheritance. If set deepInheritance parameter
343 set true. Default(false)
344 -lo localOnly. DEPRECATED. This was used to set LocalOnly.
345 However, default should be true and we cannot use True
346 as default. See -nlo. Default(true)
347 -nlo notLocalOnly. When set, sets LocalOnly = false on
348 operations. Default(false)
349 -iq includeQualifiers. DEPRECATED. Sets includeQualifiers = True.
350 Useful for instance operations where default is false. Default(false)
351 -niq notIncludeQualifiers. Sets includeQualifiers = false
352 on operations. Useful for class operations where
353 the default is true.. Default(false)
354 -pl propertyList. Defines a propertyNameList. Format is p1,p2,p3
355 (without spaces). Use "" for empty. Default(###!###)
356 -ac assocClass. Defines a assocation Class string for Associator calls. Default()
357 -ar assocRole. Defines a role string for Associators. AssocRole
359 -r role. Defines a role string for reference role parameter. Default()
360 -rc resultClass. Defines a resultClass string for References and
361 Associatiors. Default()
362 -rr resultRole. Defines a role string for associators operation resultRole
364 -ip inputParameters. This option deprecated and removed. Replaced by use of
365 the same name/value pair syntax as properties in create
366 and modify instance.. Default()
367 -f filter. Defines a filter to use for query. Single String input. Default()
368 -ql queryLanguage. Defines a Query Language to be used with a query filter.
370 -o outputformats. Output in xml, mof, txt, table. Default(mof)
371 -x xmlOutput. Output objects in xml format. Default(false)
372 --version version. Displays software Version. Default(false)
373 -v verbose. Verbose Display. Outputs detailed parameter input
374 display and other request processing information. Default(false)
375 --sum summary. Displays only summary count for enumerations,
376 associators, etc.. Default(false)
377 -h help. Prints help usage message. Default(false)
378 --help full help. Prints full help message with commands, options,
379 examples. Default(false)
380 -ho help options. Prints list of options. Default(false)
381 -hc help commands. Prints CIM Operation command list. Default(false)
382 --timeout connecttimeout. Set the connection timeout in seconds.. Default(0)
383 -i interactive. Interactively ask user to select instances.
384 Used with associator and reference operations. Default(false)
385 --setRtnHostNames setRtnHostNames. Set namespace component of reference and path outputs parameter.
386 Used to allow comparison of paths and instances without involving the variable of host namespaces.. Default()
387 -trace trace. Set Pegasus Common Components Trace. Sets the Trace level.
389 --r repeat. Number of times to repeat the operation.
390 Zero means one time. Default(0)
391 --t time. Measure time for the operation and present results. Default(false)
392 --sort sort. Sort the returned entities for multi-entity responses. Default(false)
394 Options vary by command consistent with CIM Operations
396 mi modifyInstance Modify Instance of <objectname> *<name=value>
400 cimcli mi -n test/TestProvider TST_Person.Id=\"Mike\" SSN=444
401 -- Modifies the Instance if it exists using rules of DMTF
402 modifyInstance operation.
404 Valid options for this command are :
405 -n -pl (define properties to be modified)
408 -count, -d, -delay, -p, -l, -u, -o, -x, -v, --sum, --timeout, -r, --t
409 Usage: cimcli <command> <CIMObject> <Options> *<extra parameters>
410 -hc for <command> set and <CimObject> for each command
411 -ho for <Options> set
412 -h xx for <command> and <Example> for <xx> operation