目  录

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.5.7 命令行输入回显功能

1.6 解读输入错误提示信息

1.7 使用历史命令

1.8 重复执行历史记录命令

1.9 便捷地查看显示信息

1.9.1 分屏显示

1.9.2 查看带行号的显示信息

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

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

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

1.10 保存当前配置

1 CLI

1.1  命令行接口简介

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

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

******************************************************************************

* Copyright (c) 2004-2017 New H3C Technologies Co., Ltd. All rights reserved.*

* Without the owner's prior written consent,                                 *

* no decompiling or reverse-engineering shall be allowed.                    *

******************************************************************************

<Sysname>

1.2  命令视图

1.2.1  命令视图简介

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

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

图1-1 命令视图示意图

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

  bash                Enter the bash shell

  boot-loader         Software image file management

……略……

(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>表示命令行当前位置无参数，直接输入回车即可执行。

·            输入命令的不完整关键字，其后紧接<?>，显示以该字符串开头的所有命令关键字及其帮助信息。例如：

<Sysname> f?

  fdisk     Partition a storage medium

firmware  Firmware management

  fixdisk   Check and repair a storage medium

  format    Format a storage medium

  free      Release a line

  ftp       Open an FTP connection

<Sysname> display ftp?

  ftp         FTP module

  ftp-server  FTP server information

  ftp-user    FTP user information

1.4  命令的undo形式

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

1.5  命令行输入

1.5.1  编辑命令行

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

表1-4 编辑功能表

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

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

在配置文件中，存在#和version 7.1.064, Alpha 2417P01这样的特殊命令行配置信息。#用于将两段配置信息隔开；version 7.1.064, Alpha 2417P01用于记录设备正在运行的软件包的版本信息。这样的命令行不支持在线帮助，但可以在任意视图下执行# xxx或者version xxx（比如执行# abc或者version abc），执行后系统不会提示错误信息，也不会修改这些行的值。这样的命令行用户没有必要使用，因此在命令手册中不再描述。

1.5.2  STRING和TEXT类型参数的输入

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

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

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

1.5.3  接口类型的输入

输入接口类型时，设备支持使用接口类型的全称和简称。使用接口类型的全称时，支持不完整的字符输入；使用接口类型简称时，必须输入完整的简称。两种方式输入的接口类型均不区分大小写。例如在输入interface gigabitethernet 1/0/1时，可以使用接口类型全称的不完整字符interface g 1/0/1，也可以使用接口类型简称interface ge 1/0/1。接口类型和接口编号之间无论输入空格与否，都可以成功进入接口视图。关于接口全名与简名的对应关系，如表1-5所示。

表1-5 接口类型的全称和简称对应表

1.5.4  快速输入命令行

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

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

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

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

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

1.5.5  配置命令字符串的别名

通过本命令用户可以为命令行指定一个或多个别名，也可以为命令行开头的一个或多个关键字配置多个别名，使其符合用户的使用习惯。使用本特性，只有当命令行第一个关键字或者undo命令的第二个关键字是别名时，才按照别名命令替换执行，否则按照非别名命令执行。比如：

·            将命令display ip routing-table的别名配置为siprt后，就可以使用别名命令siprt来代替执行命令display ip routing-table。

·            将命令关键字display ip的别名配置为ship，就可以用别名命令ship执行所有以display ip开头的命令行，如可以使用ship routing-table代替执行display ip routing-table，使用ship interface代替执行display ip interface。

使用本特性时需要注意：

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

·            当用户在执行别名命令时，如果别名命令中定义了参数，则参数必须输入完全，设备才会按照替换后的命令执行相关操作；否则设备将会返回命令输入不完整的提示信息，并显示出当前别名代表的命令字符串。

·            为了方便用户使用，系统定义了部分常用的关键字作为缺省别名，如表1-6所示。如果修改了系统定义的缺省别名，使用undo命令取消配置后会恢复缺省情况。

表1-6 系统定义的缺省别名

表1-7 配置命令字符串的别名

1.5.6  配置命令行的快捷键

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

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

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

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

1.5.7  命令行输入回显功能

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

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

1.6  解读输入错误提示信息

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

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

1.7  使用历史命令

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

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

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

·            如果用户使用了命令的不完整形式，保存的历史命令也是不完整形式；如果用户使用了命令字符串的别名形式，保存的历史命令是原始命令形式。

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

1.8  重复执行历史记录命令

当需要重复执行最近的历史记录命令时，使用repeat命令可以重复多次执行多条历史命令，并且可以设置每次重复执行历史命令的时间间隔。

在执行repeat命令时需要注意：

·            重复执行历史命令时，系统将按照历史命令的下发顺序执行。例如，用户在某视图下依次执行命令a、b和c后，再执行repeat 3命令，则系统将按照a、b和c的顺序重复执行。

·            如果用户重复执行的历史命令中存在交互式命令，需要用户手动处理此交互式命令，直到交互式命令执行结束，历史命令才会继续被重复执行。

表1-13 重复执行历史记录命令

1.9  便捷地查看显示信息

1.9.1  分屏显示

1. 控制分屏显示

当显示信息较多并超过一屏时，系统会将信息分屏显示，并在屏间显示“----more----”信息，表示这一屏信息已经显示完毕，自动暂停，方便查看显示信息。

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

表1-14 分屏显示功能表

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

2. 关闭分屏显示功能

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

表1-15 关闭分屏显示

1.9.2  查看带行号的显示信息

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

行号占5个字符，通常行号后面接“:”。当by-linenum和begin参数一起使用时，行号后面还可能接“-”，其中“:”表示该行符合匹配规则，“-”表示该行不符合匹配规则。

表1-16 查看带行号的显示信息

下面将通过举例示意如何查看带行号的显示信息。

# 显示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:      GigabitEthernet1/0/1

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

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

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

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

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

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

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

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

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

# 查看当前生效的配置中，从包含“line”字符串的行开始到最后一行的配置信息（该显示信息与设备型号以及用户的当前配置有关）。

<Sysname> display current-configuration | begin line

line class console

 user-role network-admin

#

line class vty

 user-role network-operator

#

line con 0

 user-role network-admin

#

line vty 0 4

 authentication-mode scheme

 user-role network-operator

#

 ssh server enable

#

return

# 查看路由表中的非直连路由（该显示信息与设备型号以及用户的当前配置有关）。

<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         GE1/0/1

# 查看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.9.4  将显示信息保存到指定文件

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

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

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

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

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

# 将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 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/1

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

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

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

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

# 按行号将当前配置保存到文件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.10  保存当前配置

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

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