HP Insight Management-Software - Manual (Page 8)

2 Using VCEMCLI
VCEMCLI can be executed from the Windows command line or from scripts written in any
Windows-supported scripting language.
Executable
The vcemcli.exe executable is located in the HP VCEM Installation Root
Directory\Virtual Connect Enterprise Manager CLI
directory.
During the VCEM installation process, the directory containing vcemcli.exe is added to the
%PATH%
environment variable.
Environment Variable
VCEMCLI allows you to control its behavior and its common options by using the Windows
environment variable (EV) VCEMCLI. The format for the EV is exactly the same as the command
line. Any arguments contained in this EV are appended to the list of arguments provided on the
vcemcli.exe
command line. Any arguments contained in the EV that are also provided on the
command line will be ignored.
Common options
VCEMCLI command line options are not case sensitive. Options present on the command line
override any corresponding values contained by the VCEMCLI environment variable (if set).
Table 1 displays the common vcemcli.exe command line options and their descriptions.
Table 1 Common options
Description CLI options
Set as the username for authentication with Systems Insight
Manager. If not specified, VCEMCLI will use the Windows
username of the current user. -user username
Used when authenticating with Systems Insight Manager
and the –user argument was also provided. -pw password
Used to contact the Systems Insight Manager server. If not
provided, the default port is 50001. This argument is only –port port
required if the Systems Insight Manager environment is
changed to require SOAP connections on a different port.
File containing VCEMCLI log messages. –logfile logfilename
Can be set to control the amount of information logged by
VCEMCLI. The available levels are: “debug”, “info”,
“warn”, “error”, “off”. –loglevel level
The maximum size in KB of the VCEMCLI log file. –logsize size in kb
The default behavior is for commands to block and wait
for completion of the associated job or power operation –nb
before continuing. The –nb (non-block) option causes
normally blocking commands to return immediately after
being submitted. You must check the result of the
non-blocking job or power operation separately to
determine its success or failure.
8 Using VCEMCLI