Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 01-CLI configuration commands | 130.79 KB |
command-alias enable
Use command-alias enable to enable the command keyword alias function.
Use undo command-alias enable to disable the command keyword alias function.
Syntax
command-alias enable
undo command-alias enable
Default
The command keyword alias function is disabled.
Views
System view
Default command level
2: System level
Usage guidelines
Disabling the command keyword alias function does not delete the configured aliases, but the aliases do not take effect anymore.
Examples
# Enable the command keyword alias function.
<Sysname> system-view
[Sysname] command-alias enable
# Disable the command keyword alias function.
<Sysname> system-view
[Sysname] undo command-alias enable
Related commands
command-alias mapping
command-alias mapping
Use command-alias mapping to configure a command keyword alias.
Use undo command-alias mapping to delete a command keyword alias.
Syntax
command-alias mapping cmdkey alias
undo command-alias mapping cmdkey
Default
A command keyword has no alias.
Views
System view
Default command level
2: System level
Parameters
cmdkey: Specifies the complete form of the first keyword of a non-undo command, or the second keyword of an undo command.
alias: Specifies an alias for the keyword. It must be different from the first keyword of any non-undo command.
Usage guidelines
Command keyword aliases take effect only after you enable the command keyword alias function.
Examples
# Define show as the alias of the display keyword.
<Sysname> system-view
[Sysname] command-alias mapping display show
After you configure the alias, you can enter show to execute a display command. For example, you can enter show clock to execute the display clock command.
# Delete the alias of the display keyword.
<Sysname> system-view
[Sysname] undo command-alias mapping display
command-privilege
Use command-privilege to assign a level for a specific command in a view.
Use undo command-privilege to restore the default.
Syntax
command-privilege level level view view command
undo command-privilege view view command
Default
Each command in a view has a specified level.
Views
System view
Default command level
3: Manage level
Parameters
level level: Specifies a command level in the range of 0 to 3.
view view: Specifies a view.
command: Specifies a command in the specified view.
Usage guidelines
Command levels include four privileges: visit (0), monitor (1), system (2), and manage (3). You can assign a privilege level according to the user's need. When logging in to the device, the user can access the assigned level and all levels below it.
Improper use of this command can cause maintenance, operation, and security problems. Make sure you understand the impact of this command on your network before you use it.
The command specified for the command-privilege command must be complete, and have valid parameters. For example, the default level of the tftp server-address { get | put | sget } source-filename [ destination-filename ] [ source { interface interface-type interface-number | ip source-ip-address } ] command is 3. To enable users with the privilege level 0 to execute the tftp server-address put source-filename command (such as tftp 192.168.1.26 put syslog.txt) and disable them from specifying the get, sget, source, or destination-filename option, configure the command-privilege level 0 view shell tftp 1.1.1.1 put a.cfg command.
The command specified for the undo command-privilege view command can be incomplete. For example, configuring the undo command-privilege view system ftp command restores all commands starting with ftp (such as ftp server acl, ftp server enable, and ftp timeout) to their default levels. If you have modified the level of commands ftp server enable and ftp timeout, and you want to restore only the ftp server enable command to its default level, use the undo command-privilege view system ftp server command.
If you change the command level of a command in a specified view from the default command level to a lower level, you must change the command levels of the quit command and the command used to enter this view. For example, the default command level of commands interface and system-view is 2 (system level). To make the interface command available to the level 1 users, execute the following commands: command-privilege level 1 view shell system-view, command-privilege level 1 view system interface gigabitethernet1/0/1, and command-privilege level 1 view system quit. Then, the level 1 users can enter system view, execute the interface gigabitethernet command, and return to user view.
Examples
# Set the command level of the interface command to 0 in system view.
[Sysname] command-privilege level 0 view system interface
display clipboard
Use display clipboard to display data in the clipboard.
Syntax
display clipboard [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
To copy some content to the clipboard:
1. Move the cursor to the starting position of the content, and then press the Esc+Shift+, combination.
2. Move the cursor to the ending position of the content, and then press the Esc+Shift+. combination.
Examples
# Display data in the clipboard.
<Sysname> display clipboard
---------------- CLIPBOARD-----------------
display current-configuration
display command-alias
Use display command-alias to display the command keyword alias configuration.
Syntax
display command-alias [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display the command keyword alias configuration.
<Sysname> display command-alias
Command alias is enabled
index alias command key
1 show display
display history-command
Use display history-command to display commands saved in the command history buffer.
Syntax
display history-command [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
By default, the system can save up to 10 commands in the buffer. You can use the history-command max-size command to change the buffer size.
Examples
# Display all commands saved in the command history buffer.
<Sysname> display history-command
display history-command
system-view
vlan 2
quit
display hotkey
Use display hotkey to display hotkey information.
Syntax
display hotkey [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display hotkey information.
<Sysname> display hotkey
----------------- HOTKEY -----------------
=Defined hotkeys=
Hotkeys Command
CTRL_G display current-configuration
CTRL_L display ip routing-table
CTRL_O undo debug all
=Undefined hotkeys=
Hotkeys Command
CTRL_T NULL
CTRL_U NULL
=System hotkeys=
Hotkeys Function
CTRL_A Move the cursor to the beginning of the current line.
CTRL_B Move the cursor one character left.
CTRL_C Stop current command function.
CTRL_D Erase current character.
CTRL_E Move the cursor to the end of the current line.
CTRL_F Move the cursor one character right.
CTRL_H Erase the character left of the cursor.
CTRL_K Kill outgoing connection.
CTRL_N Display the next command from the history buffer.
CTRL_P Display the previous command from the history buffer.
CTRL_R Redisplay the current line.
CTRL_V Paste text from the clipboard.
CTRL_W Delete the word left of the cursor.
CTRL_X Delete all characters up to the cursor.
CTRL_Y Delete all characters after the cursor.
CTRL_Z Return to the User View.
CTRL_] Kill incoming connection or redirect connection.
ESC_B Move the cursor one word back.
ESC_D Delete remainder of word.
ESC_F Move the cursor forward one word.
ESC_N Move the cursor down a line.
ESC_P Move the cursor up a line.
ESC_< Specify the beginning of clipboard.
ESC_> Specify the end of clipboard.
hotkey
Use hotkey to assign a command to a configurable hotkey.
Use undo hotkey to restore the default.
Syntax
hotkey { CTRL_G | CTRL_L | CTRL_O | CTRL_T | CTRL_U } command
undo hotkey { CTRL_G | CTRL_L | CTRL_O | CTRL_T | CTRL_U }
Default
· Ctrl_G: display current-configuration (display the running configuration).
· Ctrl_L: display ip routing-table (display the IPv4 routing table information).
· Ctrl_O: undo debugging all (disable all debugging functions).
· Ctrl_T: No command is assigned to this hotkey.
· Ctrl_U: No command is assigned to this hotkey.
Views
System view
Default command level
2: System level
Parameters
CTRL_G: Assigns a command to Ctrl+G.
CTRL_L: Assigns a command to Ctrl+L.
CTRL_O: Assigns a command to Ctrl+O.
CTRL_T: Assigns a command to Ctrl+T.
CTRL_U: Assigns a command to Ctrl+U.
command: Specifies the command to be assigned to the hotkey.
Examples
# Assign the display tcp status command to the hotkey Ctrl+T.
<Sysname> system-view
[Sysname] hotkey ctrl_t display tcp status
quit
Use quit to return to the upper-level view.
Syntax
quit
Views
Any view
Default command level
0: Visit level (executed in user view)
2: System level (executed in other views)
Usage guidelines
Executing this command in user view disconnects you from the device.
Examples
# Return from GigabitEthernet 1/0/1 interface view to system view and then to user view.
[Sysname-GigabitEthernet1/0/1] quit
[Sysname] quit
<Sysname>
return
Use return to return to user view from any other view. Pressing Ctrl+Z has the same effect.
Syntax
return
Views
Any view except user view
Default command level
2: System level
Examples
# Return to user view from GigabitEthernet 1/0/1 interface view.
[Sysname-GigabitEthernet1/0/1] return
<Sysname>
Related commands
quit
screen-length disable
Use screen-length disable to disable pausing between screens of output for the current session.
Use undo screen-length disable to enable pausing between screens of output for the current session.
Syntax
screen-length disable
undo screen-length disable
Default
A login user uses the settings of the screen-length command. The default settings of the screen-length command are: pausing between screens of output and displaying up to 24 lines on a screen.
Views
User view
Default command level
1: Monitor level
Usage guidelines
When the screen pause function is disabled, all output is displayed at one time and the screen is refreshed continuously.
This command only takes effect for the current session. When you log out, the setting by this command is restored to the default.
Examples
# Disable pausing between screens of output for the current session.
<Sysname> screen-length disable
Related commands
screen-length
super
Use super to switch from the current user privilege level to a specified user privilege level.
Syntax
super [ level ]
Views
User view
Default command level
0: Visit level
Parameters
level: Specifies a user level in the range of 0 to 3. The default is 3.
Usage guidelines
If a level is not specified, the command switches the user privilege level to 3.
There are four user privilege levels: visit (0), monitor (1), system (2), and manage (3). You can assign different privilege levels to different users. After login, a user can access the commands at or under the assigned level.
A user can switch to a lower privilege level unconditionally. To switch to a higher privilege level, an AUX user interface user does not need to provide any password, but a VTY user must enter the switching password set with the super password command. If the entered password is incorrect or no password is configured for switching to the level, the switching operation fails.
Examples
# Switch to user privilege level 2 from user privilege level 3.
<Sysname> super 2
User privilege level is 2, and only those commands can be used
whose level is equal or less than this.
Privilege note: 0-VISIT, 1-MONITOR, 2-SYSTEM, 3-MANAGE
# Switch back to user privilege level 3. (Suppose the switching password is 123. If no password is set, users cannot switch to user privilege level 3.)
<Sysname> super 3
Password:
User privilege level is 3, and only those commands can be used
whose level is equal or less than this.
Privilege note: 0-VISIT, 1-MONITOR, 2-SYSTEM, 3-MANAGE
Related commands
· super password
· super authentication-mode
super authentication-mode
Use super authentication-mode to set the authentication mode for user privilege level switching.
Use undo super authentication-mode to restore the default.
Syntax
super authentication-mode { local | scheme } *
undo super authentication-mode
Default
The authentication mode for the user privilege level switching is local.
Views
System view
Default command level
2: System level
Parameters
local: Uses the local password set with the super password command for user privilege level switching authentication. If no password is set with the command, the system allows an AUX interface user to change the privilege level without authentication, but denies the switching requests of VTY users.
scheme: Uses AAA for user privilege level switching authentication. For more information about AAA, see Security Configuration Guide.
local scheme: Uses the local password, if configured, for user privilege level switching authentication. If the password is not configured, the system allows an AUX interface user to change the privilege level but uses AAA to authenticate VTY users.
scheme local: Uses AAA for user privilege level switching authentication. If the AAA configuration is incomplete or invalid or the server does not respond, the system uses the local password for the authentication.
Examples
# Set the authentication mode for the user privilege level switching to local.
<Sysname> system-view
[Sysname] super authentication-mode local
# Set the authentication mode for the user privilege level switching to scheme local.
<Sysname> system-view
[Sysname] super authentication-mode scheme local
Related commands
super password
super password
Use super password to set the password used to switch from the current user privilege level to a higher one.
Use undo super password to restore the default.
Syntax
super password [ level user-level ] [ hash ] { cipher | simple } password
undo super password [ level user-level ]
Default
No password is set for switching to a higher privilege level.
Views
System view
Default command level
2: System level
Parameters
level user-level: Specifies a user privilege level in the range of 1 to 3. The default is 3.
hash: Uses a hash algorithm to encrypt the password.
cipher: Sets a ciphertext password.
simple: Sets a plaintext password.
password: Specifies the password string. This argument is case sensitive. If simple is specified, it must be a string of 1 to 16 characters. If you specify the hash keyword, the ciphertext password can be a string of 1 to 110 characters. If you do not specify the hash keyword, the ciphertext password can be a string of 1 to 53 characters..
Usage guidelines
Whether you specify the cipher or simple keyword, the password is saved in cipher text in the configuration file.
You cannot configure the super password [ level user-level ] hash cipher command when the password-control enable command is configured.
Examples
# Use the password abc in plain text to authenticate a user switching to privilege level 3.
<Sysname> system-view
[Sysname] super password level 3 simple abc
system-view
Use system-view to enter system view from user view.
Syntax
system-view
Views
User view
Default command level
2: System level
Examples
# Enter system view from user view.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname]
Related commands
· quit
· return
