version 1.2, 2003/03/13 17:25:16
|
version 1.4, 2005/05/02 05:35:42
|
|
|
.\" $Header$ | .\" $Header$ |
.TA w \" lowercase initial letter of .TH name |
.\" .TA w \" lowercase initial letter of .TH name |
.TH wbemexec 1 |
.TH "wbemexec" "1" "" "" "" |
.ds )H Hewlett-Packard Company |
.SH "NAME" |
.SH NAME |
|
wbemexec \- submit a CIM operation request to a CIM Server | wbemexec \- submit a CIM operation request to a CIM Server |
.SH SYNOPSIS |
.SH "SYNOPSIS" |
|
\fBwbemexec\fP [ \fB\-h\fP hostname ] [ \fB\-p\fP portnumber ] [ \fB\-v\fP httpversion ] |
\fBwbemexec\fP [ \fB-h\fP hostname ] [ \fB-p\fP portnumber ] [ \fB-v\fP httpversion ] [ \fB-m\fP httpmethod ] [ \fB-t\fP timeout ] [ \fB-u\fP username ] [ \fB-w\fP password ] [ \fB-s\fP ] [ inputfilepath ] |
[ \fB\-m\fP httpmethod ] [ \fB\-t\fP timeout ] [ \fB\-u\fP username ] |
|
[ \fB\-w\fP password ] [ \fB\-s\fP ] [ \fB\-\-help\fP ] [ \fB\-\-version\fP ] |
.SH DESCRIPTION |
[ inputfilepath ] |
|
.SH "DESCRIPTION" |
The | The |
.B wbemexec | .B wbemexec |
command provides a command line interface to a CIM Server. | command provides a command line interface to a CIM Server. |
|
|
.B wbemexec. | .B wbemexec. |
Other invalid XML requests (e.g. invalid CIMVERSION attribute value | Other invalid XML requests (e.g. invalid CIMVERSION attribute value |
or missing XML version), are detected by the CIM Server, | or missing XML version), are detected by the CIM Server, |
and result in an HTTP response, containing a non-Success status code, |
and result in an HTTP response, containing a non\-Success status code, |
such as 501 (Not Implemented) or 400 (Bad Request). | such as 501 (Not Implemented) or 400 (Bad Request). |
.PP | .PP |
By default, the request is sent as an HTTP/1.1 request, | By default, the request is sent as an HTTP/1.1 request, |
using the HTTP M-POST method, and |
using the HTTP M\-POST method, and |
.B wbemexec | .B wbemexec |
waits 20000 milliseconds (20 seconds), | waits 20000 milliseconds (20 seconds), |
then times out if a response hasn't been received. | then times out if a response hasn't been received. |
|
|
the operation is executed on the local host. | the operation is executed on the local host. |
.B wbemexec | .B wbemexec |
first attempts to connect to the CIM Server on the default port for the | first attempts to connect to the CIM Server on the default port for the |
wbem-http service, |
wbem\-http service, |
and if that fails, another attempt is made on the default port for the | and if that fails, another attempt is made on the default port for the |
wbem-https service. |
wbem\-https service. |
.SS Options | .SS Options |
.B wbemexec | .B wbemexec |
recognizes the following options: | recognizes the following options: |
.RS | .RS |
.TP 15 | .TP 15 |
\fB-h\fP hostname |
\fB\-h\fP hostname |
Connect to the CIM Server on the specified host. | Connect to the CIM Server on the specified host. |
If this option is not specified, | If this option is not specified, |
.B wbemexec | .B wbemexec |
connects to the local host. | connects to the local host. |
.TP | .TP |
\fB-p\fP portnumber |
.B \-\-help |
|
Display command usage information. |
|
.TP |
|
\fB\-m\fP httpmethod |
|
Use the specified HTTP method |
|
for the request. The method must be "POST" or "M\-POST". |
|
.TP |
|
\fB\-p\fP portnumber |
Connect to the CIM Server on the specified port number. | Connect to the CIM Server on the specified port number. |
If this option is not specified, | If this option is not specified, |
.B wbemexec | .B wbemexec |
connects to the default port for the wbem-http service, or if the |
connects to the default port for the wbem\-http service, or if the |
.B -s |
.B \-s |
option is specified, to the default port for the wbem-https service. |
option is specified, to the default port for the wbem\-https service. |
.TP |
|
\fB-v\fP httpversion |
|
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. |
|
.TP | .TP |
\fB-m\fP httpmethod |
.B \-s |
Use the specified HTTP method |
Enable the use of the SSL protocol between |
for the request. The method must be "POST" or "M-POST". |
.C wbemexec |
|
and the CIM server. |
|
The |
|
.B \-s |
|
option should be specified if the CIM Server |
|
on the specified hostname/portnumber expects clients to connect using HTTPS. |
.TP | .TP |
\fB-t\fP timeout |
\fB\-t\fP timeout |
Wait the specified number of milliseconds on sending a request, before timing out if no response has been received. The | Wait the specified number of milliseconds on sending a request, before timing out if no response has been received. The |
.I timeout | .I timeout |
value must be an integer value greater than 0. | value must be an integer value greater than 0. |
.TP | .TP |
\fB-u\fP username |
\fB\-u\fP username |
Connect as the specified | Connect as the specified |
.IR username . | .IR username . |
If | If |
|
|
.I portnumber | .I portnumber |
is specified. | is specified. |
.TP | .TP |
\fB-w\fP password |
\fB\-v\fP httpversion |
|
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. |
|
.TP |
|
\fB\-\-version\fP |
|
Display CIM Server version. |
|
.TP |
|
\fB\-w\fP password |
Authenticate the connection using the specified | Authenticate the connection using the specified |
.IR password . | .IR password . |
If the | If the |
|
|
nor | nor |
.I portnumber | .I portnumber |
is specified. | is specified. |
.TP |
|
.B -s |
|
Enable the use of the SSL protocol between |
|
.C wbemexec |
|
and the CIM server. |
|
The |
|
.B -s |
|
option should be specified if the CIM Server |
|
on the specified hostname/portnumber expects clients to connect using HTTPS. |
|
(See | (See |
.B "cimconfig (1M)" |
.B "cimconfig (1)" |
for information on configuring the CIM Server.) | for information on configuring the CIM Server.) |
This option is ignored if neither | This option is ignored if neither |
.I hostname | .I hostname |
|
|
.PD | .PD |
.RE | .RE |
| |
.SH EXIT STATUS |
.SH "EXIT STATUS" |
.PP | .PP |
When an error occurs, an explanatory error message is written to stderr and an | When an error occurs, an explanatory error message is written to stderr and an |
appropriate value is returned. The following exit values are returned: | appropriate value is returned. The following exit values are returned: |
|
|
Error | Error |
.PD | .PD |
.RE | .RE |
.SH EXAMPLES |
.SH "USAGE NOTE" |
|
.PP |
|
The |
|
.B wbemexec |
|
command requires that the CIM Server is running. |
|
.SH "EXAMPLES" |
.PP | .PP |
Submit an XML request contained in the file cimrequest.xml to the CIM Server | Submit an XML request contained in the file cimrequest.xml to the CIM Server |
running on the local host on the default port: | running on the local host on the default port: |
|
|
.I password | .I password |
guest for authentication: | guest for authentication: |
.IP | .IP |
.B wbemexec -h hpserver -p 49152 -u guest -w guest cimrequest.xml |
.B wbemexec \-h hpserver \-p 49152 \-u guest \-w guest cimrequest.xml |
.PP | .PP |
.SH SEE ALSO |
.SH "SEE ALSO" |
.PP | .PP |
cimserver(1M), cimconfig(1M). |
cimserver(1), cimconfig(1). |
.SH STANDARDS CONFORMANCE |
.SH "STANDARDS CONFORMANCE" |
.PP | .PP |
\fBwbemexec\fP: CIM Operations over HTTP 1.0, Representation of CIM in XML 2.0 | \fBwbemexec\fP: CIM Operations over HTTP 1.0, Representation of CIM in XML 2.0 |