目  录

1 CLI

1.1 命令行接口简介

1.2 命令视图

1.2.1 命令视图简介

1.2.2 进入系统视图

1.2.3 返回上一级视图

1.2.4 返回用户视图

1.3 使用命令行在线帮助

1.4 命令的undo形式

1.5 命令行输入

1.5.1 编辑命令行

1.5.2 STRING和TEXT类型参数的输入

1.5.3 快速输入命令行

1.5.4 配置命令关键字的别名

1.5.5 配置命令行的快捷键

1.5.6 命令行输入回显功能

1.6 解读输入错误提示信息

1.7 使用历史命令

1.8 便捷地查看显示信息

1.8.1 分屏显示

1.8.2 查看带行号的显示信息

1.8.3 使用正则表达式过滤显示信息

1.8.4 将显示信息保存到指定文件

1.8.5 各种便捷查看方式的综合应用

1.9 保存当前配置

1 CLI

1.1  命令行接口简介

CLI（Command Line Interface，命令行接口）是用户与设备之间的文本类指令交互界面。用户输入文本类命令，通过输入回车键提交设备执行相应命令，从而对设备进行配置和管理，并可以通过查看输出信息确认配置结果。

设备支持多种方式进入命令行接口界面，比如通过Console口/Telnet/SSH登录设备后进入命令行接口界面等，各方式的详细描述请参见“基础配置指导”中的“登录设备”。设备的命令行接口界面如图1-1所示。

图1-1 命令行接口界面

1.2  命令视图

1.2.1  命令视图简介

设备提供了丰富的功能，不同的功能对应不同的配置和查询命令。为便于用户使用这些命令，设备按功能对命令进行分类组织。功能分类与命令视图对应，当要配置某功能的某条命令时，需要先进入这条命令所在的视图。每个视图都有唯一的、含义清晰的提示符，比如提示符[Sysname-vlan100]表示当前的命令视图是VLAN视图，VLAN的编号是100，在该视图下可对VLAN 100的属性进行配置。

命令视图采用分层结构，如图1-2所示。

图1-2 命令视图示意图

·     用户登录设备后，直接进入用户视图。此时屏幕显示的提示符是：<设备名>。用户视图下可执行的操作主要包括查看操作、调试操作、文件管理操作、设置系统时间、重启设备、FTP和Telnet操作等。

·     从用户视图可以进入系统视图，此时屏幕显示的提示符是：[设备名]。系统视图下能对设备运行参数以及部分功能进行配置，比如配置夏令时、配置欢迎信息、配置快捷键等。

·     在系统视图下输入特定命令，可以进入相应的功能视图，完成相应功能的配置，比如：进入接口视图配置接口参数、进入VLAN视图给VLAN添加端口、进入用户线视图配置登录用户的属性、创建本地用户并进入本地用户视图配置本地用户的属性等。功能视图下可能还包含子视图，比如BGP视图下还包含BGP IPv4单播实例视图和BGP-VPN IPv4单播实例视图等，请参见各功能模块的详细描述。

想要了解某命令视图下支持哪些命令，请在该命令视图提示符后输入<?>。

1.2.2  进入系统视图

表1-1 进入系统视图

1.2.3  返回上一级视图

当前视图下的功能配置完成，使用本命令可以退出当前视图返回到上一级视图。需要注意的是：

·     用户视图下执行quit命令会中断用户终端与设备之间的当前连接。

·     公共密钥视图下请使用peer-public-key end命令返回系统视图。

表1-2 返回上一级视图

1.2.4  返回用户视图

本命令为用户提供了一种从任意的非用户视图返回到用户视图的快捷方式，而不需要多次执行quit命令逐级返回。用户也可以直接按组合键<Ctrl+Z>从当前视图返回用户视图。

表1-3 返回用户视图

1.3  使用命令行在线帮助

在命令行输入过程中，可以在命令行的任意位置输入<?>以获得详尽的在线帮助。下面给出常见的在线帮助应用场景，供参考使用。

(1)     在任意视图下，输入<?>即可获取该视图下可以使用的所有命令及其简单描述。例如：

<Sysname> ?

User view commands:

  archive           Archive configuration

  backup            Backup the startup configuration file to a TFTP server

  boot-loader       Set boot loader

……略……

(2)     输入一条命令的关键字，后接以空格分隔的<?>。

如果<?>位置为关键字，则列出全部关键字及其简单描述。例如：

<Sysname> terminal ?

  debugging  Enable to display debugging logs on the current terminal

  logging  Display logs on the current terminal

  monitor  Enable to display logs on the current terminal

如果<?>位置为参数，则列出有关的参数描述。例如：

<Sysname> system-view

[Sysname] interface vlan-interface ?

  <1-4094>  Vlan-interface interface number 

[Sysname] interface vlan-interface 1 ?

  <cr>

其中，<1-4094>表示该参数的取值范围为1～4094；<cr>表示命令行当前位置无参数，直接输入回车即可执行。

(3)     输入命令的不完整关键字，其后紧接<?>，显示以该字符串开头的所有命令关键字。例如：

<Sysname> f?

  fan

  fdisk

  fixdisk

  format

  free

  ftp

<Sysname> display ftp?

  ftp

  ftp-server

  ftp-user

1.4  命令的undo形式

命令的undo形式一般用来恢复缺省情况、禁用某个功能或者删除某项设置。大部分配置命令都有对应的undo形式。例如，info-center enable命令用来开启信息中心，undo info-center enable命令用来关闭信息中心。

1.5  命令行输入

1.5.1  编辑命令行

编辑命令行时，系统支持如表1-4所示的单个按键和如表1-7所示的组合键。

表1-4 编辑功能表

用户通过键盘输入命令行后，按<Enter>键执行该命令。

用户输入的命令行总长度不能超过512个字符，包括空格，关键字或特殊符号等。

1.5.2  STRING和TEXT类型参数的输入

输入命令行时，如果命令行中的参数是STRING类型的，则设备对该参数的基本要求为：除“?”、“"”、“\”、空格之外的可见字符，可见字符对应的ASCII码区间为32～126。

如果命令行中的参数是TEXT类型的，则除了“?”外的其他字符都可输入。

需要注意的是，业务模块可能对参数有更多的输入限制，详情请见命令的提示信息以及命令参考中的参数描述。

1.5.3  快速输入命令行

设备支持不完整关键字输入，即在当前视图下，当输入的字符足够匹配唯一的关键字时，可以不必输入完整的关键字。该功能提供了一种快捷的输入方式，有助于提高操作效率。

比如用户视图下以s开头的命令有startup saved-configuration、system-view等。

·     如果要输入system-view，可以直接输入sy（不能只输入s，因为只输入s时，匹配到的关键字不唯一）。

·     如果要输入startup saved-configuration，可以直接输入st s。

可以按<Tab>键由系统自动补全关键字的全部字符，以确认系统的选择是否为所需输入的关键字。

1.5.4  配置命令关键字的别名

使用本特性，可以给设备当前支持的命令行的第一个关键字或者undo命令的第二关键字取一个您惯用的关键字作为别名。比如将display的别名设置为show，这样在设备上执行display clock命令时可以输入display clock，也可以输入show clock。

使用本特性后：

·     用户成功执行的带别名的命令将以系统原始的命令形式被显示或存储，而不会以别名的形式。

·     当用户输入不完整关键字并回车，且该关键字与用户定义的别名以及现有某关键字同时部分匹配时，则只执行别名对应的命令。如果用户输入的字符串与多个别名部分匹配，则输出错误提示信息。

·     当用户输入不完整关键字并使用<Tab>键补全，且该关键字与用户定义的别名以及现有某关键字同时部分匹配时，则第一次使用<Tab>键，将联想出别名对应的原始关键字；再次使用<Tab>键，系统才会按字母序联想出现有关键字。

表1-5 配置命令关键字的别名

1.5.5  配置命令行的快捷键

为便于用户对常用命令进行快捷操作，系统提供了一系列的快捷键。其中用户可自定义的快捷键有五个，配置步骤见表1-6，其他快捷键（见表1-7）为系统保留的，不能通过命令行配置。

只要用户按下某个快捷键，系统即可执行对应的指令。需要注意的是，当用户使用终端软件与设备进行交互时，且终端软件定义了这些快捷键（包括用户可定义的和系统保留的），则快捷键会遵从终端软件的定义，不会对设备生效。

表1-6 配置命令行的快捷键

表1-7 系统保留的快捷键

1.5.6  命令行输入回显功能

当用户在未完成输入操作却被大量的系统信息打断时，开启此功能可以回显用户已经输入而未提交执行的信息，方便用户继续完成未输入的内容。

表1-8 配置命令行输入回显功能

1.6  解读输入错误提示信息

命令行输入完毕后，请按<Enter>键执行该命令。设备执行命令的过程中，首先会对命令行进行语法检查。如果通过语法检查，则正确执行；否则，输出错误信息，常见的错误信息如表1-9所示。

表1-9 命令行常见错误信息表

1.7  使用历史命令

用户在设备上成功执行的命令，会同时保存到用户独享的历史命令缓冲区和所有用户共享的历史命令缓冲区。两缓冲区的详细描述请参见表1-10。

表1-10 历史命令缓冲区描述表

设备保存历史命令时，遵循下列原则：

·     设备保存的历史命令与用户输入的命令格式相同。如果用户使用了命令的不完整形式，保存的历史命令也是不完整形式；如果用户使用了命令关键字的别名形式，保存的历史命令也是原始命令形式。

·     如果用户连续多次执行同一条命令，设备的历史命令中只保留一次。但如果执行时输入的形式不同，将作为不同的命令对待。例如：连续多次执行display current-configuration命令，设备只保存一条历史命令；如果分别执行display current-configuration命令和它的不完整形式display cu，设备将保存为两条历史命令。

需要注意的是，在Windows 200X及Windows XP的超级终端和Telnet下可使用光标键访问历史命令，但对于Windows 9X的超级终端，↑、↓光标键无效，这是由于Windows 9X的超级终端对这两个键作了不同解释所致。

1.8  便捷地查看显示信息

1.8.1  分屏显示

1. 控制分屏显示

当显示信息较多并超过一屏时，系统会将信息分屏显示，并在屏间自动暂停，方便查看显示信息。

这时用户可以使用表1-11所示的按键来选择下一步操作。

表1-11 分屏显示功能表

缺省情况下，一屏显示24行信息，也可以使用screen-length命令设置用户线下一屏显示的行数（screen-length命令的详细介绍请参见“基础配置命令参考”中的“登录设备”）。

2. 关闭分屏显示功能

可以通过以下配置禁用当前登录用户的分屏显示功能。禁止分屏显示时，会一次显示所有信息，如果信息较多，则会连续刷屏，不方便查看。

表1-12 禁止分屏显示

1.8.2  查看带行号的显示信息

在用display命令查看显示信息时，用户可以用by-linenum参数在显示信息的同时显示信息行号，方便定位显示信息。如果不带by-linenum参数，则不会显示行号。

行号占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:  IP address: 192.168.2.1

    5:  Subnet mask: 255.255.255.0

    6:  Description: For LAN Access

    7:  Name: VLAN 0999

    8:  Tagged ports:   None

    9:  Untagged ports:

   10:      GigabitEthernet7/0/1

1.8.3  使用正则表达式过滤显示信息

在执行display命令查看显示信息时，可以使用正则表达式来过滤显示信息，以便快速的找到自己关注的信息。

在display命令中通过输入| { begin | exclude | include } regular-expression参数的方式来过滤显示。begin、exclude和include关键字的含义如下：

·     begin：显示特定行及其以后的所有行，该特定行必须包含指定正则表达式。

·     exclude：显示不包含指定正则表达式的所有行。

·     include：只显示包含指定正则表达式的所有行。

正则表达式（regular-expression）为1～256个字符的字符串，区分大小写，它支持多种特殊字符，特殊字符的匹配规则如表1-13所示。正则表达式的执行时间和正则表达式的复杂程度成正比，对于复杂的正则表达式，执行时间会比较长，如有需要，可按<CTRL+C>键终止。

表1-13 正则表达式中的特殊字符描述表

下面将通过举例示意如何使用正则表达式过滤显示信息。

# 查看当前生效的配置中，从包含“line”字符串的行开始到最后一行的配置信息。

<Sysname> display current-configuration | begin line

line class aux

 user-role network-operator

#

line class console

 user-role network-admin

#

line class vty

 user-role network-operator

#

line aux 1

 authentication-mode none

 user-role network-admin

#

line con 1

 user-role network-admin

#

line vty 0 63

 authentication-mode none

 user-role network-admin

 user-role network-operator

 idle-timeout 0 0

#

undo info-center enable

---- More ----

# 查看路由表中的非直连路由。

<Sysname> display ip routing-table | exclude Direct

Destinations : 12       Routes : 12

Destination/Mask    Proto  Pre  Cost         NextHop         Interface

2.2.2.0/24          OSPF   10   2            1.1.2.2         GE3/0/2

# 查看SNMP相关配置。

<Sysname> display current-configuration | include snmp

 snmp-agent

 snmp-agent community write private

 snmp-agent community read public

 snmp-agent sys-info version all

 snmp-agent target-host trap address udp-domain 192.168.1.26 params securityname public

1.8.4  将显示信息保存到指定文件

display命令显示的内容通常是统计信息、功能是否使能以及功能的相关参数配置，这些信息在设备运行过程中会随着时间或者用户的配置而改变。使用本配置可以将当前显示信息保存到指定文件，方便随时比对和查看。有两种方式将显示信息保存到文件中：

·     将显示信息独立保存到指定文件：使用该方式时，该文件只包含该显示信息的内容。

·     将显示信息以追加方式保存到已有文件：使用该方式时，该命令的显示信息会追加在指定文件的尾部保存，该文件能包含多条显示信息的内容。

表1-14 将显示信息保存到指定文件

下面将通过举例示意如何将显示信息保存到指定文件以及保存效果。

# 将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:

    GigabitEthernet7/0/2

# 将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:

    GigabitEthernet7/0/2

 VLAN ID: 999

 VLAN type: Static

 Route interface: Configured

 IP address: 192.168.2.1

 Subnet mask: 255.255.255.0

 Description: For LAN Access

 Name: VLAN 0999

 Tagged ports:   None

 Untagged ports:

    GigabitEthernet7/0/1

1.8.5  各种便捷查看方式的综合应用

执行display命令时，通过选择参数，可以同时实现“1.8.2  查看带行号的显示信息”、“1.8.3  使用正则表达式过滤显示信息”和“1.8.4  将显示信息保存到指定文件”。

表1-15 各种便捷查看方式的综合应用

下面将通过举例示意如何将各种便捷查看方式综合应用。

# 按行号将当前配置保存到文件test.txt。

<Sysname> display current-configuration | by-linenum > test.txt

# 将SNMP的相关配置以追加方式保存到文件test.txt。

<Sysname> display current-configuration | include snmp >> test.txt

# 查看当前配置，从包含“user-group”字符串的行开始到最后一行配置信息，并同时显示行号。（行号后为“:”表示该行包含“user-group”字符串，行号后为“-”表示该行不包含“user-group”字符串。）

<Sysname> display current-configuration | by-linenum begin user-group

  114:  user-group system

  115-  #

  116-  return

1.9  保存当前配置

在设备上，可以输入save命令，将当前配置保存到配置文件中。这样在设备重启后，所有保存的配置不会丢失。

配置保存不涉及一次性执行命令，比如：display命令（执行后即显示相关信息）和reset命令（执行后即清除相关信息）。save命令的详细介绍请参见“基础配置命令参考”中的“配置文件管理”。