1wbemexec(1)                                                        wbemexec(1)
2
3
4

NAME

6       wbemexec - submit a CIM operation request to a CIM Server
7

SYNOPSIS

9       wbemexec [ -h hostname ] [ -p portnumber ] [ -v httpversion ]
10                [ -m httpmethod ] [ -t timeout ] [ -u username ]
11                [ -w password ] [ -s ] [ --help ] [ --version ]
12                [ inputfilepath ]
13

DESCRIPTION

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
28       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
33       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
38   Options
39       wbemexec recognizes the following options:
40
41              -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
45              --help         Display command usage information.
46
47              -m httpmethod  Use the specified HTTP method  for  the  request.
48                             The method must be "POST" or "M-POST".
49
50              -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
57              -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
63              -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
68              -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
74              -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
79              --version      Display CIM Server version.
80
81              -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
93

EXIT STATUS

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
99              0      Success
100              1      Error
101

USAGE NOTE

103       The wbemexec command requires that the CIM Server is running.
104

EXAMPLES

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
109              wbemexec cimrequest.xml
110
111       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
115              wbemexec -h hpserver -p 49152 -u guest -w guest cimrequest.xml
116

SEE ALSO

118       cimserver(1), cimconfig(1).
119

STANDARDS CONFORMANCE

121       wbemexec:  CIM  Operations  over HTTP 1.0, Representation of CIM in XML
122       2.0
123
124
125
126                                                                   wbemexec(1)
Impressum