Back to Utilities and Command-Line Operation
Dell OpenManage IT Assistant User's Guide
Connect/EndConnect | Restart | ||
DisableEvents | Set | ||
EnableEvents | StartComponent/Endcomponent | ||
FlashBios | StartGroup/EndGroup | ||
Get | Shutdown | ||
Mapping/EndMapping | WakeUp | ||
Example Script |
NOTE: You must run discript on the management station. |
NOTE: You can use discript to manage client (nonserver) systems only. |
The Connect/EndConnect command block connects the application to a valid Internet Protocol (IP) address.
Connect <system>;
EndConnect;
<system> is a valid IP address. If you are connecting to the local system, you can use the value Local. It connects to the specified system using the Desktop Management Interface (DMI) protocol. If you use @<filename> instead of the system name, this command executes all the commands within the Connect statement for each system specified in the file until it reaches the end of the file.
The DisableEvents command disables events for the connected system.
Example:
Connect 1.2.3.4;
DisableEvents;
EndConnect;
This disables all the events for IP address 1.2.3.4.
The EnableEvents command enables events for the connected system.
Example:
Connect 1.2.3.4;
EnableEvents;
EndConnect;
This enables all the events for IP address 1.2.3.4.
The FlashBios command enables you to perform a remote flash BIOS update on a system.
FlashBios <IP Address>,<filename>;
<IP Address> is a valid IP address for the system for which you want to update the BIOS.
<filename> is a valid flash BIOS filename (*.hdr file).
You can use this command outside of the Connect - EndConnect block. For example:
FlashBios 1.2.3.4,c:\A02.hdr;
Connect 1.2.3.4;
Restart;
EndConnect;
The Get command retrieves information.
Get <keyword>;
where:
<keyword> is a keyword from the Get Keyword List.
You must use this command inside the Connect block.
Example:
Connect 1.2.3.4;
Get ServiceTag;
Print "Service Tag = ",result,LF;
EndConnect;
This gets the service tag of the system at IP address 1.2.3.4.
The Mapping/EndMapping command exports DMI attributes to Management Information Format (MIF) format, which can be read by third-party tools.
Mapping <filename>;
EndMapping;
where:
<filename> is either a valid filename or a valid @ command.
Example:
Connect 1.2.3;
Mapping default.mif;
StartComponent "My Component";
StartGroup "My Group",1,"DELL|My Class|001";
Get SystemName;
PrintAttribute "System Name",result;
EndGroup;
EndComponent;
EndMapping;
EndConnect;
This shows the commands that can be used within the mapping block.
NOTE: To map more than one system, use the @ command in the Connect statement and the corresponding @ command in the output file. This command generates the corresponding file for each system. |
The Print command prints the result buffer. The result buffer contains the result obtained by the last Get command.
Print <"string">,result,<LF> | <TAB>;
where:
<"string"> is a string within quotation marks
result is the contents of the result buffer
LF is a line feed
TAB is the tab character used to export the file to Microsoft® Excel. You can use Print to print strings, and this command must be followed by the line feed (LF) or TAB keyword.
Example:
Connect 1.2.3.4;
Get ServiceTag;
Print "Service Tag = ",result,LF;
EndConnect;
The Restart command restarts the system.
The example:
Connect 1.2.3.4;
Set Password,<password>;
Restart;
EndConnect;
NOTE: You must set the password if a password is installed. |
The Set command retrieves information. For example, it can retrieve the asset tag of the system at IP address 1.2.3.4.
Set <keyword>,<value>;
where:
<keyword> is a keyword from the Set Keyword List.
<value> is a string or integer value. Supported values are listed in the Set Value Table.
You must use this command inside the Connect block.
Example:
Connect 1.2.3.4;
Set AssetTag,xyz;
Get AssetTag;
Print "Asset Tag = ",result,LF;
EndConnect;
This command gets the asset tag of the system at IP address 1.2.3.4.
The StartComponent/EndComponent command indicates the start of a block that defines a DMI component that you want to map. You can use this command only within a Mapping/Endmapping command block.
StartComponent <componentname>
EndComponent
Example:
mapping @d:\ste2\bscript\debug\mif.dat;
StartComponent PortableComponent;
StartGroup "MyGroup",1,"DELL|MyGroup|001";
get SystemName;
printattribute SystemName,result;
EndGroup;
EndComponent;
endmapping;
The StartGroup/EndGroup command indicates the start of a block that defines the DMI groups that you want to map. You can use this command only within a StartComponent/EndComponent command block.
StartGroup "<groupname>",<qty>,"<dmigroupname>"
EndGroup;
Example:
mapping @d:\ste2\bscript\debug\mif.dat;
StartComponent PortableComponent;
StartGroup "MyGroup",1,"DELL|MyGroup|001";
get SystemName;
printattribute SystemName,result;
EndGroup;
EndComponent;
endmapping;
The Shutdown command shuts down the system.
Connect 1.2.3.4;
Set Password,<password>;
ShutDown;
EndConnect;
NOTE: You must set the password if a password is installed. |
The WakeUp command performs a Wakeup On LAN operation.
WakeUp <IP Address>;
where:
<IP Address> is a valid IP address for the system for which you want to enable Wakeup On LAN.
You can use this command outside of the Connect/EndConnect block. For example:
WakeUp 1.2.3.4;
Connect 1.2.3.4;
Restart;
EndConnect;
NOTE: Commands and keywords are not case-sensitive. |
Connect @d:\itasstant2\bscript\debug\connect.dat;
get SystemName;
print result,lf;
get Dmi20sLocalSecurity;
print result,lf;
get HDDSizeAlert;
print result,lf;
mapping @d:\steyr2\bscript\debug\mif.dat;
StartComponent PortableComponent;
StartGroup "MyGroup",1,"DELL|MyGroup|001";
get SystemName;
printattribute SystemName,result;
EndGroup;
EndComponent;
endmapping;
endconnect;
connect local;
get systemclass;
print "System Class = ",result,lf;
get SERVICETAG;
print "Service Tag = ",result,lf;
get MACADDRESS;
print "MAC Address = ",result,lf;
get systemname;
print "System Name = ",result,lf;
get systemtype;
print "System Type = ",result,lf;
get processorname;
print "Processor Name = ",result,lf;
get biosversion;
print "BIOS Version = ",result,lf;
get memoryinstalled;
print "Memory Installed = ",result,lf;
get username;
print "User Name = ",result,lf;
get osversion;
print "Operating System Version = ",result,lf;
get processorspeed;
print "Processor Speed = ",result,lf;
get processorfamily;
print "Processor Family = ",result,lf;
get processorversion;
print "Processor Version = ",result,lf;
endconnect;