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.
The following table contains a subset of commands that can be used with the asu command.
Command | Description | Value |
---|---|---|
delete | Use this command to delete an instance or record of a setting. The setting must be an instance that allows deletion, for example, iSCSI.AttemptName.1. | setting_instance |
help | Use this command to display help information for one or more settings. | setting |
set | Use this command to change the value of a setting. Set the UEFI setting to the input value. Note
| setting value |
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. | setting |
show | Use this command to display the current value of one or more settings. | setting |
showvalues | Use this command to display all possible values for one or more settings. Note
| setting |
Note
|
Examples of the syntax for the asu command are presented in the following list:
- To display all of the asu command options enter asu --help.
- To display verbose help for all commands enter asu -v --help.
- To display verbose help for one command enter asu -v set --help.
- To change a value enter asu set setting value.
- To display the current value enter asu show setting.
- To display settings in long batch format enter asu show -l -b all
- To display all possible values for a setting enter asu showvalues setting.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>
The following table shows the arguments for the options.
Option | Description | Values |
---|---|---|
-b | Display in batch format. | |
--help1 | Display command usage and options. The --help option is placed before the command, for example asu --help show. | |
--help1 | Display help for the command. The --help option is placed after the command, for example, asu show --help. | |
-l | Long format setting name (include the configuration set). | |
-m | Mixed format setting name (use the configuration id). | |
-v2 | Verbose output. | |
|
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.
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