Users Guide

Related References
About Tokens
Generic Command
About Tokens
The following tokens can be used to pass values to the batch, script, or executable file:
$IP and $RAC_IP — If these arguments are used, the Task Target tab appears in the Create a
Command Link Task screen. The Task Target tab allows you to select the targets to pass the
arguments. $IP is used for a server IP and $RAC_IP is used for a RAC (iDRAC) IP. From the Task Target
tab, you can select either groups, a device or use dynamic queries.
$USERNAME and $PASSWORD — In some instances, you must provide credentials for a remote
system in your batch or script file. If $USERNAME or $PASSWORD are used in arguments, the Script
Credentials section appears for these values. The credentials entered in the Script Credentials section
is passed to the command line. You can pass either of these values or both.
NOTE: You must enter both values in the Script Credentials section. If you do not need to use
one value, enter any text in the field and it is ignored if the token is not in use.
$NAME — This token passes the name of the system found in the OpenManage Essentials Device
Tree. The name is most often the host name of the system, but in some instances it might be either
an IP address or a string such as Dell Rack System – SVCTAG1.
Passing Tokens to a Script
If you are using a batch file or a script, use %1, %2, %3 , and so on to receive the values passed from
OpenManage Essentials. The values are passed in the order they are entered from left to right in the
Arguments field.
For example, if you use $USERNAME $PASSWORD $IP $RAC_IP $NAME as arguments, a batch file with
the following Echo %1 %2 %3 %4 %5 displays the following result:
C:\Windows\system32>echo scriptuser scriptpw 10.36.1.180 10.35.155.111 M60505-
W2K8x64 scriptuser scriptpw 10.36.1.180 10.35.155.111 M60505-W2K8x64
NOTE: The credentials are passed in plain text to the command line. If you schedule a task to run
later, the credentials are encrypted and stored in the database. The credentials are decrypted when
the task runs at the scheduled time. However, if you use the RUN option on a previously created
task, enter both administrator credentials for the system and the script credentials.
Managing Server Power Options
You can create tasks to manage power on servers.
NOTE: The power task requires that the Windows Management Instrumentation service is running
on the selected targets.
To create a remote task:
1. From OpenManage Essentials, click ManageRemote TasksCommon TasksCreate Power
Task.
2. In Create a Power Task, on General, do the following:
Provide task name.
Select power options. If required, select Shutdown OS first to shut the operating system down
before starting the power tasks.
3. On Task Target, do one of the following:
239