asu command

This command is used to configure UEFI settings.

Advanced Settings Utility commands (ASU) are used to configure UEFI settings. The host system must be rebooted for any UEFI setting changes to take effect.

Syntax:

asu [subset_command]

Table 1. asu subset commands
Command	Description	Value
help	Use this command to display help information for one or more settings.	setting_name
set	Use this command to change the value of a setting. Set the UEFI setting to the input value. Note Set one or more setting/value pairs. The setting can contain wildcards if it expands to a single setting. The value must be enclosed in quotes if it contains spaces. Ordered list values are separated by the equal symbol (=). For example, set B*.Bootorder "CD/DVD Rom=Hard Disk 0=PXE Network."	setting_name=value
show	Use this command to display the current value of one or more settings.	setting_name
showvalues	Use this command to display all possible values for one or more settings. Note This command will display information about the allowable values for the setting. The minimum and maximum number of instances allowed for the setting is displayed. The default value will be displayed if available. The default value is enclosed with opening and closing angle brackets (< and >). Text values show the minimum and maximum length and regular expression.	setting_name
showgroups	Use this command to display the available setting groups. This command displays the names of known groups. Group names may vary depending on the installed devices.
Note In the command syntax, setting_name is the name of a setting that you want to view or change, and value is the value that you are placing on the setting. setting_name can be more than one name, except when using the set command. setting_name can contain wildcards, for example an asterisk () or a question mark (?). setting_name* can be a group, a setting name, or all.

Examples:

To display all of the asu command options enter asu help.
To display help for one command enter asu help setting_name.
To change a value enter asu set setting_name=value.
To display the current value enter asu show setting_name.

To display all possible values for a setting enter asu showvalues setting_name.

Example show values command:

system> asu showvalues S*.POST*
SystemRecovery.POSTWatchdogTimer==<Disable>=Enable
SystemRecovery.POSTWatchdogTimerValue=numeric min=5 max=20 step=1 default=5
system>

To display the available setting groups enter asu showgroups.

The following table shows the arguments for the options.

Table 2. asu options
Option	Description
-b	Display in batch format.
-help¹	Display command usage and options. The -help option is placed before the command, for example asu -help show.
-l	Long format setting name (include the configuration set).
-m	Mixed format setting name (use the configuration id).
-v²	Verbose output.
The -help option can be used with any command. The -v option is used only between asu and the command.

Syntax:

asu [-options] command [cmdopts]
options:
   -v verbose output
   -help display main help
cmdopts:
   -help help for the command

Note

See individual commands for more command options.

Use the asu transaction commands to set multiple UEFI settings and create and execute batch mode commands. Use the tropen and trset commands to create a transaction file containing multiple settings to be applied. A transaction with a given id is opened using the tropen command. Settings are added to the set using the trset command. The completed transaction is committed using the trcommit command. When you are finished with the transaction, it can be deleted with the trrm command.

Note

The UEFI settings restore operation will create a transaction with an id using a random three digit number.

The following table contains transaction commands that can be used with the asu command.

Table 3. asu transaction commands. The following table is a multi-row three column table consisting of the transactions commands, the command descriptions, and associated values for the commands.
Command	Description	Value
tropen id	This command creates a new transaction file containing several settings to be set.	Id is the identifying string, 1 - 3 alphanumeric characters.
trset id	This command adds one or more settings or value pairs to a transaction.	Id is the identifying string, 1 - 3 alphanumeric characters.
trlist id	This command displays the contents of the transaction file first. This can be useful when the transaction file is created in the CLI shell.	Id is the identifying string, 1 - 3 alphanumeric characters.
trcommit id	This command commits and executes the contents of the transaction file. The results of the execution and any errors will be displayed.	Id is the identifying string, 1 - 3 alphanumeric characters.
trrm id	This command removes the transaction file after it has been committed.	Id is the identifying string, 1 - 3 alphanumeric characters.

Example of establishing multiple UEFI settings:

asu tropen TR1
asu trset TR1 UEFI.BootModes.SystemBootMode "UEFI and Legacy"
asu trset TR1 BootOrder.BootOrder "CD/DVD Rom=Hard Disk 0=PXE Network"
asu trset TR1 BootOrder.WolBootOrder "CD/DVD Rom=Hard Disk 0=PXE Network"
asu trset TR1 UEFI.DevicesandIOPorts.Com1BaudRate 115200
asu trset TR1 UEFI.DevicesandIOPorts.Com1DataBits 8
asu trset TR1 UEFI.DevicesandIOPorts.Com1FlowControl Disable
asu trset TR1 UEFI.DevicesandIOPorts.Com1Parity None
asu trset TR1 UEFI.DevicesandIOPorts.Com1StopBits 1
asu trset TR1 UEFI.DevicesandIOPorts.COMPort1 Enable
asu trcommit TR1

Give documentation feedback