Users Guide

32
Using OpenManage Essentials Command Line
Interface
Launching the OpenManage Essentials Command Line Interface
Click Start → All Programs → OpenManage Applications → Essentials → Essentials Command Line Interface.
Creating a Discovery Prole Input File
CLI commands that create discovery ranges or discovery groups require an XML-based le that denes the parameters for discovery
protocols such as SNMP, WMI, Storage, WS-Man, SSH, and IPMI. This le denes which protocols are used and the parameters for
each of the protocols. The le can be modied using an XML editor or a text editor. The DiscoveryProle.xml) le is placed at C:
\Program Files\Dell\SysMgt\Essentials\Tools\CLI. Edit the xml le and rename it to create multiple discovery proles. You cannot
store passwords for WMI, IPMI, WS-Man, EMC and SSH protocols in the XML le. The OpenManage Essentials CLI commands
allow you to specify passwords in the command line argument using the following commands:
• -wmiPassword<secure password>
• -ipmiPassword<secure password>
• -wsmanPassword<secure password>
• -emcPassword<secure password>
• -sshPassword<secure password>
• -SNMPv3AuthenticationPassword<secure password>
• -SNMPv3EncryptionPassword<secure password>
NOTE: Passwords are not allowed in clear text. If you attempt to use clear text for the password values, the CLI
command will not be successful.
The <secure password> argument must be a secure password. To generate a secure password that can be re-used in PowerShell
scripts, run the following (or a similar command) from within a PowerShell window:
To prompt the user for a password; read in and convert it to a secure string:
PS> $password = Read-Host ‘Enter password:’ –AsSecureString
To save the password, as a secure string, to the le system:
PS> $password | ConvertFrom-SecureString | Set-Content c:\tmp\password.txt
The two earlier PowerShell commands convert a password to a secure string that is then saved in a le. This secure password can
subsequently be used in other PowerShell scripts that involve OpenManage Essentials CLI commands. For example:
To read the secure password from the le and assign it to a variable:
PS> $passwordFile = convert-path c:\tmp\password.txt
PS> $wsmanpassword = Get-Content $passwordFile | ConvertTo-SecureString
To use the secure string in all the password variables in the OpenManage Essentials CLI commands:
PS> Add-DiscoveryRange -Range 10.36.0.48 -Profile samples\DiscoveryProfile.xml -
WSManPassword $wsmanpassword
An example of the prole.xml le is outlined as follows:
<?xml version="1.0" encoding="utf-8" ?>
<DiscoveryConfiguration>
<NetMask>
255.255.255.240
369