01-CLI命令
本章节下载: 01-CLI命令 (229.42 KB)
alias命令用来为命令或命令字符串配置别名。
undo alias命令用来取消相应配置。
【命令】
alias alias command
undo alias alias
【缺省情况】
系统为部分常用命令定义了缺省别名,如表1-1所示。
缺省别名 |
命令 |
access-list |
acl |
end |
return |
erase |
delete |
exit |
quit |
hostname |
sysname |
logging |
info-center |
no |
undo |
show |
display |
write |
save |
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
alias:表示命令的别名,为1~20个字符的字符串,区分大小写。别名不能为“alias”,也不能包含空格。
command:表示配置别名的命令,可以为任意字符串。请用户保证该命令字符串能够被设备识别并执行,否则执行别名命令时将会失败。
【使用指导】
系统定义的缺省别名无法取消。
通过本命令用户可以为命令行指定一个或多个别名,也可以为命令行开头的一个或多个关键字配置多个别名,使其符合用户的使用习惯。
本命令可以为某条命令行配置别名,当执行该命令时可以直接使用别名以简化输入。例如将命令display ip routing-table的别名配置为shiprt,当需要使用display ip routing-table查看设备生效的配置时,直接输入shiprt即可。
本命令可以为命令行起始的一个或多个关键字配置别名,使其更符合用户习惯。所有使用该关键字开头的命令行都可以使用别名命令来执行。例如,为display ip命令定义的别名为ship,在使用所有以display ip关键字开头的命令行时,都可以使用ship进行配置。例如:
· 输入ship routing-table可以执行命令display ip routing-table。
· 输入ship interface可以执行命令display ip interface。
配置别名时,可以使用$n表示命令行中的参数或者关键字,这样既可以用别名替代部分关键字来简化输入,又可以根据实际需要指定不同的参数或者关键字,增加了灵活性。$n最多可以使用9次,n为1~9的整数,表示参数或关键字出现的顺序。比如,将命令display ip $1 | include $2的别名配置为shinc后,如果需要执行display ip routing-table | include Static命令来筛选并查看路由表中的所有静态路由信息,可直接执行shinc routing-table Static;同样如果需要执行display ip interface | include GigabitEthernet1/0/1,则可直接执行shinc interface GigabitEthernet1/0/1。
【举例】
# 配置命令display ip routing-table的别名为shiprt。
<Sysname> system-view
[Sysname] alias shiprt display ip routing-table
[Sysname] shiprt
Destinations : 13 Routes : 13
Destination/Mask Proto Pre Cost NextHop Interface
0.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0
3.3.3.3/32 Static 60 0 192.168.1.62 GE1/0/1
127.0.0.0/8 Direct 0 0 127.0.0.1 InLoop0
127.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0
127.0.0.1/32 Direct 0 0 127.0.0.1 InLoop0
127.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0
169.254.0.0/24 Direct 0 0 169.254.0.188 GE1/0/1
169.254.0.0/32 Direct 0 0 169.254.0.188 GE1/0/1
169.254.0.188/32 Direct 0 0 127.0.0.1 InLoop0
169.254.0.255/32 Direct 0 0 169.254.0.188 GE1/0/1
224.0.0.0/4 Direct 0 0 0.0.0.0 NULL0
224.0.0.0/24 Direct 0 0 0.0.0.0 NULL0
255.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0
# 配置命令display ip $1 | include $2的别名为shinc,同时使用别名命令筛选并查看路由表中的所有静态路由信息。
[Sysname] alias shinc display ip $1 | include $2
[Sysname] shinc routing-table Static
3.3.3.3/32 Static 60 0 192.168.1.62 GE1/0/1
【相关命令】
· display alias
display | { begin | exclude | include }命令用来使用正则表达式对显示信息进行过滤。
【命令】
display command | { begin | exclude | include } regular-expression
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
command:命令关键字,取值可以通过输入?来获得。
begin:从包含正则表达式的行开始显示。
exclude:只显示不包含正则表达式的行。
include:只显示包含正则表达式的行。
regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。
【使用指导】
用display命令查看显示信息时,用户可以使用正则表达式来过滤显示信息,以便快速的找到自己关注的信息。关于正则表达式的详细描述请参考“基础配置指导”中的“CLI”。
【举例】
# 查看包含VLAN的配置。
<Sysname> display current-configuration | include vlan
vlan 1
vlan 999
port access vlan 999
display | by-linenum命令用来查看带行号的显示信息。
【命令】
display command | by-linenum
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
command:命令关键字,取值可以通过输入?来获得。
【使用指导】
使用本命令时,系统在显示信息的同时会自动在每行显示信息的前面添加行号,以便当显示信息较多时,能够迅速定位到某行信息。
行号占5个字符,通常行号后面接“:”。当by-linenum和begin参数一起使用时,行号后面还可能接“-”,其中“:”表示该行符合匹配规则,“-”表示该行不符合匹配规则。
【举例】
# 显示VLAN 999信息的同时显示行号。
<Sysname> display vlan 999 | by-linenum
1: VLAN ID: 999
2: VLAN type: Static
3: Route interface: Configured
4: IPv4 address: 192.168.2.1
5: IPv4 subnet mask: 255.255.255.0
6: Description: For LAN Access
7: Name: VLAN 0999
8: Tagged ports: None
9: Untagged ports:
10: GigabitEthernet1/0/1
11:
# 查看当前配置,从包含“user-group”字符串的行开始到最后一行配置信息,并同时显示行号。(行号后为“:”表示该行包含“user-group”字符串,行号后为“-”表示该行不包含“user-group”字符串。)
<Sysname> display current-configuration | by-linenum begin user-group
114: user-group system
115- #
116- return
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:
GigabitEthernet1/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:
GigabitEthernet1/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:
GigabitEthernet1/0/2
display alias命令用来查看命令别名的相关配置。
【命令】
display alias [ alias ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
alias:表示配置的命令别名。不指定该参数,则显示所有的已配置的命令别名。
【举例】
# 查看系统中配置的所有命令别名。
<Sysname> display alias
Index Alias Command key
1 access-list acl
2 end return
3 erase delete
4 exit quit
5 hostname sysname
6 logging info-center
7 no undo
8 shinc display $1 | include $2
9 show display
10 sirt display ip routing-table
11 write save
# 查看别名命令shinc表示的命令字符串。
<Sysname> display alias shinc
Alias Command key
shinc display ip $1 | include $2
表1-2 display alias命令显示信息描述表
字段 |
描述 |
Index |
索引号 |
Alias |
别名 |
Command key |
命令字符串 |
【相关命令】
· alias
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
03/16/2017 20:03:33 vty0 192.168.1.26 **
Cmd:dis his all
03/16/2017 20:03:29 vty0 192.168.1.26 **
Cmd:sys
表1-3 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 command hotkeys-
CTRL_G display current-configuration
CTRL_L display ip routing-table
CTRL_O undo debugging all
-Undefined command hotkeys-
CTRL_T NULL
CTRL_U NULL
-System-reserved 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.
表1-4 display hotkey命令显示信息描述表
字段 |
描述 |
Defined command hotkeys |
已定义的快捷键 |
Undefined command hotkeys |
未定义的快捷键 |
System-reserved hotkeys |
快捷键 |
功能 |
<Ctrl+A> |
将光标移动到当前行的开头 |
<Ctrl+B> |
将光标向左移动一个字符 |
<Ctrl+C> |
停止当前正在执行的功能 |
<Ctrl+D> |
删除当前光标所在位置的字符 |
<Ctrl+E> |
将光标移动到当前行的末尾 |
<Ctrl+F> |
将光标向右移动一个字符 |
<Ctrl+H> |
删除光标左侧的一个字符 |
<Ctrl+K> |
终止呼出的连接 |
<Ctrl+N> |
显示历史缓冲区中的下一条命令 |
<Ctrl+P> |
显示历史缓冲区中的上一条命令 |
<Ctrl+R> |
重新显示当前行信息 |
<Ctrl+V> |
粘贴剪贴板的内容 |
<Ctrl+W> |
删除光标左侧连续字符串内的所有字符 |
<Ctrl+X> |
删除光标左侧所有的字符 |
<Ctrl+Y> |
删除光标所在位置及其右侧所有的字符 |
<Ctrl+Z> |
退回到用户视图 |
<Ctrl+]> |
终止当前连接 |
<Esc+B> |
将光标移动到左侧连续字符串的首字符处 |
<Esc+D> |
删除光标所在位置及其右侧连续字符串内的所有字符 |
<Esc+F> |
将光标向右移到下一个连续字符串之前 |
<Esc+N> |
将光标向下移动一行(输入回车前有效) |
<Esc+P> |
将光标向上移动一行(输入回车前有效) |
<Esc+<> |
将光标所在位置指定为剪贴板的开始位置 |
<Esc+>> |
将光标所在位置指定为剪贴板的结束位置 |
【相关命令】
· hotkey
hotkey命令用来为快捷键指定对应的命令行。
undo hotkey命令用来恢复缺省情况。
【命令】
hotkey { ctrl_g | ctrl_l | ctrl_o | ctrl_t | ctrl_u } command
undo hotkey { ctrl_g | ctrl_l | ctrl_o | ctrl_t | ctrl_u }
【缺省情况】
<Ctrl+G>对应命令display current-configuration(显示当前配置)。
<Ctrl+L>对应命令display ip routing-table(显示IPv4路由表信息)。
<Ctrl+O>对应命令undo debugging all(关闭设备支持的所有功能项的调试开关)。
<Ctrl+T>未关联任何命令行。
<Ctrl+U>未关联任何命令行。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
ctrl_g:表示为快捷键<Ctrl+G>指定一条命令。
ctrl_l:表示为快捷键<Ctrl+L>指定一条命令。
ctrl_o:表示为快捷键<Ctrl+O>指定一条命令。
ctrl_t:表示为快捷键<Ctrl+T>指定一条命令。
ctrl_u:表示为快捷键<Ctrl+U>指定一条命令。
command:快捷键关联的命令行。
【使用指导】
通过快捷键用户可以简便、快捷的操作设备,使用display hotkey命令可以查看设备支持的所有快捷键及其含义。
【举例】
# 指定命令display tcp statistics的快捷键为<Ctrl+T>。
<Sysname> system-view
[Sysname] hotkey ctrl_t display tcp statistics
【相关命令】
· display hotkey
quit命令用来使用户从当前视图退回到上一层视图。
【命令】
quit
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【使用指导】
如果当前是用户视图,执行quit后,会断开当前连接,退出系统。
【举例】
# 从接口GigabitEthernet1/0/1视图退回到系统视图,再退回到用户视图。
[Sysname-GigabitEthernet1/0/1] quit
[Sysname] quit
<Sysname>
repeat命令用来重复执行历史记录命令。
【命令】
repeat [ number ] [ count times ] [ delay seconds ]
【视图】
任意视图
【缺省用户角色】
network-admin
【参数】
number:表示重复执行历史命令的条数,取值范围为1~10,缺省值为1。
count times:表示重复执行历史命令的次数,取值范围为0~4294967295,缺省值为0。如不指定该参数,则历史命令一直重复执行,直到执行用户线视图下设置的终止当前运行任务的快捷键才能停止执行该命令,默认的终止快捷键为<Ctrl+C>。关于终止当前执行任务的快捷键的设置,请参见“基础配置命令”中的“登录设备”。
delay seconds:表示重复执行历史命令的时间间隔,取值范围为0~4294967295,单位为秒,缺省值为1。
【使用指导】
重复执行历史命令时,系统将按照历史命令的下发顺序执行。例如,用户在某视图下依次执行命令a、b和c后,再执行repeat 3命令,则系统将按照a、b和c的顺序重复执行。
如果用户重复执行的历史命令中存在交互式命令,需要用户手动处理此交互式命令,直到交互式命令执行结束,历史命令才会继续被重复执行。
【举例】
# 重复执行最近2条历史命令display cpu-usage和display clock,重复执行3次,时间间隔10秒。
<Sysname> repeat 2 count 3 delay 10
<Sysname> display cpu-usage
Unit CPU usage:
33% in last 5 seconds
32% in last 1 minute
33% in last 5 minutes
<Sysname> display clock
07:02:18 UTC Thu 06/19/2017
<Sysname> display cpu-usage
Unit CPU usage:
33% in last 5 seconds
32% in last 1 minute
33% in last 5 minutes
<Sysname> display clock
07:02:28 UTC Thu 06/19/2017
<Sysname> display cpu-usage
Unit CPU usage:
33% in last 5 seconds
32% in last 1 minute
33% in last 5 minutes
<Sysname> display clock
07:02:38 UTC Thu 06/19/2017
【相关命令】
· display history-command
· escape-key(基础配置命令参考/登录设备)
· history-command max-size
return命令用来从当前视图(除Tcl配置视图和Python shell外的任意非用户视图)直接退回到用户视图。
【命令】
return
【视图】
除Tcl配置视图和Python shell外的任意非用户视图
【缺省用户角色】
network-admin
network-operator
【使用指导】
在除Tcl配置视图和Python shell外的任意非用户视图下,也可以按快捷键<Ctrl+Z>退回到用户视图,功能等同于return命令。
Tcl配置视图和Python shell下退回到用户视图的方式分别为:
· Tcl配置视图下请使用tclquit返回用户视图。
· 在Python shell下请通过执行exit()命令,从Python shell退回到用户视图。
【举例】
# 从接口GigabitEthernet1/0/1视图退回到用户视图。
[Sysname-GigabitEthernet1/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
【视图】
用户视图
【缺省用户角色】
network-admin
network-operator
【举例】
# 从用户视图进入系统视图。
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname]
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!