wbemcli

PROGRAM:

NAME

wbemcli - independent command line CIM Client

SYNOPSIS

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

Alternate formats:

(These symlinks are not installed by the Debian package, but work if created manually.)

wbemgc [-nl] [-h] [-t] [-dx] [-dr] objectPath [prop[,...]]

wbemgcd [-nl] [-h] [-t] [-dx] [-dr] objectPath

wbemdc [-nl] [-h] [-t] [-dx] [-dr] objectPath

wbemec [-nl] [-h] [-t] [-cte] [-dx] [-dr] objectPath [prop[,...]]

wbemecn [-nl] [-h] [-t] [-dx] [-dr] objectPath

wbemgi [-nl] [-h] [-t] [-dx] [-dr] objectPath [prop[,...]]

wbemci [-nl] [-h] [-t] [-dx] [-dr] objectPath [prop=value[,...]]

wbemmi [-nl] [-h] [-t] [-dx] [-dr] objectPath [prop=value[,...]]

wbemdi [-nl] [-h] [-t] [-dx] [-dr] objectPath

wbemei [-nl] [-h] [-t] [-cte] [-dx] [-dr] objectPath [prop[,...]]

wbemein [-nl] [-h] [-t] [-dx] [-dr] objectPath

wbemai [-nl] [-h] [-t] [-cte] [-dx] [-dr] [-ac assocClass] [-arc resultClass]
[-ar role] [-arr resultRole] objectPath [prop[,...]]

wbemain [-nl] [-h] [-t] [-dx] [-dr] [-ac assocClass] [-arc resultClass] [-ar role]
[-arr resultRole] objectPath

wbemri [-nl] [-h] [-t] [-cte] [-dx] [-dr] [-arc resultClass] [-ar role] objectPath
[prop[,...]]

wbemrin [-nl] [-h] [-t] [-dx] [-dr] [-arc resultClass] [-ar role] objectPath

wbemgp [-nl] [-h] [-t] [-dx] [-dr] objectPath prop

wbemsp [-nl] [-h] [-t] [-dx] [-dr] objectPath prop=value

wbemcm [-nl] [-h] [-t] [-dx] [-dr] objectPath method[.param=value[,...]]

wbemcmx [-nl] [-h] [-t] [-dx] [-dr] objectPath method[.param=value[,...]]

DESCRIPTION

wbemcli is a command line based CIM Client. It uses one of the
gc|gcd|dc|ec|ecn|gi|ci|mi|di|ei|ein|ai|ain|ri|rin|gp|sp|cm|cmx operations and the fully
qualified path to the CIM Object to get to the host and execute the specified operation.
This implementation is CIMOM library independent and can be used with all WBEM compliant
CIMOM implementations. The objectPath parameter is used to locate the CIM object and has
the following format:

<scheme>://[user:pwd@]<host>:<port>/<namespace[/..]>:<classname>[.<key=value[,..]>]

The objectPath should be enclosed in single quotes so that double quoted
strings are perserved by the command line shell. Refer to the examples section.

The only scheme supported is http. Example:
http://krz:xyz@localhost:5988/root/cimv2:rpm_package.name=glibc

The prop=value[,...] parameter is used to specify <Property>=<Value> pairs for the ci, mi
and sp operations. Only one <Property>=<Value> pair must be specified for the sp
operation.

Example:
stringProp="a string",booleanProp=true,numericProp=25

Arrays of property values are supported by specifying additional values
separated by commas

Example:
stringProp="a string","another string",numericProp=25,49,12

The prop[,...] parameter specifies the properties to be returned. One prop must be
specified for the gp operation. For other operations this parameter is optional, if none
are specified all properties will be returned.

Example:
stringProp,booleanProp,numericProp

The method[.param=value[,...] parameter is used to specify <Parameter>=<Value> pairs for
the cm operation.

Example:
Method2Execute.stringParam="a string",booleanParam=true,numericParam=25

Arrays of property values are supported by specifying additional values
separated by commas

Example:
Method2Execute.stringParam="a string","another string",numericParam=25,49,12

OPERATIONS:

Supported operations are:

gc get class

gcd get class definition

dc delete class

ec enumerate classes

ecn enumerate class names

gi get instance

ci create instance

mi modify instance

di delete instance

ei enumerate instances

ein enumerate instance names

ai enumerate association instances

ain enumerate association instance names

ri enumerate reference instances

rin enumerate reference instance names

gp get property

sp set property

cm call method

cmx call method (return XML)

OPTIONS

-h Print a help message

-nl Start a new line for every property returned

-t Append array ([]), reference (&) and key property (#) indicators to property names

-cte Enable support for chunked responses from CIMOM

-v Show version information

-dx Show XML messages payload as received from CIMOM

-dr Delineate references with { } pairs

-noverify
Do not verify the server certificate for https URLs (useful for testing)

-cacert
CA certificate file (required for https URLS unless -noverify is specified)

-clientcert
Client certificate file (if the CIM server requires client certificates)

-clientkey
Client private key file (required if -clientcert is specified)

-ac association class name (ai, ain only)

-arc result class name (ai, ain, rin, ri only)

-ar role name (ai, ain, rin, ri only)

-arr result role name (ai, ain only)

LIBRARIES

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

Example

To get all instances of rpm_packages, i.e. all installed rpm packages on the local system,
the following command can be used:

wbemcli ei 'http://localhost:5988/root/cimv2:rpm_package'

The get instance operation can be specified to get more information about a certain
package:

wbemcli gi 'http://localhost:5988/root/cimv2:rpm_package.name="glibc"'

The create instance (ci) operation can be called using the following format example.
Property values can also be specified/add to the sytax.

wbemcli ci
'http://localhost:5988/root/cimv2:TST_InstanceProperties.CreationClassName="TST_InstanceProperties",Id="Instance
#2"' 'CreationClassName="TST_InstanceProperties",Id="Instance #2",Property_string2="This
is instance#2",Property_uint8=250'

More command line examples can be found from the wbemcli/samples directory.

Host indirection support

The scheme and host specification in the object path can be replaced by an arbitrary token
that will be used to locate the proper scheme and host specification in ./wbemcli.ind or
any file specified via the WBEMCLI_IND environment variable. The format of this file is
as follows:

<token>: <scheme>://[user:pwd@]<host>:<port>

Assuming the following entry in ./wbemcli.ind:

myCimom: http://localhost:5988

The example in the previous section can then be specified as:

wbemcli gi 'myCimom/root/cimv2:rpm_package.name="glibc"'

Use wbemcli online using onworks.net services