01-CLI命令
本章节下载: 01-CLI命令 (266.84 KB)
目 录
1.1.1 display [ | [ by-linenum ] { begin | exclude | include } ]
1.1.6 display history-command all
display [ | [ by-linenum ] { begin | exclude | include } ]命令用来使用正则表达式对显示信息进行过滤。
【命令】
display command [ | { count | [ by-linenum ] { begin | exclude | include } regular-expression &<1-128> } ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
command:命令关键字,取值可以通过输入?来获得。
[ | { count | [ by-linenum ] { begin | exclude | include } regular-expression &<1-128> } ]:指定显示信息的过滤规则,其中:
· count:统计display命令所查看显示信息的行数。仅R5212P01及以上版本支持本参数。
· by-linenum:表示带行号显示。当多次使用正则表达式对显示信息过滤时,by-linenum参数只需要输入一次即可生效。不指定该参数时,表示不带行号显示。
· begin:从包含正则表达式的行开始显示。
· exclude:只显示不包含正则表达式的行。
· include:只显示包含正则表达式的行。
· regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。
· &<1-128>:表示前面的参数最多可以输入128次。
【使用指导】
用display命令查看显示信息时,用户可以使用正则表达式来过滤显示信息,并标注行号,以便快速的定位自己关注的信息。关于正则表达式的详细描述请参考“基础配置指导”中的“CLI”。
如果输入多个过滤条件,则显示满足所有条件的信息。
行号占5个字符,通常行号后面接“:”。当by-linenum和begin参数一起使用时,行号后面还可能接“-”,其中“:”表示该行符合匹配规则,“-”表示该行不符合匹配规则。
【举例】
# 查看包含VLAN的配置。
<Sysname> display current-configuration | include vlan
vlan 1
vlan 999
port access vlan 999
# 显示日志缓冲区中包含SHELL字符串且包含VTY字符串的日志。
<Sysname> display logbuffer | include SEHLL | include VTY
%Feb 6 10:38:12:320 2020 Sysname SHELL/5/SHELL_LOGIN: VTY logged in from 169.254.100.171.
%Feb 6 10:52:32:576 2020 Sysname SHELL/5/SHELL_LOGOUT: VTY logged out from 169.254.100.171.
%Feb 6 16:03:27:100 2020 Sysname SHELL/5/SHELL_LOGIN: VTY logged in from 169.254.100.171.
%Feb 6 16:44:18:113 2020 Sysname SHELL/5/SHELL_LOGOUT: VTY logged out from 169.254.100.171.
# 查看当前配置,从包含“user-group”字符串的行开始到最后一行配置信息,并同时显示行号。(行号后为“:”表示该行包含“user-group”字符串,行号后为“-”表示该行不包含“user-group”字符串。)
<Sysname> display current-configuration | by-linenum begin user-group
114: user-group system
115- #
116- return
# 查看display current-configuration命令显示信息的行数。
<Sysname> display current-configuration | count
Total lines: 353
display | no-more命令用来配置display命令输出的显示信息不分屏。
【命令】
display command | no-more
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
command:命令关键字,取值可以通过输入?来获得。
【使用指导】
用display命令查看显示信息时,用户可以在输入完display命令后通过额外指定| no-more参数来使得display命令输出的显示信息不分屏。
本命令与display >以及display >>命令不能同时配置。
仅R5212P01及以上版本支持本命令。
【举例】
# 查看设备上所有已创建VLAN的概要信息,并且显示信息不分屏。
<Sysname> display vlan brief | no-more
Brief information about all VLANs:
Supported Minimum VLAN ID: 1
Supported Maximum VLAN ID: 4094
Default VLAN ID: 1
VLAN ID Name Port
1 VLAN 0001 BAGG1 BAGG77
2 VLAN 0002
3 VLAN 0003
4 VLAN 0004
5 VLAN 0005
6 VLAN 0006
7 VLAN 0007
8 VLAN 0008
9 VLAN 0009
10 VLAN 0010
11 VLAN 0011
12 VLAN 0012
13 VLAN 0013
14 VLAN 0014
15 VLAN 0015
16 VLAN 0016
17 VLAN 0017
18 VLAN 0018
19 VLAN 0019
20 VLAN 0020
21 VLAN 0021
22 VLAN 0022
23 VLAN 0023
display >命令用来将显示信息独立保存到文件。
【命令】
display command > filename
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
command:命令关键字,取值可以通过输入?来获得。
filename:文件名称,为1~63个字符的字符串。
【使用指导】
display命令显示的内容通常是统计信息、功能是否使能以及功能的相关参数配置,这些信息在设备运行过程中会随着时间或者用户的配置而改变。使用本命令可以将当前显示信息保存到文件,可供用户随时比对和查看。
执行本命令时,如果filename不存在,系统会先创建该文件,再保存;如果filename已存在,则会覆盖原文件的内容。
【举例】
# 将display vlan 1的显示信息保存到文件vlan.txt。
<Sysname> display vlan 1 > vlan.txt
查看vlan.txt的内容,验证display >命令的执行效果。
<Sysname> more vlan.txt
VLAN ID: 1
VLAN type: Static
Route interface: Not configured
Description: VLAN 0001
Name: VLAN 0001
Tagged ports: None
Untagged ports:
HundredGigE1/0/2
display >>命令用来将显示信息以追加方式保存到文件。
【命令】
display command >> filename
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
command:命令关键字,取值可以通过输入?来获得。
filename:文件名称,为1~63个字符的字符串。
【使用指导】
display命令显示的内容通常是统计信息、功能是否使能以及功能的相关参数配置,这些信息在设备运行过程中会随着时间或者用户的配置而改变。使用本命令可以将当前显示信息保存到文件,可供用户随时比对和查看。
执行本命令时,如果filename不存在,系统会先创建该文件,再保存。如果filename已存在,则新保存的内容会追加到文件filename的尾部。
【举例】
# 将display vlan 999的显示信息以追加方式保存到文件vlan.txt。
<Sysname> display vlan 999 >> vlan.txt
查看vlan.txt的内容,验证display >>命令的执行效果。
<Sysname> more vlan.txt
VLAN ID: 1
VLAN type: Static
Route interface: Not configured
Description: VLAN 0001
Name: VLAN 0001
Tagged ports: None
Untagged ports:
HundredGigE1/0/2
VLAN ID: 999
VLAN type: Static
Route interface: Configured
IPv4 address: 192.168.2.1
IPv4 subnet mask: 255.255.255.0
Description: For LAN Access
Name: VLAN 0999
Tagged ports: None
Untagged ports:
HundredGigE1/0/2
display history-command命令用来显示当前登录用户历史命令缓冲区中的命令。
【命令】
display history-command
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【使用指导】
用户登录设备后,系统会给每个用户自动分配一个历史命令缓冲区,用于存放用户本次登录成功执行的命令行,以便用户查看和调用。历史命令缓存区有大小限制,缺省保存10条命令,用户也可以通过history-command max-size命令来修改大小。当数目达到上限时,系统会自动删除最早的记录,来保存最新成功执行的命令。
如果用户退出登录,系统会自动清除该历史命令缓存区的所有记录。
如果历史命令缓冲区中存在密码配置命令,为提高设备安全性,密码会被显示为******。
【举例】
# 显示历史命令缓存区内保存的命令。
<Sysname> display history-command
system-view
vlan 2
quit
【相关命令】
· history-command max-size(基础配置命令参考/登录设备)
display history-command all命令用来显示所有登录用户历史命令缓冲区中的命令。
【命令】
display history-command all
【视图】
任意视图
【缺省用户角色】
network-admin
【使用指导】
系统中有一个共享历史命令缓冲区,用于存放所有登录用户成功执行的命令行,以便用户查看(不能调用)。历史命令缓存区的大小固定为1024条,不可配置。当数目达到上限时,系统会自动删除最早的记录,来保存最新成功执行的命令。
即便用户退出登录,系统也不会清除共享历史命令缓存区中该用户的历史命令记录。
如果历史命令缓冲区中存在密码配置命令,为提高设备安全性,密码会被显示为******。
【举例】
# 显示所有登录用户成功执行的历史命令。
<Sysname> display history-command all
Date Time Terminal Ip User
02/16/2020 20:03:33 vty0 192.168.1.26 **
Cmd:dis his all
02/16/2020 20:03:29 vty0 192.168.1.26 **
Cmd:sys
表1-1 display history-command all命令显示信息描述表
字段 |
描述 |
Date |
执行命令行的日期 |
Time |
执行命令行的时间 |
Terminal |
执行命令的用户使用的登录用户线 |
Ip |
执行命令的用户使用的登录IP |
User |
如果用户使用scheme方式登录设备,该字段显示为执行命令的用户使用的登录用户名;如果使用其他方式登录设备,该字段显示为** |
Cmd |
执行的命令(和用户的输入保持一致) |
【相关命令】
· display history-command
display hotkey命令用来显示系统支持的快捷键及其含义。
【命令】
display hotkey
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【举例】
# 显示系统支持的快捷键及其含义。
<Sysname> display hotkey
----------------- Hotkeys -----------------
-Defined function hotkeys-
CTRL_A Move the cursor to the beginning of the line.
CTRL_B Move the cursor one character to the left.
CTRL_C Stop the current command.
CTRL_D Erase the character at the cursor.
CTRL_E Move the cursor to the end of the line.
CTRL_F Move the cursor one character to the right.
CTRL_H Erase the character to the left of the cursor.
CTRL_K Abort the connection request.
CTRL_N Display the next command in the history buffer.
CTRL_P Display the previous command in the history buffer.
CTRL_R Redisplay the current line.
CTRL_V Paste text from the clipboard.
CTRL_W Delete the word to the left of the cursor.
CTRL_X Delete all characters from the beginning of the line to the cursor.
CTRL_Y Delete all characters from the cursor to the end of the line.
CTRL_Z Return to the User View.
CTRL_] Kill incoming connection or redirect connection.
ESC_B Move the cursor back one word.
ESC_D Delete all characters from the cursor to the end of the 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_< Move the cursor to the beginning of the clipboard.
ESC_> Move the cursor to the end of the clipboard.
-Defined command hotkeys-
CTRL_G display current-configuration
CTRL_L display ip routing-table
CTRL_O undo debugging all
-Undefined hotkeys-
CTRL_T NULL
CTRL_U NULL
表1-2 display hotkey命令显示信息描述表
字段 |
描述 |
Defined function hotkeys |
已定义的绑定功能的快捷键 |
Defined command hotkeys |
已定义的绑定命令的快捷键 |
Undefined hotkeys |
未定义的快捷键 |
关于各快捷键绑定的功能或命令的详细介绍请参见表1-3。
【相关命令】
· hotkey
hotkey命令用来修改快捷键的绑定关系。
undo hotkey命令用来恢复缺省情况。
【命令】
hotkey hotkey { command | function function | none }
undo hotkey hotkey
【缺省情况】
设备支持29个快捷键,各快捷键的缺省绑定关系如表1-3所示。
快捷键 |
缺省绑定的功能或命令 |
CTRL_A |
move_the_cursor_to_the_beginning_of_the_line,表示将光标移动到当前行的开头 |
CTRL_B |
move_the_cursor_one_character_to_the_left,表示将光标向左移动一个字符 |
CTRL_C |
stop_the_current_command,表示停止当前正在执行的功能 |
CTRL_D |
erase_the_character_at_the_cursor,表示删除当前光标所在位置的字符 |
CTRL_E |
move_the_cursor_to_the_end_of_the_line,表示将光标移动到当前行的末尾 |
CTRL_F |
move_the_cursor_one_character_to_the_right,表示将光标向右移动一个字符 |
CTRL_G |
display current-configuration,表示显示当前配置 |
CTRL_H |
erase_the_character_to_the_left_of_the_cursor,表示删除光标左侧的一个字符 |
CTRL_K |
abort_the_connection_request,表示终止呼出的连接 |
CTRL_L |
display ip routing-table,表示显示IPv4路由表信息 |
CTRL_N |
display_the_next_command_in_the_history_buffer,表示显示历史缓冲区中的下一条命令(密码配置命令会跳过) |
CTRL_O |
undo debugging all,表示关闭所有功能项的调试开关 |
CTRL_P |
display_the_previous_command_in_the_history_buffer,表示显示历史缓冲区中的上一条命令(密码配置命令会跳过) |
CTRL_R |
redisplay_the_current_line,表示重新显示当前行信息 |
CTRL_T |
未绑定任何命令行或功能 |
CTRL_U |
未绑定任何命令行或功能 |
CTRL_V |
paste_text_from_the_clipboard,表示粘贴剪贴板的内容 |
CTRL_W |
delete_the_word_to_the_left_of_the_cursor,表示删除光标左侧连续字符串内的所有字符 |
CTRL_X |
delete_all_characters_from_the_beginning_of_the_line_to_the_cursor,表示删除光标左侧所有的字符 |
CTRL_Y |
delete_all_characters_from_the_cursor_to_the_end_of_the_line,表示删除光标所在位置及其右侧所有的字符 |
CTRL_Z |
return_to_the_User_View,表示退回到用户视图 |
CTRL_] |
kill_incoming_connection_or_redirect_connection,表示终止当前连接 |
ESC_B |
move_the_cursor_back_one_word,表示将光标移动到左侧连续字符串的首字符处 |
ESC_D |
delete_all_characters_from_the_cursor_to_the_end_of_the_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_< |
move_the_cursor_to_the_beginning_of_the_clipboard,表示将光标所在位置指定为剪贴板的开始位置 |
ESC_> |
move_the_cursor_to_the_end_of_the_clipboard,表示将光标所在位置指定为剪贴板的结束位置 |
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
hotkey:需要绑定的快捷键。必须为设备支持的快捷键,取值请参见表1-3,或执行hotkey ?命令,帮助出该参数的取值。
command:快捷键绑定的命令行。必须为设备上可成功执行的命令行。
function:快捷键绑定的功能。执行hotkey hotkey function ?命令,可以帮助出该参数的取值,关于各值的含义请参见表1-3。
none:取消指定快捷键的绑定关系。配置该参数后,该快捷键将不绑定任何命令和功能。
【使用指导】
为方便用户快捷操作设备,设备支持29个快捷键,用户可以修改除“CTRL_]”外的28个快捷键的绑定关系。用户按下快捷键后,设备会立即执行对应的命令行或者功能。如果这些快捷键和用户登录终端定义的快捷键冲突,或者不符合用户的使用习惯,用户可使用该命令重新定义快捷键,甚至取消快捷键的绑定关系。
一个快捷键对应一个命令或功能,如果使用本命令多次定义同一快捷键,则最新配置生效。如果多次使用本命令将多个快捷键和同一命令、功能绑定,则这些绑定的快捷键均生效。
当用户使用终端软件与设备进行交互时,如果终端软件定义快捷键(包括用户可定义和系统定义快捷键),则快捷键会遵从终端软件的定义。
【举例】
# 将快捷键<Ctrl+U>和功能“将光标移动到当前行的开头”绑定。
<Sysname> system-view
[Sysname] hotkey ctrl_u function move_the_cursor_to_the_beginning_of_the_line
# 取消快捷键<Ctrl+A>的绑定关系。
<Sysname> system-view
[Sysname] hotkey ctrl_a none
【相关命令】
· display hotkey
quit命令用来使用户从当前视图退回到上一层视图。
【命令】
quit
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【使用指导】
如果当前是用户视图,执行quit后,会断开当前连接,退出系统。
【举例】
# 从接口HundredGigE1/0/1视图退回到系统视图,再退回到用户视图。
[Sysname-HundredGigE1/0/1] quit
[Sysname] quit
<Sysname>
repeat命令用来重复执行历史记录命令。
【命令】
repeat [ number ] [ count times ] [ delay seconds ]
【视图】
任意视图
【缺省用户角色】
network-admin
【参数】
number:表示重复执行历史命令的条数,取值范围为1~256,缺省值为1。
count times:表示重复执行历史命令的次数,取值范围为0~4294967295,缺省值为0。如不指定该参数,则历史命令一直重复执行,直到执行用户线视图下设置的终止当前运行任务的快捷键才能停止执行该命令,默认的终止快捷键为<Ctrl+C>。关于终止当前执行任务的快捷键的设置,请参见“基础配置命令”中的“登录设备”。
delay seconds:表示重复执行历史命令的时间间隔,取值范围为0~4294967295,单位为秒,缺省值为1。
【使用指导】
重复执行历史命令时,系统将按照历史命令的下发顺序执行。例如,用户在某视图下依次执行命令a、b和c后,再执行repeat 3命令,则系统将按照a、b和c的顺序重复执行。
如果用户重复执行的历史命令中存在交互式命令,需要用户手动处理此交互式命令,直到交互式命令执行结束,历史命令才会继续被重复执行。
如果用户重复执行的历史命令中存在密码配置命令,系统会跳过密码配置命令。
实际重复执行历史命令的条数取如下三者的最小值:
· 通过repeat命令设置的重复执行历史记录命令的条数;
· 通过history-command max-size命令设置当前用户线下最大可以存储的历史命令的条数;
· 当前实际存在的历史命令的条数。
【举例】
# 重复执行最近2条历史命令display cpu-usage和display clock,重复执行3次,时间间隔10秒。
<Sysname> repeat 2 count 3 delay 10
<Sysname> display cpu-usage
Slot 1 CPU 0 CPU usage:
33% in last 5 seconds
32% in last 1 minute
33% in last 5 minutes
<Sysname> display clock
07:02:18.230 UTC Thu 02/19/2020
<Sysname> display cpu-usage
Slot 1 CPU 0 CPU usage:
33% in last 5 seconds
32% in last 1 minute
33% in last 5 minutes
<Sysname> display clock
07:02:28.263 UTC Thu 02/19/2020
<Sysname> display cpu-usage
Slot 1 CPU 0 CPU usage:
33% in last 5 seconds
32% in last 1 minute
33% in last 5 minutes
<Sysname> display clock
07:02:38.293 UTC Thu 02/19/2020
【相关命令】
· display history-command
· escape-key(基础配置命令参考/登录设备)
· history-command max-size(基础配置命令参考/登录设备)
return命令用来从当前视图(除Tcl配置视图和Python shell外的任意非用户视图)直接退回到用户视图。
【命令】
return
【视图】
除Tcl配置视图和Python shell外的任意非用户视图
【缺省用户角色】
network-admin
network-operator
【使用指导】
用户也可以使用组合键<Ctrl+Z>从当前视图(除Tcl配置视图和Python shell外的任意非用户视图)直接退回到用户视图,效果等同于执行return命令。
Tcl配置视图和Python shell下退回到用户视图的方式分别为:
· Tcl配置视图下请使用tclquit返回用户视图。
· 在Python shell下请通过执行exit()命令,从Python shell退回到用户视图。
【举例】
# 从接口HundredGigE1/0/1视图退回到用户视图。
[Sysname-HundredGigE1/0/1] return
<Sysname>
screen-length disable命令用来关闭当前用户的分屏显示功能。
undo screen-length disable命令用来开启当前用户的分屏显示功能。
【命令】
screen-length disable
undo screen-length disable
【缺省情况】
用户登录后将遵循用户线下的screen-length设置。screen-length设置的缺省情况为:允许分屏显示,下一屏显示24行数据。
【视图】
用户视图
【缺省用户角色】
network-admin
【使用指导】
在收集信息时建议关闭分屏显示功能,分屏显示功能处于关闭状态时,会一次显示所有信息,查看信息时,不建议关闭分屏显示功能,如果信息较多,则会连续刷屏,不方便立即查看。
该配置只对当前用户本次登录有效,用户重新登录后将恢复到缺省情况。
【举例】
# 关闭当前用户的分屏显示功能。
<Sysname> screen-length disable
【相关命令】
· screen-length (基础配置命令参考/登录设备)
system-view命令用来从用户视图进入系统视图。
【命令】
system-view [ exclusive | immediate | private ]
【视图】
用户视图
【缺省用户角色】
network-admin
network-operator
【参数】
exclusive:表示进入独占模式系统视图。同时只有一个用户可以进入独占模式系统视图,仅该用户可以下发目标配置。
immediate:表示进入实时生效模式系统视图。进入该视图及其子视图后,输入命令行并回车,该命令立即下发。
private:表示进入私有模式系统视图。多个用户可以同时进入私有模式系统视图并进行配置,有用户进入私有模式系统视图的同时,也可以有用户进入实时生效模式系统视图,但是同一时刻只能有一个用户下发配置。
【使用指导】
根据视图下的配置是否立即下发,设备的系统视图分为两大类:
· 实时生效模式系统视图:进入该视图及其子视图后,输入命令行并回车,该命令立即下发。
· 非实时生效模式系统视图:进入该视图及其子视图后,输入命令行并回车,命令行不会立即下发,只有执行commit命令后,所有配置一起下发并生效。关于commit命令的详细介绍,请参见“基础配置命令参考”中的“目标配置管理”;进入该视图及其子视图后,命令提示符将以“~”开头,用以提示用户当前视图为非实时生效模式系统视图。根据是否允许多个用户并发配置设备,该视图又分为两类:
¡ 独占模式系统视图:同时只有一个用户可以进入独占模式系统视图。当有用户进入独占模式系统视图时,其他用户可以进入私有模式系统视图或者实时生效模式系统视图,但仅进入独占模式系统视图的用户可以下发配置。
¡ 私有模式系统视图:多个用户可以同时进入私有模式系统视图并进行配置,有用户进入私有模式系统视图的同时,也可以有用户进入实时生效模式系统视图,但是同一时刻只能有一个用户下发配置。
Comware V9手册中,如无特殊说明,进入“系统视图”均指进入“实时生效模式系统视图”。
【举例】
# 从用户视图进入独占模式系统视图。
<Sysname> system-view exclusive
Info: The current configuration is locked.
~[Sysname]
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!