wbemexec(1)wbemexec(1)NAMEwbemexec - submit a CIM operation request to a CIM Server
SYNOPSIS
hostname] portnumber] httpversion] httpmethod] timeout] username] pass‐
word] [inputfilepath]
DESCRIPTION
The command provides a command line interface to a CIM Server. The
input to the command consists of a CIM request encoded in XML. The
request is submitted to the CIM Server for execution. If the HTTP
response from the CIM Server contains a status code of 200 (OK), the
result returned to stdout is the CIM response encoded in XML. Other‐
wise, the result returned to stdout is the HTTP response. Some types
of invalid XML requests (e.g. missing PROTOCOLVERSION attribute or
missing NAME attribute) are detected by and result in an error message
from Other invalid XML requests (e.g. invalid CIMVERSION attribute
value or missing XML version), are detected by the CIM Server, and
result in an HTTP response, containing a non-Success status code, such
as 501 (Not Implemented) or 400 (Bad Request).
By default, the request is sent as an HTTP/1.1 request, using the HTTP
M-POST method, and waits 20000 milliseconds (20 seconds), then times
out if a response hasn't been received. Input is read from stdin, if
no input file is specified.
By default, the operation is executed on the local host. first
attempts to connect to the CIM Server on the default port for the wbem-
http service, and if that fails, another attempt is made on the default
port for the wbem-https service.
Options
recognizes the following options:
Connect to the CIM Server on the specified host.
If this option is not specified, connects to the
local host.
Connect to the CIM Server on the specified port number.
If this option is not specified, connects to the
default port for the wbem-http service, or if the
option is specified, to the default port for the
wbem-https service.
Use the specified HTTP version
for the request. The version must be "1.0" or
"1.1". The 1.0 version may not be specified if
the M-POST method is specified.
Use the specified HTTP method
for the request. The method must be "POST" or
"M-POST".
Wait the specified number of milliseconds on sending a request,
before timing out if no response has been received. The
timeout value must be an integer value greater
than 0.
Connect as the specified
username. If username is not specified, the cur‐
rent logged in user is used for authentication.
This option is ignored if neither hostname nor
portnumber is specified.
Authenticate the connection using the specified
password. If the password is not specified and
the remote host requests authentication, the user
is prompted for a password. This option is
ignored if neither hostname nor portnumber is
specified.
Enable the use of the SSL protocol between
and the CIM server. The option should be speci‐
fied if the CIM Server on the specified host‐
name/portnumber expects clients to connect using
HTTPS. (See for information on configuring the
CIM Server.) This option is ignored if neither
hostname nor portnumber is specified.
EXIT STATUS
When an error occurs, an explanatory error message is written to stderr
and an appropriate value is returned. The following exit values are
returned:
Success
Error
EXAMPLES
Submit an XML request contained in the file cimrequest.xml to the CIM
Server running on the local host on the default port:
Submit an XML request contained in the file cimrequest.xml to the CIM
Server running on the host hpserver on port 49152, using the username
guest and password guest for authentication:
AUTHOR
was developed by the Open Group OpenPegasus Open Source Software
project.
SEE ALSOcimserver(1M), cimconfig(1M).
STANDARDS CONFORMANCEwbemexec(1)