user-interface

Function

The user-interface command displays one or multiple user interface views.

Format

user-interface [ ui-type ] first-ui-number [ last-ui-number ]

Parameters

Parameter	Description	Value
ui-type	Specifies the type of a user interface. If the user interface is specified, the relative number is used. If the user interface is not specified, the absolute number is used.	The value can be console or VTY.
first-ui-number	Specifies the number of the first user interface.	If ui-type is set to console, the first-ui-number value is 0. If ui-type is set to vty, the first-ui-number value ranges from 0 to the maximum number of VTY user interfaces.
last-ui-number	Specifies the number of the last user interface. When you select this parameter, you enter multiple user interface views at the same time. This parameter is valid only when ui-type is set to VTY. The last-ui-number value must be larger than the first-ui-number number. If the maximum number of VTY users has been set using the user-interface maximum-vty command in the system view before ui-type is selected, the last-ui-number value is smaller than or equal to the maximum number of VTY user interfaces minus one.	-

Parameter

Description

Value

ui-type

Specifies the type of a user interface.

If the user interface is specified, the relative number is used.
If the user interface is not specified, the absolute number is used.

The value can be console or VTY.

first-ui-number

Specifies the number of the first user interface.

If ui-type is set to console, the first-ui-number value is 0.
If ui-type is set to vty, the first-ui-number value ranges from 0 to the maximum number of VTY user interfaces.

last-ui-number

Specifies the number of the last user interface. When you select this parameter, you enter multiple user interface views at the same time.

This parameter is valid only when ui-type is set to VTY. The last-ui-number value must be larger than the first-ui-number number.

If the maximum number of VTY users has been set using the user-interface maximum-vty command in the system view before ui-type is selected, the last-ui-number value is smaller than or equal to the maximum number of VTY user interfaces minus one.

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

When a network administrator logs in to a device using the console interface, Telnet, or SSH, the network administrator can set parameters, such as an authentication more and user level, on the user interface to allow the device to centrally manage user sessions.

Precautions

Only users at level 15 can use this command.

The user interface varies according to the login mode. The user interface views can be numbered using absolute numbers or relative numbers. Table 1 describes absolute and relative numbers of user interfaces.

The relative numbering uniquely specifies a user interface or a group of user interfaces of the same type.
The absolute numbering specifies a user interface or a group of user interfaces.

**Table 1** Absolute and relative numbers of user interfaces
User Interface	Description	Absolute Number	Relative Number
Console user interface	Manages and controls users who log in to the device using the console interface.	0	0
VTY user interface	Manages and controls users who log in to the device using Telnet or SSH.	34 to 48 and 50 to 54	The first one is VTY 0, the second one is VTY 1, and so forth. Absolute numbers 34 to 48 map relative numbers VTY 0 to VTY 14. Absolute numbers 50 to 54 map relative numbers VTY 16 to VTY 20. VTY 15 is reserved for the system. VTY 16 to VTY 20 are reserved for the NMS. Only when VTY 0 to VTY 14 are all used, AAA authentication is configured for users, VTY 16 to VTY 20 can be used.

After you log in to the device, you can run the display user-interface command to view the supported user interfaces and the corresponding relative and absolute numbers.

Example

# Enter the Console 0 user interface.

<HUAWEI> system-view

[HUAWEI] user-interface console 0

[HUAWEI-ui-console0]

# Enter the VTY 1 user interface.

<HUAWEI> system-view

[HUAWEI] user-interface vty 1

[HUAWEI-ui-vty1]

# Enter the VTY 1 to VTY 3 user interfaces.

<HUAWEI> system-view

[HUAWEI] user-interface vty 1 3

[HUAWEI-ui-vty1-3]