WS SDK Professional Edition Development Utilities

wbemop

The wbemop program is a CLI (Command Line Interface) utility that will allow a user to execute CIM Operations against a WBEM Server.

Run wbemop from the following directory

Platform	Directory
Windows	C:\Program Files\ws\sdk\bin
Linux	/usr/ws/sdk/bin
Solaris	/opt/ws/sdk/bin

Command Line Syntax

The wbemop utility can be invoked by typing wbemop at the command prompt. The command line syntax for the wbemop utility is included in the two following tables.

C:\>cd \Program Files\ws\sdk\bin


						C:\Program Files\ws\sdk\bin>wbemop -h
 WBEMOp [options] OBJECTPATH COMMAND [ATTRS]
 Copyright (c) 2002-2010 WS, Inc.
 Use is Subject to
						License Terms.



						Options:
 -ac <name> Association class name
 -ar <name> Association
							role argument
 -co Include class origin information
 -d Display
							debug information
 -dh Deep Inheritance off
 -f <filter> Filter
							for query execution
 -h Display this usage statement
 -kf <file> KeyStore File (Mutual Authentication)
 -kp <password> KeyStore Password (Mutual Authentication)

						-l <locales> List of locales in priority order.
 -lo Include
							local properties only
 -nq Do not include qualifiers
 -p <credential> WBEM Server credential (e.g. password)
 -ph <host> HTTP Proxy Host
 -pl <prop>,* Comma-separated property list
 -pp <port> HTTP Proxy Port
 -ql <language> Query Language to use for executing queries
 -rc <name> Result class name
 -rp
						<credential> WBEM Server Role credential (e.g. password)
 -ru <principal> WBEM Server Role principal (e.g. role to assume)
 -rr <name> Result role class name
 -s
						<server> WBEM Server URL
 -tf <file> TrustStore File
							(Mutual Authentication)
 -u <principal> WBEM Server principal (e.g. username)
 -v Display the version information
 -wp <protocol> WBEM Protocol (e.g. CIM-XML, WS-Management, ..)

						-x Display the results in XML
 -mo Maximimum number of objects for
							each Pull request (defau lt 1)
 -su Change the Resource URI (default: http://schemas.dmtf.or
							g/wbem/wscim/1/cim-schema/2/)


						Commands:
 OBJECTPATH The objectpath of the element.
 COMMAND
 ci Create an Instance
 dc Delete a Class
 di Delete an
							Instance
 dq Delete a Qualifier Type Declaration
 ec Enumerate
							Classes
 ei Enumerate Instances
 eq Enumerate Qualifier
							Types Declarations
 gc Get a Class
 gi Get an Instance

						gq Get a Qualifier Type Declaration
 mi Modify an Instance

						nc Enumerate Class Names
 ni Enumerate Instance Names
 as Associators
 an AssociatorNames
 rs References
 rn
						ReferenceNames
 qe Execute the supplied/default query
 pan Pull Associator Names
 pas Pull Associators
 pei Pull
							Enumerate Instance
 pni Pull Enumerate Instance Names
 prn Pull
							Reference Names
 prs Pull References

ATTRS prop=value[,prop=value]


						Examples:
 wbemop -s http://myhost/interop CIM_Test.InstanceID="org id:3" mi array={1;2;3 }
 wbemop -pl name,handle -s
						https://localhost/interop CIM_ProtocolAdapter ei
 wbemop -nq CIM_ManagedElement gc

C:\Program Files\ws\sdk\bin>

CAUTION: wbemop does not support metadata operations (e.g. gc, ec, etc) when using the WS-Management protocol because the WS-Management protocol does not support metadata operations.

Default Values

The following table shows the default values for each of the option arguments. If an option is not listed, then it has no default value.

Option	Description	Default
-ac	Association	null
-ar	Association Class argument	null
-co	Class origin	TRUE
-d	Display XML Debug Information	FALSE
-dn	Deep Inheritance	TRUE
-h	Display this usage statement	FALSE
-lo	Include local properties only	FALSE
-nq	Do not include qualifiers	FALSE
-p <credentials>	CIM Server credential (e.g. Password)	null
-pl <prop><prop>	Query Language	WQL
ql	Comma-separated propery list	null
-rc	Result class argument	null
-rr	Result Role argument	null
-s <server>	WBEM Server URL	http://localhost/interop
-u <proncipal>	WBEM Server principal (e.g. Username)	guest
-v	Display the version information	FALSE
-wp	WBEM Protocol	CIM-XML
-x	Prints the results in cimXML format	FALSE

Example

The following use cases will show examples of how to use wbemop. The examples shown use CIM-XML a secure HTTPS connection. To use an HTTP connection, replace https with http.

For example:

Replace
wbemop -s https://localhost/interop -u user1 -p pass1 CIM_ObjectManager ei
With
wbemop -s http://localhost/interop -u user1 -p pass1 CIM_ObjectManager ei

C:\>cd \Program Files\ws\sdk\bin


						C:\Program Files\ws\sdk\bin>wbemop -s https://localhost/interop -u user1 -p pass1 CIM_ObjectManager ei instance of WBEMSolutions_ObjectManager { 
 

						Version = "3.4.3";
 Build = "04/21/2010 04:55";
 PrimaryOwnerName = "WS, Inc.";
 PrimaryOwnerContact = "http://www.ws-inc.com/";

						Caption = "WS J WBEM Server";
 Description = "WS J WBEM Server";
 ElementName = "WS J WBEM Server";
 Started = true;

						OperationalStatus = {2};
 CreationClassName = "WBEMSolutions_ObjectManager";
 SystemCreationClassName = "WBEMSolutions_ComputerSystem";

						SystemName = "192.168.2.104";
 Name = "WBEMSolutions:e05f6594-7b0f-44f3-a690-d34e75a8f849";
 
 };

Processed 1 elements in 1657 milliseconds. C:\Program Files\ws\sdk\bin>

For more information about the the WS products please contact sales.