HP Virtual Connect Enterprise Manager 6.3.1 CLI Guide

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
DescriptionCLI options
Set as the username for authentication with SIM. If not
specified, VCEMCLI will use the Windows username of the
current user.
-user username
Used when authenticating with SIM and the –user
argument was also provided.
-pw password
Used to contact the SIM server. If not provided, the default
port is 50001. This argument is only required if the SIM
–port port
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.
Suppresses output from VCEMCLI.–silent
Executable 7