1wbemexec(1) wbemexec(1)
2
6 wbemexec - submit a CIM operation request to a CIM Server
7
9 wbemexec [ -h hostname ] [ -p portnumber ] [ -v httpversion ]
10 [ -m httpmethod ] [ -t timeout ] [ -u username ]
11 [ -w password ] [ -s ] [ --help ] [ --version ]
12 [ inputfilepath ]
13
15 The wbemexec command provides a command line interface to a CIM Server.
16 The input to the command consists of a CIM request encoded in XML. The
17 request is submitted to the CIM Server for execution. If the HTTP
18 response from the CIM Server contains a status code of 200 (OK), the
19 result returned to stdout is the CIM response encoded in XML. Other‐
20 wise, the result returned to stdout is the HTTP response. Some types
21 of invalid XML requests (e.g. missing PROTOCOLVERSION attribute or
22 missing NAME attribute) are detected by wbemexec, and result in an
23 error message from wbemexec. Other invalid XML requests (e.g. invalid
24 CIMVERSION attribute value or missing XML version), are detected by the
25 CIM Server, and result in an HTTP response, containing a non-Success
26 status code, such as 501 (Not Implemented) or 400 (Bad Request).
27 By default, the request is sent as an HTTP/1.1 request, using the HTTP
29 M-POST method, and wbemexec waits 20000 milliseconds (20 seconds), then
30 times out if a response hasn't been received. Input is read from
31 stdin, if no input file is specified.
32 By default, the operation is executed on the local host. wbemexec
34 first attempts to connect to the CIM Server on the default port for the
35 wbem-http service, and if that fails, another attempt is made on the
36 default port for the wbem-https service.
37 Options
39 wbemexec recognizes the following options:
40 -h hostname Connect to the CIM Server on the specified host.
42 If this option is not specified, wbemexec con‐
43 nects to the local host.
44 --help Display command usage information.
46 -m httpmethod Use the specified HTTP method for the request.
48 The method must be "POST" or "M-POST".
49 -p portnumber Connect to the CIM Server on the specified port
51 number. If this option is not specified, wbe‐
52 mexec connects to the default port for the
53 wbem-http service, or if the -s option is speci‐
54 fied, to the default port for the wbem-https ser‐
55 vice.
56 -s Enable the use of the SSL protocol between and
58 the CIM server. The -s option should be speci‐
59 fied if the CIM Server on the specified host‐
60 name/portnumber expects clients to connect using
61 HTTPS.
62 -t timeout Wait the specified number of milliseconds on
64 sending a request, before timing out if no
65 response has been received. The timeout value
66 must be an integer value greater than 0.
67 -u username Connect as the specified R username . If user‐
69 name is not specified, the current logged in user
70 is used for authentication. This option is
71 ignored if neither hostname nor portnumber is
72 specified.
73 -v httpversion Use the specified HTTP version for the request.
75 The version must be "1.0" or "1.1". The 1.0 ver‐
76 sion may not be specified if the M-POST method is
77 specified.
78 --version Display CIM Server version.
80 -w password Authenticate the connection using the specified
82 password . This option is ignored if neither
83 hostname nor portnumber is specified. WARNING: A
84 password should not be specified on the command
85 line on a multi-user system, since command-line
86 options are typically world-readable for a short
87 window of time. If the remote host requests
88 authentication and this option is not specified,
89 wbemexec will prompt for the password. (See cim‐
90 config (1) for information on configuring the CIM
91 Server.)
92
95 When an error occurs, an explanatory error message is written to stderr
96 and an appropriate value is returned. The following exit values are
97 returned:
98 0 Success
100 1 Error
101
103 The wbemexec command requires that the CIM Server is running.
104
106 Submit an XML request contained in the file cimrequest.xml to the CIM
107 Server running on the local host on the default port:
108 wbemexec cimrequest.xml
110 Submit an XML request contained in the file cimrequest.xml to the CIM
112 Server running on the host hpserver on port 49152, using the username
113 guest and password guest for authentication:
114 wbemexec -h hpserver -p 49152 -u guest -w guest cimrequest.xml
116
118 cimserver(1), cimconfig(1).
119
121 wbemexec: CIM Operations over HTTP 1.0, Representation of CIM in XML
122 2.0
123 wbemexec(1)