Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
wbemcli(1)		     General Commands Manual		      wbemcli(1)

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:
     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 re-
     sultClass] [-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]  ob-
     jectPath

     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 exe-
     cute the specified operation.  This implementation is CIMOM  library  inde-
     pendent 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[/..]>:<class-
     name>[.<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 exam-
	    ples 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	<Parame-
     ter>=<Value> pairs for the cm operation.

     Example:
	    Method2Execute.stringParam="a     string",booleanParam=true,numeric-
	    Param=25

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

     Example:
	    Method2Execute.stringParam="a    string","another	string",numeric-
	    Param=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 certifi-
	    cates)

     -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.Cre-
      ationClassName="TST_InstanceProperties",Id="Instance #2"'  'CreationClass-
      Name="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  direc-
      tory.

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"'

FILES
     ${datarootdir}/sblim-wbemcli/cacert.pem
	    The default CA certificate file. Can be overriden with -cacert.

AUTHOR
     Adrian Schuur <schuur@de.ibm.com>

BUGS
     The SBLIM project maintains a mailing list to which you should  direct  all
     questions regarding sfcb, sfcc, wbemcli, or any of the SBLIM providers.  To
     subscribe to this mailing list visit

	    http://lists.sourceforge.net/lists/listinfo/sblim-issues

     The SBLIM Project Bug tracking page can be found at

	    http://sourceforge.net/tracker/?group_id=128809&atid=712784

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

AVAILABILITY
     wbemcli  is  a part of the SBLIM project. The most recent version is avail-
     able on the web at

	    http://sblim.sourceforge.net/

SEE ALSO
     cimserver(1)

wbemcli Version 1.6.3		    June 2009			      wbemcli(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=wbemcli&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help