2024年9月24日发(作者：义韶敏)
【举例】
# 执行根目录下的批处理文件。
[Sysname] execute
1.1.6 file prompt
【命令】
file prompt { alert | quiet }
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
alert：交互确认方式。当用户对文件进行有危险性的操作时，系统会要求用户进行交互确认。
quiet：非交互确认方式。用户对文件进行任何操作，系统均不要求用户进行确认。
【描述】
file prompt命令用来设置系统对文件操作的提示方式。
缺省情况下，文件操作的提示方式为alert。
需要注意的是，如果将文件操作的提示方式设置为quiet，则系统对文件操作不要求用户进行确认，
这样可能会导致一些因误操作而发生的、不可恢复的、对系统造成破坏的操作产生。
【举例】
# 设置系统对文件操作的提示方式为alert。
[Sysname] file prompt alert
1.1.7 fixdisk
【命令】
fixdisk device
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
device：存储设备名称。
【描述】
fixdisk命令用来恢复存储设备的空间。
1-5
由于异常操作等原因，存储设备的某些空间可能不可用，用户可以通过fixdisk命令来恢复存储设
备的空间。
【举例】
# 恢复存储设备Flash的空间。
Fixdisk flash: may take some time
%Fixdisk flash: completed.
1.1.8 format
【命令】
format device
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
device：为存储设备名（如flash等）。
【描述】
format命令用来格式化存储设备。
格式化操作将导致存储设备上的所有文件丢失，并且不可恢复。
【举例】
# 格式化Flash。
All data on flash: will be lost, proceed with format? [Y/N]:y
./
%Format flash: completed.
1.1.9 mkdir
【命令】
mkdir directory
【视图】
用户视图
【缺省级别】
3：管理级
1-6
【参数】
directory：文件夹。
【描述】
mkdir命令用来在存储设备的指定目录下创建文件夹。
需要注意的是：
•
•
如果创建的文件夹与指定目录下的其它文件夹重名，则创建操作失败。
在使用该命令创建文件夹之前，指定的目录必须已经存在。比如：创建文件夹
flash:/test/mytest，这时，test目录必须已经存在，否则，创建失败。
【举例】
# 在当前路径创建文件夹test。
....
%Created dir flash:/test.
# 在当前路径创建文件夹test/subtest。
....
%Created dir flash:/test/subtest.
1.1.10 more
【命令】
more file-url
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
file-url：文件名。
【描述】
more命令用来显示指定文件的内容。
目前文件系统只支持显示文本文件的内容。
【举例】
# 查看文件。
#
version 5.20, Release 0000
#
sysname Test
#
---- More ----
1-7
“---- More ----”表示这一屏信息已经显示完毕，会暂停显示。按
按
1.1.11 move
【命令】
move fileurl-source fileurl-dest
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
fileurl-source：源文件名。
fileurl-dest：目标文件名或者目标文件夹。
【描述】
move命令用来移动文件。
如果使用文件夹作为fileurl-dest，则系统会将文件移到指定文件夹，文件名保持不变。
【举例】
# 将文件flash:/test/移动到flash:/，并更名为。
Move flash:/test/ to flash:/?[Y/N]:y
...
% Moved file flash:/test/ to flash:/
# 将文件移动到子文件夹test2下。
Move flash:/ to flash:/test2/?[Y/N]:y
.
%Moved file flash:/ to flash:/test2/.
1.1.12 pwd
【命令】
pwd
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
无
1-8
【描述】
pwd命令用来显示当前路径。
【举例】
# 显示当前路径。
flash:
1.1.13 rename
【命令】
rename fileurl-source fileurl-dest
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
fileurl-source：源文件名或源文件夹。
fileurl-dest：目标文件名或目标文件夹。
【描述】
rename命令用来重命名文件或文件夹。若目标文件名与当前路径下已经存在的文件重名，则该操
作不执行。
【举例】
# 将文件重命名为。
Rename flash:/ to flash:/? [Y/N]:y
% Renamed file flash:/ to flash:/
1.1.14 reset recycle-bin
【命令】
reset recycle-bin [ /force ]
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
/force：强制清空回收站。
1-9
【描述】
reset recycle-bin命令用来彻底删除当前目录下、处于回收站中的文件。
如果文件损坏，直接使用reset recycle-bin命令可能不能删除该文件。使用reset recycle-bin
/force可以强制删除回收站中的所有文件。
需要注意的是：
•
•
用delete file-url命令删除文件是将文件放在回收站中，但仍然占用存储空间，如果想要把回
收站中的该文件删除，必须在该文件的原目录下执行reset recycle-bin命令。
reset recycle-bin命令删除的是当前目录下、处于回收站中的文件。如果要清除的文件的原
路径不是当前路径，则必须先使用cd命令进入文件的原目录，再执行reset recycle-bin命
令。
【举例】
# 删除当前目录下、处于回收站中的文件。
•
显示当前目录下、处于回收站中的所有文件。
Directory of flash:/
0 -rwh 3080 JAN 26 2013 16:41:43
1 -rw- 2416 JAN 26 2013 13:45:36
2 -rw- 8036197 JAN 14 2013 10:13:18
3 -rw- 2386 JAN 26 2013 13:30:30
4 drw- - JAN 08 2013 09:49:25 test
5 -rwh 716 JAN 24 2013 16:17:30 hostkey
6 -rwh 572 JAN 24 2013 16:17:44 serverkey
7 -rw- 2386 JAN 08 2013 11:14:20 []
8 -rw- 3608 JAN 03 2013 17:29:30 []
12065 KB total (6730 KB free)
//
以上信息表明当前路径为
flash:
，处于回收站中的文件有
和
。
•
彻底删除当前目录下、处于回收站中的文件。
Clear flash:/~/ ?[Y/N]:n
Clear flash:/~/ ?[Y/N]:y
Clearing files from flash may take a long time.
......
%Cleared file flash:/~/...
•
验证flash:目录下、处于回收站中的文件是否已被删除。
Directory of flash:/
0 -rwh 3080 JAN 26 2013 16:41:43
1 -rw- 2416 JAN 26 2013 13:45:36
2 -rw- 8036197 JAN 14 2013 10:13:18
3 -rw- 2386 JAN 26 2013 13:30:30
4 drw- - JAN 08 2013 09:49:25 test
1-10
5 -rwh 716 JAN 24 2013 16:17:30 hostkey
6 -rwh 572 JAN 24 2013 16:17:44 serverkey
7 -rw- 2386 JAN 08 2013 11:14:20 []
12065 KB total (6734 KB free)
//
以上信息表明文件
flash:/
已被彻底删除。
# 删除子目录test下、处于回收站中的文件。
•
•
进入子目录。
查看test子文件夹下的所有文件。
Directory of flash:/test
0 -rw- 2161 JAN 26 2013 21:22:35 []
12065 KB total (6734 KB free)
//
以上信息表明该文件夹下只有一个文件，而且该文件已经被删除至回收站。
•
彻底删除test/。
Clear flash:/test/~/ ?[Y/N]:y
Clearing files from flash may take a long time.
..
%Cleared file flash:/test/~/...
1.1.15 rmdir
【命令】
rmdir directory
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
directory：文件夹。
【描述】
rmdir命令用来删除文件夹。
需要注意的是：
•
•
被删除的文件夹必须为空文件夹（即删除文件夹前，必须先删除该文件夹下的所有文件及子文
件夹，文件的删除请参见delete命令）。
成功执行rmdir后，回收站中原来属于该文件夹的文件会自动被彻底删除。
【举例】
# 删除文件夹mydir。
1-11
Rmdir flash:/mydir? [Y/N]:y
%Removed directory flash:/mydir.
1.1.16 undelete
【命令】
undelete file-url
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
file-url：要恢复的文件名。
【描述】
undelete命令用来恢复未被彻底删除（即存放在回收站里）的文件。
如果恢复的文件名与当前存在的文件重名，系统将提示操作者是否覆盖原有文件。
【举例】
# 恢复目录flash:下删除的文件。
Undelete flash:/?[Y/N]:y
.....
%Undeleted file flash:/.
# 恢复目录flash:/test下删除的文件。
Undelete flash:/test/?[Y/N]:y
.......
%Undeleted file flash:/test/.
或者使用以下步骤，也可以恢复flash:/test/。
Undelete flash:/test/?[Y/N]:y
.....
%Undeleted file flash:/test/.
1-12
目 录
1 配置文件管理 ····································································································································· 1-1
1.1 配置文件管理命令 ····························································································································· 1-1
1.1.1 archive configuration ·············································································································· 1-1
1.1.2 archive configuration interval ·································································································· 1-1
1.1.3 archive configuration location ································································································· 1-2
1.1.4 archive configuration max ······································································································ 1-3
1.1.5 backup startup-configuration ·································································································· 1-4
1.1.6 configuration replace file ········································································································ 1-4
1.1.7 display archive configuration ·································································································· 1-5
1.1.8 display current-configuration ·································································································· 1-6
1.1.9 display default-configuration ··································································································· 1-7
1.1.10 display saved-configuration ·································································································· 1-9
1.1.11 display startup ···················································································································· 1-10
1.1.12 display this ·························································································································· 1-11
1.1.13 reset saved-configuration ··································································································· 1-13
1.1.14 restore startup-configuration ······························································································ 1-13
1.1.15 save ···································································································································· 1-14
1.1.16 startup saved-configuration ································································································ 1-15
i
1
配置文件管理
1.1
配置文件管理命令
1.1.1 archive configuration
【命令】
archive configuration
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
无
【描述】
archive configuration命令用来手工备份当前配置。
执行该命令后，系统会将当前的配置以指定的文件名（指定前缀+序号）保存到指定的路径。
需要注意的是：
•
执行archive configuration命令前必须先执行archive configuration location命令来设置
备份文件的前缀和保存路径。
【举例】
# 手工备份当前配置。
Warning: Save the running configuration to an archive file. Continue? [Y/N]: Y
Info: The archive configuration file myarchive_ is saved.
1.1.2 archive configuration interval
【命令】
archive configuration interval minutes
undo archive configuration interval
【视图】
系统视图
【缺省级别】
3：管理级
1-1
【参数】
minutes：表示自动备份当前配置的时间间隔，取值范围为10～525600（相当于365天），单位为
分钟。
【描述】
archive configuration interval命令用来使能自动备份当前配置功能，并设置自动备份的间隔时间。
undo archive configuration interval用来恢复缺省情况。
缺省情况下，系统不会自动备份当前配置。
成功执行本命令后，每隔指定时间（由minutes值决定）系统会把当前配置以指定文件名自动保存
到指定路径。
使用该命令时应根据设备存储介质的性能和修改配置的频繁程度来设置minutes参数的具体值：
•
•
对于不会频繁修改配置的设备，建议按需手动备份当前配置（相关配置可参考命令archive
configuration）；
对于使用低速存储介质（如Flash）的设备，建议不要进行自动备份配置，或设置minutes大
于1440（24小时）；
执行archive configuration interval命令前必须先执行archive configuration location命
令来设置备份文件的前缀和保存路径。
需要注意的是：
•
【举例】
# 设置每隔一小时自动备份当前配置。
[Sysname] archive configuration interval 60
Info: Archive files will be saved every 60 minutes.
1.1.3 archive configuration location
【命令】
archive configuration location directory filename-prefix filename-prefix
undo archive configuration location
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
directory：表示保存备份配置文件的文件夹的路径，为1～63字节的字符串，格式为存储介质名:/[文
件夹名]/子文件夹名，不区分大小写。该文件夹必须预先创建好。
filename-prefix：表示备份配置文件的文件名前缀，为1～30字节的字符串，只能包含字母、数字、
“_”和“-”，不区分大小写。
【描述】
archive configuration location命令用来设置备份配置文件的保存路径和文件名前缀。undo
archive configuration location命令用来恢复缺省情况。
1-2
缺省情况下，系统没有设置备份配置文件的保存路径和文件名前缀，也不会定时备份配置。
需要注意的是：
•
•
自动或手动备份当前配置前必须使用该命令设置备份配置文件的保存路径和文件名前缀。
执行undo archive configuration location命令后，用户将不能手工备份当前配置，系统也
不再自动备份当前配置，archive configuration interval和archive configuration max的
配置也会恢复到缺省情况，已保存的备份配置文件记录也会被清除。
【举例】
# 在flash:/archive目录下备份配置文件，文件名前缀为my_archive。
•
.
%Created dir flash:/archive.
创建文件夹flash:/archive。
•
设置备份配置文件的保存路径和文件名前缀。
[Sysname] archive configuration location flash:/archive filename-prefix my_archive
1.1.4 archive configuration max
【命令】
archive configuration max file-number
undo archive configuration max
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
file-number：表示可保存的备份配置文件数目上限，取值范围为1～10。该参数的具体数值应根据
设备存储介质的空间大小来决定。对于存储空间较小的设备，建议设置file-number为较小值。
【描述】
archive configuration max命令用来设置系统允许保存的备份配置文件的最大数。undo archive
configuration max用来恢复缺省情况。
缺省情况下，系统最多允许保存5个备份配置文件。
备份配置文件数目过多会占用系统内存空间，通过该命令可以控制备份配置文件的数目。当备份配
置文件数目到达上限后，下次备份配置文件（包括自动和手动两种触发方式）时，将删除保存时间
最早的备份文件，以保存新的备份配置文件。修改备份配置文件数上限时并不删除多余文件，如果
当前已有的备份配置文件数大于或等于新设置的上限值，则在备份新的配置时，系统将自动删除生
成时间最早的（当前已有备份配置文件数-新设置的上限值+1）备份配置文件。（比如，当前已有备
份配置文件数为7，新设置的上限值为4，当有配置需要备份时，系统会先删除“7-4+1=4”个生成
时间最早的备份配置文件）
1-3
在使用该命令前，必须先执行archive configuration location命令设置保存路径和文件名前缀，
否则，本命令执行失败。
需要注意的是，执行undo archive configuration location，系统最多允许保存的备份配置文件数
目也会恢复到缺省情况。
【举例】
# 设置系统最大允许保存10个备份配置文件。
[Sysname] archive configuration max 10
1.1.5 backup startup-configuration
【命令】
backup startup-configuration to dest-addr [ dest-filename ]
【视图】
用户视图
【缺省级别】
2：系统级
【参数】
dest-addr：TFTP服务器的IPv4地址或主机名，为1～20个字符的字符串。
dest-filename：目的文件名，后缀必须为“.cfg”。在服务器上将以该文件名保存设备的启动配置文
件。
【描述】
backup startup-configuration命令用于将设备的下次启动配置文件备份到指定的TFTP服务器。
如果不指定目的文件名，则使用原文件名备份。执行该命令仅对主用下次启动配置文件进行备份。
目前设备通过TFTP传输协议来实现备份操作。
【举例】
# 将设备的下次启动配置文件备份到IP地址为2.2.2.2的TFTP服务器上，文件名为
。
MainBoard:
Current startup saved-configuration file: flash:/
Next main startup saved-configuration file: flash:/
Next backup startup saved-configuration file: flash:/
Backup next startup-configuration file to 2.2.2.2, please wait…finished!
1.1.6 configuration replace file
【命令】
configuration replace file filename
1-4
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
filename：指定用来回滚配置的配置文件名。
【描述】
configuration replace file命令用来进行配置回滚。
执行本命令后，系统当前配置将恢复到指定配置文件（filename）中的配置状态。
需要注意的是configuration replace file filename命令中指定的配置文件只能是明文配置文件，不
能是被加密的配置文件。否则，会导致配置回滚出错。
【举例】
# 将当前配置回滚到配置文件my_archive_中的配置状态。
[Sysname] configuration replace file my_archive_
Current configuration will be lost, save current configuration? [Y/N]:n
Info: Now replacing the current configuration.
Info: Succeeded in replacing current configuration with the file my_archive_.
1.1.7 display archive configuration
【命令】
display archive configuration [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display archive configuration命令用来显示配置回滚功能的相关信息。
【举例】
# 显示配置回滚功能的相关信息。
1-5
Location: flash:/archive
Filename prefix: my_archive
Archive interval in minutes: 120
Maximum number of archive files: 10
Saved archive files:
No. TimeStamp FileName
1 Jan 05 2013 20:24:54 my_archive_
2 Jan 05 2013 20:34:54 my_archive_
# 3 Jan 05 2013 20:44:54 my_archive_
‘#’ indicates the most recent archive file.
Next archive file to be saved: my_archive_
表1-1 display archive configuration命令显示信息描述表
字段
Location
Filename prefix
Archive interval in minutes
Maximum number of archive files
Saved archive files
No.
TimeStamp
FileName
‘#’ indicates the most recent archive file.
Next archive file to be saved
描述
保存备份配置文件的文件夹的绝对路径
备份配置文件的文件名前缀
自动备份配置文件的时间间隔，以分钟为单位
若不自动备份配置文件，不显示此项
设备可保存的最大备份配置文件数目
当前已保存的备份配置文件信息
显示已保存的备份配置文件信息的行号
备份配置文件的保存时间
备份配置文件名，不包含路径
“#”表示该行描述的备份配置文件是最近一次备份的
下次保存备份配置文件将使用的文件名
1.1.8 display current-configuration
【命令】
display current-configuration [ [ configuration [ configuration ] | interface [ interface-type ]
[ interface-number ] | exclude modules ] [ by-linenum ] [ | { begin | exclude | include }
regular-expression ] ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
configuration [ configuration ]：显示非接口配置。
1-6
interface [ interface-type ] [ interface-number ]：显示接口的配置。interface-type表示接口类型，
interface-number表示接口编号。
exclude modules：不显示指定模块的配置。modules表示模块名，可以一次输入多个模块名，模
块名之间用空格隔开，形如display current-configuration exclude a b，表示除了a和b模块的
内容，其它生效的配置均显示。目前modules支持取值：
•
acl：表示不显示ACL模块的配置。
by-linenum：显示每一行信息的行号。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display current-configuration命令用来显示设备当前生效的配置。
当用户完成一组配置之后，需要验证是否配置正确，则可以执行display current-configuration
命令来查看当前生效的参数。对于某些当前配置的参数，如果与缺省参数相同，则不显示。对于某
些参数，虽然用户已经配置，但如果实际生效的参数发生了改变，则显示实际生效的参数，如：在
某Loopback接口下配置的“ip address 11.11.11.11 24”，这时，执行display current-configuration
后看到的配置为“ip address 11.11.11.11 255.255.255.255”，实际生效的掩码为32位。
相关配置可参考命令save、reset saved-configuration和display saved-configuration。
【举例】
# 查看当前生效的配置中，从包含“user-interface”字符串的行开始到最后一行的配置信息。
user-interface aux 0
user-interface vty 0 15
authentication-mode none
user privilege level 3
#
return
# 查看当前设备上生效的SNMP配置。
snmp-agent
snmp-agent local-engineid 800063A203000FE240A1A6
snmp-agent community read public
snmp-agent community write private
snmp-agent sys-info version all
1.1.9 display default-configuration
【命令】
display default-configuration [ | { begin | exclude | include } regular-expression ]
1-7
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display default-configuration命令用来显示设备的出厂配置。
使用display default-configuration命令可以查看到使用出厂配置启动设备时所有要被执行的命
令。
相关配置可参考命令display current-configuration（显示当前生效的配置）和display
saved-configuration（显示保存的生效的配置）。
【举例】
# 显示设备的出厂配置。
#
domain default enable system
#
telnet server enable
#
undo ip redirects
undo ip ttl-expires
undo ip unreachables
#
vlan 1
#
radius scheme system
server-type extended
primary authentication 127.0.0.1 1645
primary accounting 127.0.0.1 1646
user-name-format without-domain
#
domain system
access-limit disable
state active
idle-cut disable
---- More ----
1-8
1.1.10 display saved-configuration
【命令】
display saved-configuration [ by-linenum ] [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
by-linenum：显示每一行信息的行号。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display saved-configuration命令用来查看设备存储介质中保存的下次启动配置文件的内容。
可以在管理/维护设备时使用该命令确认重要的配置是否已经保存到下次启动配置文件。执行该命令
将显示下次主用启动配置文件的内容。
如果设备未设置下次启动配置文件，或下次启动配置文件不存在，执行display
saved-configuration命令会显示设备的缺省配置文件。如果缺省配置文件也不存在，系统会提示
指定的配置文件不存在。
相关配置可参考命令save、reset saved-configuration和display current-configuration。
【举例】
# 显示设备存储介质中保存的下次启动配置文件的内容。（本命令的显示信息请以设备的实际情况为
准）。
#
version 5.20, Alpha 2607P01
#
sysname WX5540E_LSW
#
domain default enable system
#
ipv6 prefer temporary-address
#
telnet server enable
#
vlan 1
#
1-9
vlan 100
arp-snooping enable
#
radius scheme system
server-type extended
primary authentication 127.0.0.1 1645
primary accounting 127.0.0.1 1646
user-name-format without-domain
#
domain system
---- More ----
以上显示的配置依次是全局配置、端口配置、用户接口配置。“---- More ----”表示这一屏信息已经
显示完毕，会暂停显示。按
息；按
# 使用行号显示设备存储介质中保存的下次启动配置文件的内容。（本命令的显示信息请以设备的实
际情况为准）。
1: #
2: version 5.20, Alpha 2607P01
3: #
4: sysname WX5540E_LSW
5: #
6: domain default enable system
7: #
8: telnet server enable
9: #
10: vlan 1
11: #
12: vlan 100
13: arp-snooping enable
14: #
15: radius scheme system
16: server-type extended
17: primary authentication 127.0.0.1 1645
18: primary accounting 127.0.0.1 1646
19: user-name-format without-domain
20: #
21: domain system
---- More ----
“---- More ----”表示这一屏信息已经显示完毕，会暂停显示。按
按
1.1.11 display startup
【命令】
display startup [ | { begin | exclude | include } regular-expression ]
1-10
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display startup命令用来显示用于本次及下次启动的配置文件名。
相关配置可参考命令startup saved-configuration。
【举例】
# 显示本次及下次启动的配置文件名。
MainBoard:
Current startup saved-configuration file: flash:/
Next main startup saved-configuration file: flash:/
Next backup startup saved-configuration file: NULL
表1-2 display startup命令显示信息描述表
字段
MainBoard
Current startup saved-configuration file
Next main startup saved-configuration file
Next backup startup saved-configuration file
描述
设备使用的本次及下次启动的配置文件名
当前启动使用的配置文件
下一次启动时使用的主用配置文件
下一次启动时使用的备用配置文件
表示配置文件不存在
(This file does not exist.)
如果用户在配置完下次启动配置文件后又将该文件删除了，这
种情况下会在文件名后显示该信息
1.1.12 display this
【命令】
display this [ by-linenum ] [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
1-11
【缺省级别】
1：监控级
【参数】
by-linenum：显示每一行信息的行编号。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display this命令用来显示当前视图下生效的配置。
当用户在某一视图下完成一组配置之后，需要验证是否配置成功，则可以执行display this命令来
查看当前生效的配置。
需要注意以下几点：
•
•
•
•
对于已经生效的配置如果与缺省情况相同，则不显示；
对于某些参数，虽然用户已经配置，但如果这些参数所在的功能没有生效，则不显示；
在任意一个用户界面视图下执行此命令，将会显示所有用户界面下生效的配置；
在任意一个VLAN视图下执行此命令，将会显示所有已创建的VLAN下的配置。
【举例】
# 显示接口GigabitEthernet1/0/1下生效的配置（该显示信息与设备当前的配置有关）。
[Sysname] interface GigabitEthernet 1/0/1
[Sysname-GigabitEthernet1/0/1] display this
#
interface GigabitEthernet1/0/1
port link-mode bridge
port link-type hybrid
undo port hybrid vlan 1
port hybrid vlan 2 to 4 untagged
port hybrid pvid vlan 2
#
return
# 显示所有用户界面下生效的配置（该显示信息与设备当前的配置有关）。
[Sysname] user-interface vty 0
[Sysname-ui-vty0] display this
#
user-interface vty 0 15
user privilege level 3
user-interface vty 1 15
#
1-12
return
1.1.13 reset saved-configuration
【命令】
reset saved-configuration [ backup | main ]
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
backup：删除备用下次启动配置文件。
main：删除主用下次启动配置文件。
【描述】
reset saved-configuration命令用来删除设备存储介质中保存的下次启动配置文件。
需要注意的是：
•
•
•
删除操作会将下次启动配置文件从设备上彻底删除，所以请慎用该命令。
如果当前设备的主备用下次启动配置文件相同，仅执行一次删除操作，系统只会将相应的下次
启动配置文件设置为NULL，但不会删除该文件。
reset saved-configuration和reset saved-configuration main命令执行效果相同：都会删
除主用下次启动配置文件。
相关配置可参考命令save和display saved-configuration。
【举例】
# 删除设备存储介质中保存的下次备用启动配置文件。
The saved configuration file will be erased. Are you sure? [Y/N]:y
Configuration file in flash is being cleared.
Please wait ...
..
MainBoard:
Configuration file is cleared.
1.1.14 restore startup-configuration
【命令】
restore startup-configuration from src-addr src-filename
【视图】
用户视图
【缺省级别】
3：管理级
1-13
【参数】
src-addr：TFTP服务器的IP地址或名称，取值范围1～20。
src-filename：源文件名
，
指定服务器上将下载的文件的文件名。
【描述】
restore startup-configuration命令用于从指定TFTP服务器上下载配置文件并设置为设备的下次
启动配置文件。
•
•
执行该命令设置的是主用下次启动配置文件。
执行该命令会将指定配置文件下载到设备存储介质的根目录下，并设置为设备的下次启动配置
文件。
如果设备上已经存在与源文件同名的文件，则提示用户，由用户选择是否覆盖。另外，检查重名文
件时，均默认使用相同类型的存储介质。
【举例】
# 从IP地址为2.2.2.2的TFTP服务器上下载文件作为设备的主用下次启动配置文件。
Restore next startup-configuration file from 2.2.2.2. finished!
1.1.15 save
【命令】
save file-url
save [ safely ] [ backup | main ] [ force ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
file-url：文件路径，必须以“.cfg”为后缀。
safely：以安全模式保存配置文件。如果不指定该参数，表示以快速保存方式保存配置文件。
backup：将当前配置保存到交互方式下指定的文件中，并将该文件设置为备用下次启动配置文件。
main：将当前配置保存到交互方式下指定的文件中，并将该文件设置为主用下次启动配置文件。
force：表示直接将当前配置保存到下次启动配置文件，系统不再输出交互信息。缺省情况下，用
户执行save命令，系统要求用户输入
系统会自动退出本次操作。如果在执行save操作时使用了force参数，则系统会直接保存当前配
置，不再需要用户输入任何信息。
【描述】
save file-url命令用来将当前配置保存到指定文件，但不会将该文件设置为下次启动配置文件。如
果file-url不存在，则系统会先创建该文件，再执行保存操作。
save [ safely ] [ backup | main ] [ force ]命令用来将当前配置保存到存储介质的根目录，并将该文
件设置为下次启动配置文件。不指定backup或main参数时，则缺省使用main。
1-14
相关配置可参考命令reset saved-configuration、display current-configuration和display
saved-configuration。
【举例】
# 将当前配置保存到存储介质的根目录，并将该文件设置为下次启动配置文件。
MainBoard:
Current startup saved-configuration file: NULL
Next main startup saved-configuration file: flash:/
Next backup startup saved-configuration file: NULL
//
以上显示信息表明设备的主用下次启动文件均为
。
The current configuration will be written to the device. Are you sure? [Y/N]:y
Please input the file name(*.cfg)[flash:/]
(To leave the existing filename unchanged, press the enter key):
flash:/ exists, overwrite? [Y/N]:y
Validating file.
Saved the current configuration to mainboard device successfully.
MainBoard:
Current startup saved-configuration file: NULL
Next main startup saved-configuration file: flash:/
Next backup startup saved-configuration file: NULL
//
以上显示信息表明设备的主用下次启动文件均已经改为
。
1.1.16 startup saved-configuration
【命令】
startup saved-configuration cfgfile [ backup | main ]
undo startup saved-configuration
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
cfgfile：配置文件的名称，该文件必须是存储介质根目录下、后缀为.cfg的文件。
backup：将配置文件设置为备用下次启动配置文件。
main：将配置文件设置为主用下次启动配置文件。
【描述】
startup saved-configuration命令用来配置设备的下次启动配置文件（系统下次启动时使用的配
置文件）。undo startup saved-configuration命令用来设置设备以空配置启动（空配置启动指使
用设备的出厂配置启动）。
使用本命令前，请确保指定的配置文件已经保存在设备存储介质的根目录下，否则，操作失败。
1-15
使用该命令设置配置文件时：
•
•
startup saved-configuration和startup saved-configuration main命令执行效果相同：都
是用来配置主用下次启动配置文件。
主用下次启动配置文件和备用下次启动配置文件可以设置为同一文件，但为了更可靠，建议设
置为不同的文件，或者将一份配置保存在两个不同名的文件中，一个设置为主用，一个设置为
备用。
在执行undo startup saved-configuration命令之后，系统会将主用/备用下次启动配置文件
均设置为NULL，但不会删除该文件。
•
相关配置可参考命令display startup。
【举例】
# 配置下次启动使用的配置文件。
Please wait ...
Setting the master board ..........
... Done!
1-16
目 录
1 设备管理 ············································································································································ 1-1
1.1 设备管理配置命令 ····························································································································· 1-1
1.1.1 clock datetime ························································································································· 1-1
1.1.2 clock summer-time one-off ····································································································· 1-1
1.1.3 clock summer-time repeating ································································································· 1-2
1.1.4 clock timezone ························································································································ 1-4
1.1.5 copyright-info enable ·············································································································· 1-4
1.1.6 display alarm ·························································································································· 1-5
1.1.7 display clock ··························································································································· 1-6
1.1.8 display copyright ····················································································································· 1-7
1.1.9 display cpu-usage··················································································································· 1-8
1.1.10 display cpu-usage history ··································································································· 1-10
1.1.11 display device ····················································································································· 1-12
1.1.12 display device manuinfo ····································································································· 1-13
1.1.13 display diagnostic-information ···························································································· 1-14
1.1.14 display job ··························································································································· 1-15
1.1.15 display memory ·················································································································· 1-16
1.1.16 display reboot-type ············································································································· 1-17
1.1.17 display schedule job ··········································································································· 1-18
1.1.18 display schedule reboot ······································································································ 1-18
1.1.19 display system-failure ········································································································· 1-19
1.1.20 display transceiver ·············································································································· 1-20
1.1.21 display transceiver alarm ···································································································· 1-21
1.1.22 display transceiver diagnosis ····························································································· 1-23
1.1.23 display transceiver manuinfo ······························································································ 1-24
1.1.24 display version ···················································································································· 1-25
1.1.25 display version-update-record ···························································································· 1-26
1.1.26 header ································································································································ 1-27
1.1.27 job ······································································································································· 1-29
1.1.28 reboot ································································································································· 1-30
1.1.29 reset unused porttag ·········································································································· 1-30
1.1.30 reset version-update-record ······························································································· 1-31
1.1.31 schedule job ······················································································································· 1-31
i
1.1.32 schedule reboot at ·············································································································· 1-33
1.1.33 schedule reboot delay ········································································································ 1-34
1.1.34 shutdown-interval ··············································································································· 1-35
1.1.35 sysname ····························································································································· 1-36
1.1.36 system-failure ····················································································································· 1-36
1.1.37 time at ································································································································· 1-37
1.1.38 time delay ··························································································································· 1-39
1.1.39 view ···································································································································· 1-40
ii
1
设备管理
1.1
设备管理配置命令
1.1.1 clock datetime
【命令】
clock datetime time date
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
time：设置的时间，格式为HH:MM:SS（小时:分钟:秒），HH取值范围为0～23，MM和SS取值
范围为0～59。如果是零点，整个time参数可简写为0。
date：设置的日期，格式为MM/DD/YYYY（月/日/年）或者YYYY/MM/DD（年/月/日），MM的取
值范围为1～12，DD的取值范围与月份有关，YYYY的取值范围为2000～2035。
【描述】
clock datetime命令用来设置时间和日期。
在需要严格获取绝对时间的应用环境中，必须设定设备当前日期和时钟。在输入时间参数时，可以
不输入秒。
相关配置可参考命令clock summer-time one-off、clock summer-time repeating、clock
timezone和display clock。
【举例】
# 设置设备的系统时间为2013年1月1日14时10分20秒。
# 设置设备的系统时间为2013年1月1日零点6分。
1.1.2 clock summer-time one-off
【命令】
clock summer-time zone-name one-off start-time start-date end-time end-date add-time
undo clock summer-time
【视图】
系统视图
【缺省级别】
3：管理级
1-1
【参数】
zone-name：夏令时名称，为1～32个字符的字符串，区分大小写。
start-time：起始时间，格式为HH:MM:SS，除表示零点外，格式中的其它0可以省略不写。
start-date：起始日期，格式为YYYY/MM/DD或MM/DD/YYYY。
end-time：结束时间，格式为HH:MM:SS，除表示零点外，格式中的其它0可以省略不写。
end-date：结束日期，格式为YYYY/MM/DD或MM/DD/YYYY。
add-time：相对于标准时间增加的时间，格式为HH:MM:SS，除表示零点外，格式中的其它0可以
省略不写。
【描述】
clock summer-time one-off命令用来设置从“起始日期”的“起始时间”到“结束日期”的“结
束时间”这个时间段内采用夏令时制，夏令时间要比设备的当前时间增加“add-time”。undo clock
summer-time命令用来取消夏令时设置。
缺省情况下，设备上没有配置夏令时，本地采用UTC（Universal Time Coordinated，世界调整时
间）时间。
设置完成后，可以使用display clock命令进行查看。日志、debug等信息时间将采用经过时区和
夏令时调整过的本地时间。
需要注意的是：
•
•
从“起始日期”的“起始时间”到“结束日期”的“结束时间”这个时间段长度必须大于1
天小于1年，否则视为无效参数，配置失败。
如果当前系统时间在该命令指定的时间段内，则执行该命令后，系统时间将自动增加
“add-time”。
相关配置可参考命令clock datetime、clock summer-time repeating、clock timezone和display
clock。
【举例】
# 设置夏令时abc1，从2013年8月1日的06:00:00开始，到2013年9月1日的06:00:00结束，
比当前设备标准时间增加1小时。
[Sysname] clock summer-time abc1 one-off 6 08/01/2013 6 09/01/2013 1
1.1.3 clock summer-time repeating
【命令】
clock summer-time zone-name repeating start-time start-date end-time end-date add-time
undo clock summer-time
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
zone-name：夏令时名称，为1～32个字符的字符串。
1-2
start-time：起始时间，格式为HH:MM:SS，除表示零点外，格式中的其它0可以省略不写。
start-date：起始日期，有两种设置方式：
•
•
直接一次性输入年月日，参数格式为YYYY/MM/DD或MM/DD/YYYY。
分次输入年、月、日，各参数之间以<空格>键隔开。首先输入开始的年份，取值范围2000～
2035；其次输入开始的月份，取值如下：January、February、March、April、May、June、
July、August、September、October、November、December；然后输入开始的星期（用
当月的第几个星期表示），取值如下：first、second、third、fourth、fifth、last；最后输入
起始日，取值为Sunday、Monday、Tuesday、Wednesday、Thursday、Friday、Saturday。
end-time：结束时间，格式为HH:MM:SS，除表示零点外，格式中的其它0可以省略不写。
end-date：结束日期，有两种设置方式：
•
•
直接一次性输入年月日，参数格式为YYYY/MM/DD或MM/DD/YYYY。
分次输入年、月、日，各参数之间以<空格>键隔开。首先输入结束的年份，取值范围2000～
2035；其次输入结束的月份，取值如下：January、February、March、April、May、June、
July、August、September、October、November、December；然后输入结束的星期（用
当月的第几个星期表示），取值如下：first、second、third、fourth、fifth、last；最后输入
结束日，取值为：Sunday、Monday、Tuesday、Wednesday、Thursday、Friday、Saturday。
add-time：相对于设备当前标准时间增加的时间，格式为HH:MM:SS，除表示零点外，格式中的其
它0可以省略不写。
【描述】
clock summer-time repeating命令用来设置设备重复采用夏令时制。undo clock summer-time
命令用来取消夏令时设置。
缺省情况下，设备上没有配置夏令时，本地采用UTC（Universal Time Coordinated，世界调整时
间）时间。
比如，当指定“start-date”和“start-time”为“2013/6/6”和“00:00:00”，指定“end-date”和
“end-time”为“2013/10/1
”和“00:00:00”，指定“add-time”为“01:00:00”，则表示从2013
年开始（包括2013年）以后每年的6月6号的零点整到10月1号的零点整，都采用夏令时制，夏
令时间要比设备的当前标准时间增加1小时。
设置完成后，可以使用display clock命令进行查看。日志、debug等信息时间将采用经过时区和
夏令时调整过的本地时间。
需要注意的是：
•
•
从“起始日期”的“起始时间”到“结束日期”的“结束时间”这个时间段长度必须大于1
天小于1年，否则视为无效参数，配置失败。
如果当前系统时间在该命令作用的时间段内，则执行该命令后，系统时间将自动增加
“add-time”。
相关配置可参考命令clock datetime、clock summer-time one-off、clock timezone和display
clock。
【举例】
# 设置夏令时abc2，从2013年开始（包括2013年）以后每年的8月1日的06:00:00到9月1日
的06:00:00，比当前系统时间增加1小时。
[Sysname] clock summer-time abc2 repeating 06:00:00 08/01/2013 06:00:00 09/01/2013 01:00:00
1-3
1.1.4 clock timezone
【命令】
clock timezone zone-name { add | minus } zone-offset
undo clock timezone
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
zone-name：时区名称，为1～32个字符的字符串，区分大小写。
add：在UTC（Universal Time Coordinated，通用协调时间）标准时间的基础上增加指定时间。
minus：在UTC标准时间的基础上减少指定时间。
zone-offset：与UTC的时间差，格式为HH:MM:SS，HH取值范围为0～23，MM和SS取值范围
为0～59，除表示零点外，格式中的其它0可以省略不写。
【描述】
clock timezone命令用来对本地时区信息进行设置。undo clock timezone命令用来恢复缺省情
况。
缺省情况下，本地时区采用UTC（Universal Time Coordinated，世界调整时间）时区。
设置生效后，可以用display clock命令进行查看。日志、debug等信息时间将采用经过时区和夏
令时调整过的本地时间。
相关配置可参考命令clock datetime、clock summer-time one-off、clock summer-time
repeating和display clock。
【举例】
# 设置本地时区名称为Z5，比UTC标准时间增加5小时。
[Sysname] clock timezone Z5 add 5
1.1.5 copyright-info enable
【命令】
copyright-info enable
undo copyright-info enable
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
无
1-4
【描述】
copyright-info enable命令用来使能显示版权信息。undo copyright-info enable命令用来禁止
显示版权信息。
缺省情况下，显示版权信息处于使能状态。
【举例】
# 配置使能显示版权信息。
[Sysname] copyright-info enable
•
使用Telnet方式登录设备，会显示如下信息：
**************************************************************************
* Copyright (c) 2004-2013 Hangzhou H3C Tech. Co., Ltd. All rights reserved.*
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
****************************************************************************
•
如果当前已经使用OAP方式登录设备了，再退出用户视图，会显示如下信息：
**************************************************************************
* Copyright (c) 2004-2013 Hangzhou H3C Tech. Co., Ltd. All rights reserved.*
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
****************************************************************************
User interface aux0 is available.
Please press ENTER.
# 禁止显示版权信息。
[Sysname] undo copyright-info enable
•
•
使用Telnet方式登录设备，会显示如下信息：
如果当前已经使用OAP方式登录设备了，再退出用户视图，会显示如下信息：
User interface aux0 is available.
Please press ENTER.
1.1.6 display alarm
【命令】
display alarm [ | { begin | exclude | include } regular-expression ]
1-5
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display alarm命令用来显示设备的告警信息。
用户执行该命令后，系统会自动查询并显示设备上的当前告警信息。
【举例】
# 显示设备的告警信息（本命令的显示信息与设备型号有关，请以设备的实际情况为准）。
Slot Level Info
6 ERROR Fan 2 is absent.
6 ERROR Power 2 is absent.
3 WARNING The temperature of sensor 3 exceeds the lower limit.
表1-1 display alarm命令显示信息描述表
字段
Slot
Level
Info
Fan n is absent.
Power n is absent.
感知该告警的设备号
告警的级别，级别由高到低依次为ERROR、WARNING、NOTICE、INFO
告警的详细信息
风扇n当前不在位
电源n当前不在位
描述
The temperature of sensor n
传感器 n的温度低于低温门限
exceeds the lower limit.
The temperature of sensor n
传感器 n的温度高于高温门限
exceeds the upper limit.
1.1.7 display clock
【命令】
display clock [ | { begin | exclude | include } regular-expression ]
1-6
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display clock命令用来显示系统当前的时间和日期。
该时间由clock datetime、clock summer-time one-off（或者clock summer-time repeating）
和clock timezone命令联合决定，规则请参见配置手册中的“配置系统时间”一节。
相关配置可参考命令clock datetime、clock summer-time one-off、clock summer-time
repeating和clock timezone。
【举例】
# 查看系统当前日期和时间。
09:41:23 UTC Thu 12/15/2013
1.1.8 display copyright
【命令】
display copyright [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
1-7
【描述】
display copyright命令用来显示系统软件和硬件的详细版权信息。
通过查看版权信息，可以获知系统当前使用软件和硬件版本的版权信息、版权的参照标准、版权证
书等相关信息。
【举例】
# 显示系统软件和硬件的详细版权信息。（显示信息略，请以设备的实际情况为准）
1.1.9 display cpu-usage
【命令】
display cpu-usage [ slot slot-number [ cpu cpu-number ] ] [ | { begin | exclude | include }
regular-expression ]
display cpu-usage entry-number [ offset ] [ verbose ] [ slot slot-number [ cpu cpu-number ] ] [ |
{ begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
entry-number：指定执行一次本命令将显示的条目数，取值范围为1～60。
offset：起始显示条目序号到最新条目序号之间的偏移量，取值范围为0～59。比如，最新生成的统
计信息的idx是12，如果offset设置为3，则会从idx是9的统计信息开始显示（idx表示的是第几
个周期的统计信息，从0到60循环计数。系统按周期统计CPU利用率，当一个周期结束时，就会
记录该周期内CPU的平均利用率，idx会自动加1）。
verbose：显示CPU利用率的详细信息。不使用该参数时，
显示的是简要的CPU利用率统计信息，
使用该参数时，会详细显示指定统计周期内各个任务的平均CPU利用率。
slot slot-number：取值恒定为1，表示WX5540E交换引擎。
cpu cpu-number：显示指定CPU的利用率统计信息。cpu-number表示CPU的编号取值范围为0～
3。不使用该参数时，显示指定WX5540E交换引擎所有CPU的相应信息。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display cpu-usage命令用来显示CPU利用率的统计信息。
1-8
系统每隔一定的时间（通常为60秒）对CPU的利用率进行统计，并把统计结果保存到历史记录区。
display cpu-usage entry-number表示从最新记录（倒数第一条记录）开始，显示entry-number
条记录。display cpu-usage entry-number offset表示从倒数第（offset+1）条记录开始，显示
entry-number条记录。
【举例】
# 显示当前CPU利用率统计信息。
Slot 1 CPU usage:
6% in last 5 seconds
10% in last 1 minute
5% in last 5 minutes
# 显示CPU利用率统计信息历史记录区中的倒数第5和倒数第6号记录。
===== CPU usage info (no: 0 idx: 58) =====
CPU Usage Stat. Cycle: 60 (Second)
CPU Usage : 3%
CPU Usage Stat. Time : 2013-07-10 10:56:55
CPU Usage Stat. Tick : 0x1d9d(CPU Tick High) 0x3a659a70(CPU Tick Low)
Actual Stat. Cycle : 0x0(CPU Tick High) 0x95030517(CPU Tick Low)
===== CPU usage info (no: 1 idx: 57) =====
CPU Usage Stat. Cycle: 60 (Second)
CPU Usage : 3%
CPU Usage Stat. Time : 2013-07-10 10:55:55
CPU Usage Stat. Tick : 0x1d9c(CPU Tick High) 0xa50e5351(CPU Tick Low)
Actual Stat. Cycle : 0x0(CPU Tick High) 0x950906af(CPU Tick Low)
表1-2 display cpu-usage命令显示信息描述表
字段
1% in last 5 seconds
1% in last 1 minute
1% in last 5 minutes
Slot 1 CPU usage
CPU usage info (no: idx:)
描述
设备启动后，会以5秒为周期计算并记录一次该5秒内的CPU的平均利用率。
该字段显示的是最近一个5秒统计周期内CPU的平均利用率
设备启动后，会以1分钟为周期计算并记录一次该1分钟内的CPU的平均利用
率。该字段显示的是最近一个1分钟统计周期内CPU的平均利用率
设备启动后，会以5分钟为周期计算并记录一次该5分钟内的CPU的平均利用
率。该字段显示的是最近一个5分钟统计周期内CPU的平均利用率
设备的CPU利用率信息
CPU利用率纪录的信息（no：第no+1条记录，no从0开始编号，记录越新编
号越小；idx：本次记录在历史记录表中的索引）（如果只显示系统当前CPU
的利用率信息，则no和idx的显示省略）
CPU利用率统计的时间区间（单位为秒），比如Cycle值为41，则表示统计
的是最近41秒时间内CPU利用率的平均值。该参数的取之范围为1～60
CPU利用率统计的时间区间内，CPU利用率的平均值（单位为%）
CPU利用率统计结束时间（单位为秒），即执行显示命令时的系统时间
CPU Usage Stat. Cycle
CPU Usage
CPU Usage Stat. Time
1-9
字段
CPU Usage Stat. Tick
描述
系统运行时间（单位tick，用64位的十六进制数表示，其中CPU Tick High表
示高32位，CPU Tick Low表示低32位）
CPU利用率统计的实际时间区间（单位tick，用64位的十六进制数表示，其
中CPU Tick High表示高32位，CPU Tick Low表示低32位）（因为它的精度
高于秒，所以不同记录的实际周期会有细微差别）
Actual Stat. Cycle
1.1.10 display cpu-usage history
【命令】
display cpu-usage history [ task task-id ] [ slot slot-number [ cpu cpu-number ] ] [ | { begin |
exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
task task-id：显示指定任务的CPU利用率的统计历史信息，task-id表示任务编号。不使用该参数
时，显示的是整个系统的相应信息（整个系统的CPU利用率等于所有任务CPU利用率之和）。
slot slot-number：显示设备的CPU利用率的统计历史信息。slot-number固定为1。
cpu cpu-number：显示指定CPU的利用率统计历史信息。cpu-number表示CPU的编号，取值范
围为0～3。不带该参数时，显示的是主CPU的相应信息。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display cpu-usage history
命令用来以图形方式显示CPU利用率统计历史信息。
不指定参数时，将显示系统CPU利用率统计信息。
系统每隔一定时间会对CPU的利用率进行统计，并把统计结果保存到历史记录区。通过display
cpu-usage history命令可以查看到最近60分钟记录的CPU利用率统计值。结果以坐标的形式进
行显示，显示信息中：
•
•
•
纵坐标表示利用率，采用就近显示的原则。比如，利用率的间隔为5％，则实际统计值53％
将被显示成55％，实际统计值52％将被显示成50％。
横坐标表示时间，时间越靠左表示距离当前时间越近。
用连续的＃号表示该时刻的利用率，某个时间点上最高处的#号对应的纵坐标值即为该时刻
CPU的利用率。
1-10
【举例】
# 显示整个系统的CPU利用率统计信息。
100%|
95%|
90%|
85%|
80%|
75%|
70%|
65%|
60%|
55%|
50%|
45%|
40%|
35%|
30%|
25%|
20%|
15%| #
10%| ### #
5%| ########
------------------------------------------------------------
10 20 30 40 50 60 (minutes)
cpu-usage last 60 minutes(SYSTEM)
以上显示信息表明整个系统（任务名为SYSTEM）在最近60分钟内CPU的占有率情况：12分钟
前大约为5％，13分钟前大约为10％，14分钟前大约为15％，15分钟前大约为10％，16、17
分钟前大约为5％，18分钟前大约为10％，19分钟前大约为5％，其它时间均小于或等于2％。
# 显示编号为6的任务的CPU利用率统计信息。
100%|
95%|
90%|
85%|
80%|
75%|
70%|
65%|
60%|
55%|
50%|
45%|
40%|
35%|
30%|
25%|
1-11
20%|
15%|
10%|
5%| #
------------------------------------------------------------
10 20 30 40 50 60 (minutes)
cpu-usage last 60 minutes(T03M)
以上显示信息表明编号为6的任务（任务名为T03M）在最近60分钟内CPU的占有率情况：20
分钟前大约为5％，其它时间均小于或等于2％。
1.1.11 display device
【命令】
display device [ verbose ] [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
verbose：显示详细信息。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display device命令用来显示设备信息。
【举例】
# 显示设备的设备信息（注意：本命令的显示信息与设备型号有关，请以设备的实际情况为准）。
Slot 1
SubSNo PortNum PCBVer FPGAVer CPLDVer BootRomVer AddrLM Type State
0 33 Ver.A NULL 003 003 1.02 IVL MAIN Normal
表1-3 display device命令显示信息描述表
字段
Slot 1
SubSNo
PortNum
设备信息
主机所在的槽位号
主机支持的最大端口数
1-12
描述
字段
PCBVer
FPGAVer
CPLDVer
BootRomVer
描述
主机的PCB（Printed Circuit Board，印刷电路板）版本
主机的FPGA版本
主机的CPLD版本
主机的BootRom版本
地址学习模式
AddrLM
•
IVL（Independant VLAN Learning）：独立VLAN学习模式
•
SVL（Shared VLAN Learning）：共享VLAN学习模式
Type 主机的类型
主机的状态
State
•
Normal：表示工作正常
•
Absent：表示不在位
•
Fault：表示出现故障
1.1.12 display device manuinfo
【命令】
display device manuinfo slot slot-number [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
3：管理级
【参数】
slot slot-number：显示设备的电子标签信息。slot-number固定为１。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display device manuinfo命令用来显示设备的电子标签信息。
电子标签信息也可以称为永久配置数据或档案信息等，在设备的调测（调试、测试）过程中被写入
到设备的存储器件中，包括设备的名称、生产序列号、MAC地址、制造商等信息。本命令显示的
是设备的部分电子标签信息。
【举例】
# 显示设备的电子标签信息（本命令的显示信息与设备型号有关，请以设备的实际情况为准）。
1-13
Slot 1:
DEVICE_NAME : WX5540E_LSW
DEVICE_SERIAL_NUMBER : DPPMWWB123456
MAC_ADDRESS : 00E0-FC00-5800
MANUFACTURING_DATE : 2013-05-08
VENDOR_NAME : H3C
表1-4 display device manuinfo命令信息显示描述表
字段
Slot
DEVICE_NAME
DEVICE_SERIAL_NUMBER
MAC_ADDRESS
MANUFACTURING_DATE
VENDOR_NAME
设备编号
设备名称
社备序列号
设备出厂MAC地址
设备调测日期
制造商名称
描述
1.1.13 display diagnostic-information
【命令】
display diagnostic-information [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display diagnostic-information命令用来显示或保存系统当前多个功能模块运行的统计信息。
在日常维护或系统出现故障时，为了便于问题定位，用户需要查看各个功能模块的运行信息。但各
个功能模块都有对应的display命令，逐条执行比较繁琐。为便于一次性收集更多信息，用户可以
在任意视图下执行display diagnostic-information命令，显示或保存系统当前多个功能模块运行
的统计信息。
1-14
【举例】
# 保存系统当前各个功能模块运行的统计信息。
Save or display diagnostic information (Y=save, N=display)? [Y/N]:y
Please input the file name(*.diag)[flash:/]:
Diagnostic information is outputting to flash:/.
Save succeeded.
再在用户视图下执行“more ”命令，配合使用
文件的记录的内容。
# 显示系统当前各个功能模块运行的统计信息（因为显示信息多，而且跟设备型号有关，请以设备
的实际情况为准，此处略）。
Save or display diagnostic information (Y=save, N=display)? [Y/N]:n
=================================================
===============display clock===============
=================================================
08:54:16 UTC Fri 11/15/2013
===================================================
===============display version===============
===================================================
……略……
1.1.14 display job
【命令】
display job [ job-name ] [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【命令级别】
1：监控级
【参数】
job-name：任务名，为1～32个字符的字符串。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display job命令用来查看定时执行任务的具体配置。
不带参数时表示查看当前所有定时执行任务的具体配置。
1-15
相关配置可参考命令job、time和view。
【举例】
# 查看定时执行任务saveconfig的具体配置。
Job name: saveconfig
Specified view: monitor
Time 1: Execute command save after 40 minutes
以上显示信息表明，40分钟后系统将自动将当前运行的配置保存到配置文件。
表1-5 display job命令显示信息描述表
字段
Job name
Specified view
Time timeID
Execute command
定时执行任务名
定时执行任务中命令所在视图
定时执行任务中包含的各命令执行时间记录
命令字符串
说明
1.1.15 display memory
【命令】
display memory [ slot slot-number [ cpu cpu-number ] ] [ | { begin | exclude | include }
regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
slot slot-number：显示设备的CPU的内存使用状况。slot-number固定为1。
cpu cpu-number：显示指定CPU的内存使用状况。cpu-number表示CPU的编号。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display memory命令用来显示设备内存的使用状况。
不带cpu参数时，显示的是主CPU的相应信息。
1-16
【举例】
# 显示设备内存的使用状况。
System Total Memory(bytes): 337495520
Total Used Memory(bytes): 108441564
Used Rate: 32%
表1-6 display memory命令显示信息描述表
字段
System Total Memory(bytes)
Total Used Memory(bytes)
Used Rate
描述
系统的总内存大小，单位为字节
已经使用的内存大小，单位为字节
已经使用的内存占总内存的比例
1.1.16 display reboot-type
【命令】
display reboot-type [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display reboot-type命令用来显示系统的启动方式。
【举例】
# 显示设备的启动方式。
The rebooting type this time is: Cold
以上显示信息表明：设备最近一次的重启方式为冷启动（Cold，表示本次是通过上电方式启动的设
备）。（当显示Warm时表示启动方式为热启动，表示本次是通过reboot等命令启动的设备）
1-17
1.1.17 display schedule job
【命令】
display schedule job [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display schedule job用来查看定时执行功能的具体配置。
相关配置可参考命令schedule job。
【举例】
# 查看当前定时执行功能的具体配置。
Specified command: execute
Specified view: system view
Executed time: at 12:00 10/31/2013 (in 0 hours and 16 minutes)
如果在16分钟内修改了系统时间，则定时执行批处理文件的配置将失效。再次使用display
schedule job命令查看时，显示为空。
表1-7 display schedule job命令显示信息描述表
字段
Specified command
Specified view
Executed time
定时执行的命令字符串
为定时执行的命令指定的视图
系统自动执行指定命令的时间点及与当前系统时间的间隔
描述
1.1.18 display schedule reboot
【命令】
display schedule reboot [ | { begin | exclude | include } regular-expression ]
1-18
【视图】
任意视图
【缺省级别】
3：管理级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display schedule reboot命令用来显示用户设置的设备重启时间。
相关配置可参考命令schedule reboot at和schedule reboot delay。
【举例】
# 显示设备的重启时间。
System will reboot at 16:00:00 03/10/2013 (in 2 hours and 5 minutes).
以上显示信息表明，系统将在2013年3月10日16点（2小时零5分钟之后）重启。
1.1.19 display system-failure
【命令】
display system-failure [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
3：管理级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display system-failure命令用来显示设备系统异常时的处理方式。
相关配置可参考命令system-failure。
1-19
【举例】
# 显示异常情况下系统的处理方式。
System failure handling method: reboot
1.1.20 display transceiver
【命令】
display transceiver interface [ interface-type interface-number ] [ | { begin | exclude | include }
regular-expression ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
interface [ interface-type interface-number ]：显示接口上插入的可插拔接口模块的主要特征参数。
interface-type interface-number：表示接口类型和接口编号，如果不指定该参数，表示显示所有接
口下的该信息。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display transceiver命令用来显示可插拔接口模块的主要特征参数。
【举例】
# 显示接口GigabitEthernet1/0/22上插入的可插拔接口模块的主要特征参数（本命令的显示信息与
设备型号有关，请以设备的实际情况为准）。
GigabitEthernet1/0/22 transceiver information:
Transceiver Type : 1000_BASE_SX_SFP
Connector Type : LC
Wavelength(nm) : 850
Transfer Distance(m) : 550(50um),270(62.5um)
Digital Diagnostic Monitoring : YES
Vendor Name : H3C
Ordering Name : SFP-GE-SX-MM850
1-20
表1-8 display transceiver命令显示信息描述表
字段
transceiver information
Transceiver Type
可插拔接口模块信息
可插拔接口模块的物理型号
可插拔接口模块的连接器类型，其中：
描述
•
光纤连接器包括SC（SC Connector，NTT公司推出的拔插锁紧式光纤连接
Connector Type
器）、LC（LC Connector，Lucent公司推出的1.25mm/RJ45锁紧式光纤连接
器）两种类型
•
其他连接器包括RJ-45、CX4等类型
•
光模块：显示发送激光中心波长，单位nm；对于支持多条不同波长光路的模
Wavelength(nm)
块（例如10GBASE-LX4模块），各个波长值之间用逗号分隔
•
电模块：显示为“N/A”
传输距离，对于单模模块，xx显示为km，其他模块xx显示为m。当模块支持多种
传输介质时，各个传输距离值之间用逗号分隔。距离值后面括号里包含对应的“传
输介质”。下面是各个介质的名称：
•
9um：表示9/125um单模光纤
Transfer Distance(xx)
•
50um：表示50/125um多模光纤
•
62.5um：表示62.5/125um多模光纤
•
TP：表示双绞线
•
CX4：表示CX4电缆
对数字诊断功能的支持情况，其中：
Digital Diagnostic
Monitoring
Vendor Name
Ordering Name
•
YES：表示支持数字诊断
•
NO：表示不支持数字诊断
模块生产或定制厂商名称
可插拔接口模块的对外型号
1.1.21 display transceiver alarm
【命令】
display transceiver alarm interface [ interface-type interface-number ] [ | { begin | exclude |
include } regular-expression ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
interface [ interface-type interface-number ]：显示接口上插入的可插拔接口模块的当前故障告警
信息。interface-type interface-number表示接口类型和接口编号，如果不指定该参数，表示显示所
有接口下的该信息。
1-21
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display transceiver alarm命令用来显示可插拔接口模块的当前故障告警信息。
如果没有故障，则显示为“None”。
目前，使用的可插拔接口模块可能出现的故障告警信息见表1-9
。
表1-9 display transceiver alarm命令输出信息描述表
字段
SFP/SFP+
RX loss of signal
RX power high
RX power low
TX fault
TX bias high
TX bias low
TX power high
TX power low
Temp high
Temp low
Voltage high
Voltage low
Transceiver info I/O error
Transceiver info checksum error
Transceiver type and port configuration
mismatch
Transceiver type not supported by port hardware
接收信号丢失
接收光功率高告警
接收光功率低告警
发送错误
偏置电流高告警
偏置电流低告警
发送光功率高告警
发送光功率低告警
温度高告警
温度低告警
电压高告警
电压低告警
模块信息读写错误
模块信息校验和错误
模块类型和端口配置不匹配
端口不支持该模块类型
描述
【举例】
# 显示接口GigabitEthernet1/0/22上插入的可插拔接口模块的当前故障告警信息（本命令的显示信
息与设备型号有关，请以设备的实际情况为准）。
GigabitEthernet1/0/22 transceiver current alarm information:
1-22
RX loss of signal
RX power low
表1-10 display transceiver alarm显示信息描述表
字段
transceiver current alarm information
RX loss of signal
RX power low
描述
接口光模块当前故障告警信息
接收信号丢失
接收光功率低告警
1.1.22 display transceiver diagnosis
【命令】
display transceiver diagnosis interface [ interface-type interface-number ] [ | { begin | exclude
| include } regular-expression ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
interface [ interface-type interface-number ]：显示接口上插入的可插拔光模块的数字诊断参数的
当前测量值。interface-type interface-number表示接口类型和接口编号，如果不指定该参数，表示
显示所有接口下的该信息。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display transceiver diagnosis命令用来显示可插拔光模块的数字诊断参数的当前测量值。
电子标签信息的显示与可插拔接口模块的类型有关，请以设备的实际情况为准。
【举例】
# 显示接口GigabitEthernet1/0/22上插入的可插拔光模块的数字诊断参数的当前测量值（本命令的
显示信息与设备型号有关，请以设备的实际情况为准）。
1-23
GigabitEthernet1/0/22 transceiver diagnostic information:
Current diagnostic parameters:
Temp(°C) Voltage(V) Bias(mA) RX power(dBM) TX power(dBM)
36 3.31 6.13 -35.64 -5.19
表1-11 display transceiver diagnosis显示信息描述表
字段
transceiver diagnostic information
Current diagnostic parameters
Temp.(°C)
Voltage(V)
Bias(mA)
RX power(dBM)
TX power(dBM)
描述
接口插入的光模块的数字诊断信息
当前的诊断参数
数字诊断参数——温度，单位为°C，精确到1°C
数字诊断参数——电压，单位为V，精确到0.01V
数字诊断参数——偏置电流，单位为mA，精确到0.01mA
数字诊断参数——接收光功率，单位为dBM，精确到0.01dBM
数字诊断参数——发送光功率，单位为dBM，精确到0.01dBM
1.1.23 display transceiver manuinfo
【命令】
display transceiver manuinfo interface [ interface-type interface-number ] [ | { begin | exclude
| include } regular-expression ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
interface [ interface-type interface-number ]：显示接口上插入的可插拔接口模块的部分电子标签
信息。interface-type interface-number表示接口类型和接口编号，如果不指定该参数，表示显示所
有接口下的该信息。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display transceiver manuinfo命令用于显示可插拔接口模块的部分电子标签信息。
1-24
数字诊断参数的显示与可插拔接口模块的类型有关，请以设备的实际情况为准。
【举例】
# 显示接口GigabitEthernet1/0/22上插入的可插拔接口模块的部分电子标签信息（本命令的显示信
息与设备型号有关，请以设备的实际情况为准）。
GigabitEthernet1/0/22 transceiver manufacture information:
Manu. Serial Number : 213410A1
Manufacturing Date : 2013-03-01
Vendor Name : H3C
表1-12 display transceiver manuinfo命令显示信息描述表
字段
Manu. Serial Number
Manufacturing Date
Vendor Name
描述
在调测（调试、测试）过程中生成的序列号
调测日期，取值为调测平台计算机的系统日期
定制厂商名称，即H3C
1.1.24 display version
【命令】
display version [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display version命令用来显示系统版本信息。
通过查看版本信息，可以获知系统当前使用的软件版本、机架类型及设备的相关信息。
1-25
【举例】
# 查看系统版本信息（不同设备的版本信息不同，请以设备的实际情况为准，此处略）。
H3C Comware Platform Software
Comware Software, Version 5.20, Alpha 2607P04
Copyright (c) 2004-2013 Hangzhou H3C Tech. Co., Ltd. All rights reserved.
H3C WX5540E-LSW uptime is 1 week, 1 day, 20 hours, 57 minutes
H3C WX5540E-LSW with 2 Processors
1024M bytes DDR3
16M bytes Nor Flash Memory
Config Register points to Nor Flash
Hardware Version is Ver.A
CPLDA Version is 003, CPLDB Version is 003
BootRom Version is 1.02
[SubSlot 0] 12GE+12SFP+4SFP Plus Hardware Version is Ver.A
表1-13 display version命令显示信息描述表
字段
H3C Comware Platform Software
Version 5.20, Alpha 2607P04
Copyright (c) 2004-2013 Hangzhou H3C
Tech. Co., Ltd. All rights reserved.
字段显示信息描述
交换机软件的运行平台
交换机软件的版本号
交换机的版权信息
H3C WX5540E-LSW uptime is 1 week, 1 day,
交换机本次启动后已运行时间
20 hours, 57 minutes
DDR3
Nor Flash Memory
Hardware Version
CPLDA Version
BootRom Version
[SubSlot 0]
交换机内存容量
交换机Nor Flash容量
交换机的硬件版本号
交换机上A型CPLD（Complex Programmable Logical Device，
复杂可编程逻辑器件）的版本
交换机BootRom的版本
交换机的端口类型、数量及硬件版本
1.1.25 display version-update-record
【命令】
display version-update-record [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
1-26
【缺省级别】
3：管理级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display version-update-record命令用来显示软件（即系统启动文件）版本更新操作的记录。
设备启动时会记录当前使用的软件版本信息，如果在运行过程中进行软件版本更新操作，系统会记
录该次更新的简要信息，包括升级时间和版本，以便管理员及时了解相关信息。
相关配置可参考reset version-update-record。
【举例】
# 显示设备软件版本更新操作的记录。
No. Update time version
1 2013-04-28 14:39:11 5.20 Release 0000
表1-14 display version-update-record命令显示信息描述表
字段
No.
Update time
version
显示信息的序列号
更新操作发生的时间
更新的版本
描述
1.1.26 header
【命令】
header { incoming | legal | login | motd | shell } text
undo header { incoming | legal | login | motd | shell }
【视图】
系统视图
【缺省级别】
2：系统级
【参数】
incoming：设置Modem登录用户登录进入用户视图时的欢迎信息。如果要求认证，则欢迎信息在
通过认证后输出。
1-27
legal：设置登录终端界面前的授权信息，在输入认证用户名和密码前输出。
login：设置登录验证时的欢迎信息。
motd：设置登录终端界面前的欢迎信息。
shell：设置非Modem登录用户登录进入用户视图时的欢迎信息。
text：输入欢迎信息的内容。内容的输入支持单行和多行两种方式，具体输入规则请参见“基础配
置指导”中的“设备管理”。
【描述】
header命令用来设置欢迎信息。undo header命令用来关闭欢迎信息。
【举例】
# 配置进入用户视图的欢迎信息。
[Sysname] header incoming %
Please input banner content, and quit with the character '%'.
Welcome to incoming(header incoming)%
[Sysname] header incoming %
Please input banner content, and quit with the character '%'.
Welcome to incoming(header incoming)%
[Sysname] header legal %
Please input banner content, and quit with the character '%'.
Welcome to legal (header legal)%
[Sysname] header login %
Please input banner content, and quit with the character '%'.
Welcome to login(header login)%
[Sysname] header motd %
Please input banner content, and quit with the character '%'.
Welcome to motd(header motd)%
[Sysname] header shell %
Please input banner content, and quit with the character '%'.
Welcome to shell(header shell)%
// 本例中，“%”为text的起始/结束字符，在显示文本后输入“%”表示文本结束，退出header命
令。作为起始与结束字符，“%”不会成为所设置欢迎信息的一部分。
•
用户界面下没有配置登录认证，采用Telnet方式登录设备，测试以上设置时，显示信息如下。
******************************************************************************
* Copyright (c) 2004-2013 Hangzhou H3C Tech. Co., Ltd. All rights reserved. *
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
******************************************************************************
Welcome to legal (header legal)
Press Y or ENTER to continue, N to exit.
Welcome to motd(header motd)
Welcome to shell(header shell)
1-28
•
用户界面下配置password认证方式，采用Telnet方式登录设备，测试以上设置时，显示信息
如下。
******************************************************************************
* Copyright (c) 2004-2013 Hangzhou H3C Tech. Co., Ltd. All rights reserved. *
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
******************************************************************************
Welcome to legal (header legal)
Press Y or ENTER to continue, N to exit.
Welcome to motd(header motd)
Welcome to login(header login)
Login authentication
Password:
Welcome to shell(header shell)
1.1.27 job
【命令】
job job-name
undo job job-name
【视图】
系统视图
【命令级别】
3：管理级
【参数】
job-name：任务名，为1～32个字符的字符串。
【描述】
job命令用来创建新的定时执行任务并进入job视图，如果定时执行任务已经创建，则直接进入job
视图。undo job命令用来删除定时执行任务。
缺省情况下，系统没有创建定时执行任务。
创建定时执行任务后，可以在定时执行任务视图下配置任务的具体内容，比如让系统在某个时间点
自动执行某视图下的某条命令。
多次执行该命令可以创建多个定时任务，各任务之间互不干扰。
相关配置可参考命令view和time。
1-29
【举例】
# 创建（或进入）系统定时任务saveconfiguration。
[Sysname] job saveconfiguration
[Sysname-job-saveconfiguration]
1.1.28 reboot
【命令】
reboot
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
无
【描述】
reboot命令用来重启设备。
•
重新启动会导致业务中断，请谨慎使用该命令。
•
如果主用启动文件损坏或者不存在，则不能通过reboot命令重启设备。此时，可以通过指定新
的主用启动文件再重启，或者断电后重新上电，系统将自动使用备用启动文件重启。
•
如果设备在准备重启时，用户正在进行文件操作，为了安全起见，系统将不会执行此次重启操作。
【举例】
# 重启设备。
……交互信息略……
1.1.29 reset unused porttag
【命令】
reset unused porttag
【视图】
用户视图
【缺省级别】
1：监控级
1-30
【参数】
无
【描述】
reset unused porttag命令用来清除设备当前系统中保存的但不使用的16bit索引。
执行该命令时需要得到用户的确认。若用户在30秒之内没有确认操作，或者用户输入字符“N”否
定了本次操作，则本命令退出执行。
【举例】
# 清除当前系统中保存的但不使用的16bit索引。
Current operation will delete all unused port tag(s). Continue? [Y/N]:y
1.1.30 reset version-update-record
【命令】
reset version-update-record
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
无
【描述】
reset version-update-record命令用来清除软件版本更新操作的记录。
相关配置可参考display version-update-record。
【举例】
# 清除设备软件版本更新操作的记录。
[Sysname] reset version-update-record
1.1.31 schedule job
【命令】
schedule job { at time1 [ date ] | delay time2 } view view-name command
undo schedule job
【视图】
用户视图
【缺省级别】
3：管理级
1-31
【参数】
at time1 [ date ]：指定执行命令的具体时间。
•
•
time1表示执行命令的时间，格式为hh:mm （小时:分钟）。hh取值范围为0～23，mm取值
范围为0～59。
date表示执行命令的日期，格式为MM/DD/YYYY（月/日/年）或者YYYY/MM/DD（年/月/日）。
YYYY的取值范围为2000～2035，MM的取值范围为1～12，DD的取值范围与具体月份相
关。
hh:mm（小时:分钟），hh的取值范围为0～720，mm的取值范围为0～59，hh:mm的取值不
能超过720:00。
mm（分钟），取值范围为0～43200，0表示不延时，立即执行
。
shell表示用户视图。
system表示系统视图。
delay time2：指定执行命令的延迟时间。time2表示执行命令的延迟时间，格式可以为：
•
•
•
•
view view-name：指定执行命令的视图。view-name表示命令视图的名称，当前的取值为：
command：需要定时执行的命令字符串。
【描述】
schedule job命令用来配置定时执行任务。undo schedule job命令用来取消定时执行任务。
需要注意的是：
•
•
•
•
•
若指定参数at time1 date，则设置的时间点必须为将来的时间。
若指定参数at time1，当time1在当前系统时间之前，则指定命令将在第二天的该时间点执行；
当time1在当前系统时间之后，则指定命令将在当天的该时间点执行。
无论使用参数at还是delay，设置的定时时间与当前系统时间的间隔都不能大于720小时（即
30天）。
command表示的命令行必须是设备上可成功执行的命令行，并且要求命令行是view-name
视图下的命令，由用户保证配置的正确性，否则，命令行不能自动被执行。
指定命令执行时不进行信息交互。当需要用户交互确认时，系统将自动输入“Y”或“Yes”；
当需要用户交互输入字符信息时，系统将自动输入缺省字符串，没有缺省字符串的将自动输入
空字符串。
对于切换用户操作界面的命令（如telnet、ftp、ssh2等）、切换视图的命令（如system-view、
quit等）以及修改执行命令用户状态的命令（如super命令等），自动执行命令后当前用户的
操作界面、命令视图和用户状态不变。
使用本命令配置定时执行功能后，又执行clock datetime、clock summer-time或clock
timezone命令调整了系统时间，则定时执行功能的配置将自动取消。
多次执行schedule job命令时，只有最新的配置生效。
•
•
•
【举例】
# 当前时间为11:43，设置在60分钟之后在系统视图下执行批处理文件。
Info: Command execute in system view will be executed at 12:43 10/31/2013 (in 1 hours
and 0 minutes).
# 当前时间为11:43，设置在当天中午12:00在系统视图下执行批处理文件。
1-32
Info: Command execute in system view will be executed at 12:00 10/31/2013 (in 0 hours
and 16 minutes).
1.1.32 schedule reboot at
【命令】
schedule reboot at hh:mm [ date ]
undo schedule reboot
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
hh:mm：设备重启的时间，格式为“小时:分钟”。hh取值范围为0～23，mm取值范围为0～59。
date：设备重启的日期，格式为mm/dd/yyyy（月/日/年）或者yyyy/mm/dd（年/月/日）。yyyy的取
值范围为2000～2035，mm的取值范围为1～12，dd的取值范围与具体月份相关。
【描述】
schedule reboot at命令用来开启设备定时重启功能，并指定重启的具体时间和日期。undo
schedule reboot命令用来关闭定时重启功能。
缺省情况下，设备定时重启功能处于关闭状态。
如果没有指定重启的具体日期，则分为两种情况：
•
•
•
•
•
•
•
•
设置的时间点在当前时间之后，则设备将在当天的该时间点重启；
设置的时间点在当前时间之前，则设备将在第二天的该时间点重启。
设备定时器的精度为1分钟。在到达用户设定的重启时刻的前一分钟，设备会提示：REBOOT
IN ONE MINUTE（设备将在一分钟后重启），并在一分钟后重新启动。
设置的日期与当前日期相比，不能大于30×24小时（即30天）。
配置该命令后，系统会提示输入确认信息，只有键入
前进行过相应设置，则原有配置将被覆盖。
如果schedule reboot at命令设置了重启的具体日期（月/日/年或年/月/日），而且参数表示的
是将来的日期，则设备将在设定的时间点重新启动。
使用本命令配置定时重启功能后，又执行clock datetime、clock summer-time或clock
timezone命令调整了系统时间，则定时重启功能的配置将自动取消。
如果设备在准备重启时，用户正在进行文件操作，为了安全起见，系统将不会执行此次重启操
作。
需要注意的是：
相关配置可参考命令schedule reboot delay。
1-33
该命令会使设备在将来指定的时间点重新启动，从而导致业务中断，请谨慎使用。
【举例】
# 假设系统的当前时间为2013年6月6日11:43分，设置设备在当天中午12:00重启。
Reboot system at 12:00 06/06/2013 (in 0 hour(s) and 16 minute(s)) confirm? [Y/N]:
如果在设置重启时间之前使用terminal logging命令打开终端日志显示功能的话，输入“y”之后，
系统会自动显示相关日志信息。（缺省情况下，终端对日志信息的显示功能处于开启状态）。
%Jun 6 11:43:11:629 2013 Sysname CMD/4/REBOOT:
vty0(192.168.1.54): Set schedule reboot parameters at 11:43:11 06/06/2013, and system will
reboot at 12:00 06/06/2013.
1.1.33 schedule reboot delay
【命令】
schedule reboot delay { hh:mm | mm }
undo schedule reboot
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
hh:mm：设备重启的等待时延，格式为“小时:分钟”。hh的取值范围为0～720，mm的取值范围
为0～59，hh:mm的取值不能超过720:00。
mm：设备重新启动的等待时延，单位为分钟，取值范围为0～43200。
【描述】
schedule reboot delay命令用来开启设备的定时重启功能，并设定等待时延。undo schedule
reboot命令用来关闭定时重启功能。
缺省情况下，设备定时重启功能处于关闭状态。
需要注意的是：
•
•
•
可以用两种格式来设置设备定时重启的等待时延，即“小时:分钟”和“绝对分钟数”。但绝对
分钟数不能大于30×24×60分钟（即30天）。
设备定时器的精度为1分钟。在到达用户设定的重启时刻的前一分钟，设备会提示：REBOOT
IN ONE MINUTE（设备将在一分钟后重启），并在一分钟后重新启动。
配置该命令后，系统会提示输入确认信息，只有键入
前进行过相应设置，则原有配置将被覆盖。
1-34
•
•
使用本命令配置定时重启功能后，又执行clock datetime、clock summer-time或clock
timezone命令调整了系统时间，则定时重启功能的配置将自动取消。
如果设备在准备重启时，用户正在进行文件操作，为了安全起见，系统将不会执行此次重启操
作。
相关配置可参考命令schedule reboot at。
该命令会使设备在指定时延后重新启动，从而导致业务中断，请谨慎使用。
【举例】
# 假设系统的当前时间为2013年6月6日11:48分，配置设备在88分钟后重启。
Reboot system at 13:16 06/06/2013(in 1 hour(s) and 28 minute(s)). confirm? [Y/N]:
# 如果在设置重启时间之前使用terminal logging命令打开终端日志显示功能的话，输入“y”之
后，系统会自动显示相关日志信息。（缺省情况下，终端对日志信息的显示功能处于开启状态）。
%Jun 6 11:48:44:860 2013 Sysname CMD/4/REBOOT:
vty0(192.168.1.54): Set schedule reboot parameters at 11:48:44 06/06/2013, and system will
reboot at 13:16 06/06/2013.
1.1.34 shutdown-interval
【命令】
shutdown-interval time
undo shutdown-interval
【视图】
系统视图
【缺省级别】
2：系统级
【参数】
time：配置端口状态检测定时器的时长，取值范围为0～300，单位为秒。
【描述】
shutdown-interval命令用来配置端口状态检测定时器的时长。undo shutdown-interval命令用来
恢复缺省情况。
缺省情况下，配置端口状态检测定时器的时长为30秒。
某些协议模块在特定情况下会自动关闭某个端口，比如当使能了BPDU保护功能的端口收到配置消
息时，MSTP协议模块将自动关闭该端口。此时，可以配置一个端口状态检测定时器。当定时器超
时，并且该端口仍处于关闭状态，协议模块则自动取消关闭动作，使端口恢复到真实的物理状态。
需要注意的是：
1-35
•
如果用户在端口定时检测过程中将检测时间间隔修改为T1，修改时刻距协议关闭端口时间间
隔为T。若T
口会立即恢复。例如当前time设置为30，当端口被协议模块关闭2秒（T=2）后，修改time
为10（T1=10），则该接口会再经过8秒后被恢复；如果当前time为30，端口被协议模块关
闭10秒后，修改time为2，则该端口会立即恢复。
当time设置为0时，相当于定时监测时间间隔为无穷大，协议不会自动激活端口。用户需要
手工执行undo shutdown命令来立即激活，或者重新修改time值来激活（遵循上一条注意
事项的规则）。
•
【举例】
# 配置端口状态检测定时器的时长为100秒。
[Sysname] shutdown-interval 100
1.1.35 sysname
【命令】
sysname sysname
undo sysname
【视图】
系统视图
【缺省级别】
2：系统级
【参数】
sysname：设备名称，为1～30个字符的字符串。
【描述】
sysname命令用来设置设备的名称。undo sysname用来恢复设备名称为默认名称。
缺省情况下，设备名称为H3C。
设备的名称对应于命令行接口的提示符，如设备的名称为Sysname，则用户视图的提示符为
【举例】
# 设置设备的名称为S2000。
[Sysname] sysname S2000
[S2000]
1.1.36 system-failure
【命令】
system-failure { maintain | reboot }
undo system-failure
1-36
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
maintain：表示系统故障时，保持当前状态，系统不会自动采取任何相关措施。
reboot：表示系统异常时，会采用直接重启的方式来进行恢复。
【描述】
system-failure命令仅用来配置设备系统异常时的处理方式。
缺省情况下，系统异常时的处理方式为reboot。
【举例】
# 将系统异常时的处理方式设置为reboot。
[Sysname] system-failure reboot
1.1.37 time at
【命令】
time time-id at time date command command
time time-id { one-off | repeating } at time [ month-date month-day | week-day week-daylist ]
command command
undo time time-id
【视图】
定时执行任务视图
【命令级别】
3：管理级
【参数】
time time-id：时间记录，取值范围为1～10的整数。
at time：执行指定命令的时间，格式为hh:mm (小时:分钟)。hh取值范围为0～23，mm取值范围
为0～59。
one-off：表示指定命令仅执行一次。命令在该设定时间点到达时执行，执行后下次再到达该时间点
时命令不再执行。
repeating：表示循环执行指定命令。
date：执行指定命令的日期，格式为MM/DD/YYYY（月/日/年）或者YYYY/MM/DD（年/月/日）。
•
•
•
YYYY的取值范围为2000～2035；
MM的取值范围为1～12；
DD的取值范围与具体月份有关。
month-date month-day：执行指定命令在一个月中的哪天被执行。month-day表示日期，取值范围
为1～31。
1-37
week-day week-daylist：执行指定命令在一周中的哪（些）天被执行。week-daylist表示一周中任
一天或几天的组合，取值为：Mon、Tue、Wed、Thu、Fri、Sat、Sun（星期一到星期日）。设置
多天时，字符串之间用空格分开，最多可以设置七天。
command command：需要定时执行的命令字符串。命令行必须是设备上可成功执行的命令行，并
且要求命令行是view命令配置的视图下的命令，由用户保证配置的正确性，否则，命令行不能自
动被执行。
【描述】
time at命令用来配置在指定时间执行指定命令。undo time命令用来取消在指定时间执行的命令。
•
•
•
•
•
•
•
time time-id at time date command command命令用来设置在某年某月某时某刻执行命令。
配置的时间点必须晚于系统当前时间点，否则，配置失败。
time time-id one-off at time command command命令用来设置在指定时刻执行命令。若当
天该时间点已过去，则顺延到第二天。执行后下次再到达该时间点时命令不再执行。
time time-id one-off at time month-date month-day command command命令用来设置在
某天某时执行命令。若本月该时间点已过去，则顺延到下月。命令执行后不再执行。
time time-id one-off at time week-day week-daylist command command命令用来设置在某
（些）天某时执行命令。若本周该时间点已过去，则顺延到下周。命令执行后不再执行。
time time-id repeating at time command command命令用来设置在每天的指定时刻执行命
令。执行后下次再到达该时间点时命令仍执行。
time time-id repeating at time month-date month-day command command命令用来设置
在每月的某天某时执行命令。执行后下次再到达该时间时命令仍执行。
time time-id repeating at time week-day week-daylist command command命令用来设置在
每周的某（些）天某时执行命令。执行后下次再到达该时间点时命令仍执行。
相关命令可参考job和view。
•
一个定时执行任务中指定的命令必须在同一视图下执行。
•
一个定时执行任务中最多可以配置10条命令（对应10个time-id）。如果多于10条，请把这个
任务拆分为多个任务。
•
time-id在同一个任务中必须唯一。如果新执行的time at命令指定的time-id和已有配置的
time-id值相同，则新配置会覆盖旧配置。
•
修改系统时间，不会影响该命令的配置和执行。
【举例】
# 2013年5月18日3:00将设备当前配置保存到文件。
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 at 3:00 2013/5/18 command save
# 每天的12:00执行保存配置命令。
[Sysname] job saveconfig
1-38
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 repeating at 12:00 command save
# 从现在开始第一个月5号的上午8点执行一次保存配置命令。
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 one-off at 8:00 month-date 5 command save
# 从现在开始每个月5号的上午8点执行保存配置命令。
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 repeating at 8:00 month-date 5 command save
# 从现在开始第一个周五和周六的上午8点分别执行一次保存配置命令。
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 one-off at 8:00 week-day fri sat command save
# 从现在开始每个周五和周六的上午8点都执行保存配置命令。
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 repeating at 8:00 week-day fri sat command save
1.1.38 time delay
【命令】
time time-id { one-off | repeating } delay time command command
undo time time-id
【视图】
定时执行任务视图
【命令级别】
3：管理级
【参数】
time time-id：时间记录，取值范围为1～10的整数。
one-off：表示指定命令仅执行一次。命令在该时间点到达时执行，执行后下次再到达该时间点时命
令不再执行。
repeating：表示循环执行指定命令。
delay time：执行指定命令的等待时延。格式为hh:mm (小时:分钟)或mm（分钟）。
•
•
使用hh:mm格式时，hh的取值范围为0～720，mm的取值范围为0～59，hh:mm的取值不
能超过720:00；
使用mm格式时，mm的取值范围为1～43200，即定时器的最大定时时长为30天。
command command：需要定时执行的命令字符串，该字符串中指定的命令必须为完整的、不需要
进行交互的命令。
1-39
【描述】
time delay命令用来配置延迟指定时间执行指定命令。undo time命令用来取消延迟指定时间执行
的命令。
•
•
time time-id one-off delay time command command命令用来设置在指定时间间隔后执行
命令。命令执行后不再执行。
time time-id repeating delay time command command命令用来设置以指定时间间隔为周
期重复执行命令。命令以时间间隔为周期循环执行。
相关命令可参考job和view。
•
一个定时执行任务中指定的命令必须在同一视图下执行；
•
一个定时执行任务中最多可以配置10条命令（对应10个time-id）。如果多于10条，请把这个
任务拆分为多个任务。
•
time-id在同一个任务中必须唯一。如果新执行的time at命令指定的time-id和已有配置的
time-id值相同，则新配置会覆盖旧配置。
•
修改系统时间，不会影响该命令的配置和执行。
【举例】
# 5分钟后将当前配置保存到文件。
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 one-off delay 5 command save
# 每隔5分钟后将当前配置保存到文件。
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 repeating delay 5 command save
1.1.39 view
【命令】
view view-name
undo view
【视图】
job视图
【命令级别】
3：管理级
【参数】
view-name：视图名，为1～90个字符的字符串。定时任务中配置的命令在哪个视图下执行通过该
参数指定。
1-40
【描述】
view命令用来指定定时执行命令所在的视图。undo view命令用来删除定时执行任务中的视图设
置。
缺省情况下，没有指定命令所在的视图。
需要注意的是：
•
•
每个定时执行任务只能包含一个视图，该定时任务中所有命令都将在此视图下被执行。若多次
执行该命令指定了不同的视图，则最新的配置生效。
视图必须是设备当前支持的视图，而且是视图的完整形式，不能使用缩写。常用的有：用户视
图对应的view-name为monitor，系统视图对应的view-name为system，以太网接口视图对
应的view-name为GigabitEthernetx/x/x，VLAN接口视图对应的view-name为
Vlan-interfacex/x/x等。
相关配置可参考命令job和time。
【举例】
# 指定系统自动执行的命令所在视图为系统视图。
[Sysname] job creatvlan
[Sysname-job-creatvlan] view system
1-41
2024年9月24日发(作者：义韶敏)
【举例】
# 执行根目录下的批处理文件。
[Sysname] execute
1.1.6 file prompt
【命令】
file prompt { alert | quiet }
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
alert：交互确认方式。当用户对文件进行有危险性的操作时，系统会要求用户进行交互确认。
quiet：非交互确认方式。用户对文件进行任何操作，系统均不要求用户进行确认。
【描述】
file prompt命令用来设置系统对文件操作的提示方式。
缺省情况下，文件操作的提示方式为alert。
需要注意的是，如果将文件操作的提示方式设置为quiet，则系统对文件操作不要求用户进行确认，
这样可能会导致一些因误操作而发生的、不可恢复的、对系统造成破坏的操作产生。
【举例】
# 设置系统对文件操作的提示方式为alert。
[Sysname] file prompt alert
1.1.7 fixdisk
【命令】
fixdisk device
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
device：存储设备名称。
【描述】
fixdisk命令用来恢复存储设备的空间。
1-5
由于异常操作等原因，存储设备的某些空间可能不可用，用户可以通过fixdisk命令来恢复存储设
备的空间。
【举例】
# 恢复存储设备Flash的空间。
Fixdisk flash: may take some time
%Fixdisk flash: completed.
1.1.8 format
【命令】
format device
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
device：为存储设备名（如flash等）。
【描述】
format命令用来格式化存储设备。
格式化操作将导致存储设备上的所有文件丢失，并且不可恢复。
【举例】
# 格式化Flash。
All data on flash: will be lost, proceed with format? [Y/N]:y
./
%Format flash: completed.
1.1.9 mkdir
【命令】
mkdir directory
【视图】
用户视图
【缺省级别】
3：管理级
1-6
【参数】
directory：文件夹。
【描述】
mkdir命令用来在存储设备的指定目录下创建文件夹。
需要注意的是：
•
•
如果创建的文件夹与指定目录下的其它文件夹重名，则创建操作失败。
在使用该命令创建文件夹之前，指定的目录必须已经存在。比如：创建文件夹
flash:/test/mytest，这时，test目录必须已经存在，否则，创建失败。
【举例】
# 在当前路径创建文件夹test。
....
%Created dir flash:/test.
# 在当前路径创建文件夹test/subtest。
....
%Created dir flash:/test/subtest.
1.1.10 more
【命令】
more file-url
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
file-url：文件名。
【描述】
more命令用来显示指定文件的内容。
目前文件系统只支持显示文本文件的内容。
【举例】
# 查看文件。
#
version 5.20, Release 0000
#
sysname Test
#
---- More ----
1-7
“---- More ----”表示这一屏信息已经显示完毕，会暂停显示。按
按
1.1.11 move
【命令】
move fileurl-source fileurl-dest
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
fileurl-source：源文件名。
fileurl-dest：目标文件名或者目标文件夹。
【描述】
move命令用来移动文件。
如果使用文件夹作为fileurl-dest，则系统会将文件移到指定文件夹，文件名保持不变。
【举例】
# 将文件flash:/test/移动到flash:/，并更名为。
Move flash:/test/ to flash:/?[Y/N]:y
...
% Moved file flash:/test/ to flash:/
# 将文件移动到子文件夹test2下。
Move flash:/ to flash:/test2/?[Y/N]:y
.
%Moved file flash:/ to flash:/test2/.
1.1.12 pwd
【命令】
pwd
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
无
1-8
【描述】
pwd命令用来显示当前路径。
【举例】
# 显示当前路径。
flash:
1.1.13 rename
【命令】
rename fileurl-source fileurl-dest
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
fileurl-source：源文件名或源文件夹。
fileurl-dest：目标文件名或目标文件夹。
【描述】
rename命令用来重命名文件或文件夹。若目标文件名与当前路径下已经存在的文件重名，则该操
作不执行。
【举例】
# 将文件重命名为。
Rename flash:/ to flash:/? [Y/N]:y
% Renamed file flash:/ to flash:/
1.1.14 reset recycle-bin
【命令】
reset recycle-bin [ /force ]
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
/force：强制清空回收站。
1-9
【描述】
reset recycle-bin命令用来彻底删除当前目录下、处于回收站中的文件。
如果文件损坏，直接使用reset recycle-bin命令可能不能删除该文件。使用reset recycle-bin
/force可以强制删除回收站中的所有文件。
需要注意的是：
•
•
用delete file-url命令删除文件是将文件放在回收站中，但仍然占用存储空间，如果想要把回
收站中的该文件删除，必须在该文件的原目录下执行reset recycle-bin命令。
reset recycle-bin命令删除的是当前目录下、处于回收站中的文件。如果要清除的文件的原
路径不是当前路径，则必须先使用cd命令进入文件的原目录，再执行reset recycle-bin命
令。
【举例】
# 删除当前目录下、处于回收站中的文件。
•
显示当前目录下、处于回收站中的所有文件。
Directory of flash:/
0 -rwh 3080 JAN 26 2013 16:41:43
1 -rw- 2416 JAN 26 2013 13:45:36
2 -rw- 8036197 JAN 14 2013 10:13:18
3 -rw- 2386 JAN 26 2013 13:30:30
4 drw- - JAN 08 2013 09:49:25 test
5 -rwh 716 JAN 24 2013 16:17:30 hostkey
6 -rwh 572 JAN 24 2013 16:17:44 serverkey
7 -rw- 2386 JAN 08 2013 11:14:20 []
8 -rw- 3608 JAN 03 2013 17:29:30 []
12065 KB total (6730 KB free)
//
以上信息表明当前路径为
flash:
，处于回收站中的文件有
和
。
•
彻底删除当前目录下、处于回收站中的文件。
Clear flash:/~/ ?[Y/N]:n
Clear flash:/~/ ?[Y/N]:y
Clearing files from flash may take a long time.
......
%Cleared file flash:/~/...
•
验证flash:目录下、处于回收站中的文件是否已被删除。
Directory of flash:/
0 -rwh 3080 JAN 26 2013 16:41:43
1 -rw- 2416 JAN 26 2013 13:45:36
2 -rw- 8036197 JAN 14 2013 10:13:18
3 -rw- 2386 JAN 26 2013 13:30:30
4 drw- - JAN 08 2013 09:49:25 test
1-10
5 -rwh 716 JAN 24 2013 16:17:30 hostkey
6 -rwh 572 JAN 24 2013 16:17:44 serverkey
7 -rw- 2386 JAN 08 2013 11:14:20 []
12065 KB total (6734 KB free)
//
以上信息表明文件
flash:/
已被彻底删除。
# 删除子目录test下、处于回收站中的文件。
•
•
进入子目录。
查看test子文件夹下的所有文件。
Directory of flash:/test
0 -rw- 2161 JAN 26 2013 21:22:35 []
12065 KB total (6734 KB free)
//
以上信息表明该文件夹下只有一个文件，而且该文件已经被删除至回收站。
•
彻底删除test/。
Clear flash:/test/~/ ?[Y/N]:y
Clearing files from flash may take a long time.
..
%Cleared file flash:/test/~/...
1.1.15 rmdir
【命令】
rmdir directory
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
directory：文件夹。
【描述】
rmdir命令用来删除文件夹。
需要注意的是：
•
•
被删除的文件夹必须为空文件夹（即删除文件夹前，必须先删除该文件夹下的所有文件及子文
件夹，文件的删除请参见delete命令）。
成功执行rmdir后，回收站中原来属于该文件夹的文件会自动被彻底删除。
【举例】
# 删除文件夹mydir。
1-11
Rmdir flash:/mydir? [Y/N]:y
%Removed directory flash:/mydir.
1.1.16 undelete
【命令】
undelete file-url
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
file-url：要恢复的文件名。
【描述】
undelete命令用来恢复未被彻底删除（即存放在回收站里）的文件。
如果恢复的文件名与当前存在的文件重名，系统将提示操作者是否覆盖原有文件。
【举例】
# 恢复目录flash:下删除的文件。
Undelete flash:/?[Y/N]:y
.....
%Undeleted file flash:/.
# 恢复目录flash:/test下删除的文件。
Undelete flash:/test/?[Y/N]:y
.......
%Undeleted file flash:/test/.
或者使用以下步骤，也可以恢复flash:/test/。
Undelete flash:/test/?[Y/N]:y
.....
%Undeleted file flash:/test/.
1-12
目 录
1 配置文件管理 ····································································································································· 1-1
1.1 配置文件管理命令 ····························································································································· 1-1
1.1.1 archive configuration ·············································································································· 1-1
1.1.2 archive configuration interval ·································································································· 1-1
1.1.3 archive configuration location ································································································· 1-2
1.1.4 archive configuration max ······································································································ 1-3
1.1.5 backup startup-configuration ·································································································· 1-4
1.1.6 configuration replace file ········································································································ 1-4
1.1.7 display archive configuration ·································································································· 1-5
1.1.8 display current-configuration ·································································································· 1-6
1.1.9 display default-configuration ··································································································· 1-7
1.1.10 display saved-configuration ·································································································· 1-9
1.1.11 display startup ···················································································································· 1-10
1.1.12 display this ·························································································································· 1-11
1.1.13 reset saved-configuration ··································································································· 1-13
1.1.14 restore startup-configuration ······························································································ 1-13
1.1.15 save ···································································································································· 1-14
1.1.16 startup saved-configuration ································································································ 1-15
i
1
配置文件管理
1.1
配置文件管理命令
1.1.1 archive configuration
【命令】
archive configuration
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
无
【描述】
archive configuration命令用来手工备份当前配置。
执行该命令后，系统会将当前的配置以指定的文件名（指定前缀+序号）保存到指定的路径。
需要注意的是：
•
执行archive configuration命令前必须先执行archive configuration location命令来设置
备份文件的前缀和保存路径。
【举例】
# 手工备份当前配置。
Warning: Save the running configuration to an archive file. Continue? [Y/N]: Y
Info: The archive configuration file myarchive_ is saved.
1.1.2 archive configuration interval
【命令】
archive configuration interval minutes
undo archive configuration interval
【视图】
系统视图
【缺省级别】
3：管理级
1-1
【参数】
minutes：表示自动备份当前配置的时间间隔，取值范围为10～525600（相当于365天），单位为
分钟。
【描述】
archive configuration interval命令用来使能自动备份当前配置功能，并设置自动备份的间隔时间。
undo archive configuration interval用来恢复缺省情况。
缺省情况下，系统不会自动备份当前配置。
成功执行本命令后，每隔指定时间（由minutes值决定）系统会把当前配置以指定文件名自动保存
到指定路径。
使用该命令时应根据设备存储介质的性能和修改配置的频繁程度来设置minutes参数的具体值：
•
•
对于不会频繁修改配置的设备，建议按需手动备份当前配置（相关配置可参考命令archive
configuration）；
对于使用低速存储介质（如Flash）的设备，建议不要进行自动备份配置，或设置minutes大
于1440（24小时）；
执行archive configuration interval命令前必须先执行archive configuration location命
令来设置备份文件的前缀和保存路径。
需要注意的是：
•
【举例】
# 设置每隔一小时自动备份当前配置。
[Sysname] archive configuration interval 60
Info: Archive files will be saved every 60 minutes.
1.1.3 archive configuration location
【命令】
archive configuration location directory filename-prefix filename-prefix
undo archive configuration location
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
directory：表示保存备份配置文件的文件夹的路径，为1～63字节的字符串，格式为存储介质名:/[文
件夹名]/子文件夹名，不区分大小写。该文件夹必须预先创建好。
filename-prefix：表示备份配置文件的文件名前缀，为1～30字节的字符串，只能包含字母、数字、
“_”和“-”，不区分大小写。
【描述】
archive configuration location命令用来设置备份配置文件的保存路径和文件名前缀。undo
archive configuration location命令用来恢复缺省情况。
1-2
缺省情况下，系统没有设置备份配置文件的保存路径和文件名前缀，也不会定时备份配置。
需要注意的是：
•
•
自动或手动备份当前配置前必须使用该命令设置备份配置文件的保存路径和文件名前缀。
执行undo archive configuration location命令后，用户将不能手工备份当前配置，系统也
不再自动备份当前配置，archive configuration interval和archive configuration max的
配置也会恢复到缺省情况，已保存的备份配置文件记录也会被清除。
【举例】
# 在flash:/archive目录下备份配置文件，文件名前缀为my_archive。
•
.
%Created dir flash:/archive.
创建文件夹flash:/archive。
•
设置备份配置文件的保存路径和文件名前缀。
[Sysname] archive configuration location flash:/archive filename-prefix my_archive
1.1.4 archive configuration max
【命令】
archive configuration max file-number
undo archive configuration max
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
file-number：表示可保存的备份配置文件数目上限，取值范围为1～10。该参数的具体数值应根据
设备存储介质的空间大小来决定。对于存储空间较小的设备，建议设置file-number为较小值。
【描述】
archive configuration max命令用来设置系统允许保存的备份配置文件的最大数。undo archive
configuration max用来恢复缺省情况。
缺省情况下，系统最多允许保存5个备份配置文件。
备份配置文件数目过多会占用系统内存空间，通过该命令可以控制备份配置文件的数目。当备份配
置文件数目到达上限后，下次备份配置文件（包括自动和手动两种触发方式）时，将删除保存时间
最早的备份文件，以保存新的备份配置文件。修改备份配置文件数上限时并不删除多余文件，如果
当前已有的备份配置文件数大于或等于新设置的上限值，则在备份新的配置时，系统将自动删除生
成时间最早的（当前已有备份配置文件数-新设置的上限值+1）备份配置文件。（比如，当前已有备
份配置文件数为7，新设置的上限值为4，当有配置需要备份时，系统会先删除“7-4+1=4”个生成
时间最早的备份配置文件）
1-3
在使用该命令前，必须先执行archive configuration location命令设置保存路径和文件名前缀，
否则，本命令执行失败。
需要注意的是，执行undo archive configuration location，系统最多允许保存的备份配置文件数
目也会恢复到缺省情况。
【举例】
# 设置系统最大允许保存10个备份配置文件。
[Sysname] archive configuration max 10
1.1.5 backup startup-configuration
【命令】
backup startup-configuration to dest-addr [ dest-filename ]
【视图】
用户视图
【缺省级别】
2：系统级
【参数】
dest-addr：TFTP服务器的IPv4地址或主机名，为1～20个字符的字符串。
dest-filename：目的文件名，后缀必须为“.cfg”。在服务器上将以该文件名保存设备的启动配置文
件。
【描述】
backup startup-configuration命令用于将设备的下次启动配置文件备份到指定的TFTP服务器。
如果不指定目的文件名，则使用原文件名备份。执行该命令仅对主用下次启动配置文件进行备份。
目前设备通过TFTP传输协议来实现备份操作。
【举例】
# 将设备的下次启动配置文件备份到IP地址为2.2.2.2的TFTP服务器上，文件名为
。
MainBoard:
Current startup saved-configuration file: flash:/
Next main startup saved-configuration file: flash:/
Next backup startup saved-configuration file: flash:/
Backup next startup-configuration file to 2.2.2.2, please wait…finished!
1.1.6 configuration replace file
【命令】
configuration replace file filename
1-4
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
filename：指定用来回滚配置的配置文件名。
【描述】
configuration replace file命令用来进行配置回滚。
执行本命令后，系统当前配置将恢复到指定配置文件（filename）中的配置状态。
需要注意的是configuration replace file filename命令中指定的配置文件只能是明文配置文件，不
能是被加密的配置文件。否则，会导致配置回滚出错。
【举例】
# 将当前配置回滚到配置文件my_archive_中的配置状态。
[Sysname] configuration replace file my_archive_
Current configuration will be lost, save current configuration? [Y/N]:n
Info: Now replacing the current configuration.
Info: Succeeded in replacing current configuration with the file my_archive_.
1.1.7 display archive configuration
【命令】
display archive configuration [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display archive configuration命令用来显示配置回滚功能的相关信息。
【举例】
# 显示配置回滚功能的相关信息。
1-5
Location: flash:/archive
Filename prefix: my_archive
Archive interval in minutes: 120
Maximum number of archive files: 10
Saved archive files:
No. TimeStamp FileName
1 Jan 05 2013 20:24:54 my_archive_
2 Jan 05 2013 20:34:54 my_archive_
# 3 Jan 05 2013 20:44:54 my_archive_
‘#’ indicates the most recent archive file.
Next archive file to be saved: my_archive_
表1-1 display archive configuration命令显示信息描述表
字段
Location
Filename prefix
Archive interval in minutes
Maximum number of archive files
Saved archive files
No.
TimeStamp
FileName
‘#’ indicates the most recent archive file.
Next archive file to be saved
描述
保存备份配置文件的文件夹的绝对路径
备份配置文件的文件名前缀
自动备份配置文件的时间间隔，以分钟为单位
若不自动备份配置文件，不显示此项
设备可保存的最大备份配置文件数目
当前已保存的备份配置文件信息
显示已保存的备份配置文件信息的行号
备份配置文件的保存时间
备份配置文件名，不包含路径
“#”表示该行描述的备份配置文件是最近一次备份的
下次保存备份配置文件将使用的文件名
1.1.8 display current-configuration
【命令】
display current-configuration [ [ configuration [ configuration ] | interface [ interface-type ]
[ interface-number ] | exclude modules ] [ by-linenum ] [ | { begin | exclude | include }
regular-expression ] ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
configuration [ configuration ]：显示非接口配置。
1-6
interface [ interface-type ] [ interface-number ]：显示接口的配置。interface-type表示接口类型，
interface-number表示接口编号。
exclude modules：不显示指定模块的配置。modules表示模块名，可以一次输入多个模块名，模
块名之间用空格隔开，形如display current-configuration exclude a b，表示除了a和b模块的
内容，其它生效的配置均显示。目前modules支持取值：
•
acl：表示不显示ACL模块的配置。
by-linenum：显示每一行信息的行号。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display current-configuration命令用来显示设备当前生效的配置。
当用户完成一组配置之后，需要验证是否配置正确，则可以执行display current-configuration
命令来查看当前生效的参数。对于某些当前配置的参数，如果与缺省参数相同，则不显示。对于某
些参数，虽然用户已经配置，但如果实际生效的参数发生了改变，则显示实际生效的参数，如：在
某Loopback接口下配置的“ip address 11.11.11.11 24”，这时，执行display current-configuration
后看到的配置为“ip address 11.11.11.11 255.255.255.255”，实际生效的掩码为32位。
相关配置可参考命令save、reset saved-configuration和display saved-configuration。
【举例】
# 查看当前生效的配置中，从包含“user-interface”字符串的行开始到最后一行的配置信息。
user-interface aux 0
user-interface vty 0 15
authentication-mode none
user privilege level 3
#
return
# 查看当前设备上生效的SNMP配置。
snmp-agent
snmp-agent local-engineid 800063A203000FE240A1A6
snmp-agent community read public
snmp-agent community write private
snmp-agent sys-info version all
1.1.9 display default-configuration
【命令】
display default-configuration [ | { begin | exclude | include } regular-expression ]
1-7
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display default-configuration命令用来显示设备的出厂配置。
使用display default-configuration命令可以查看到使用出厂配置启动设备时所有要被执行的命
令。
相关配置可参考命令display current-configuration（显示当前生效的配置）和display
saved-configuration（显示保存的生效的配置）。
【举例】
# 显示设备的出厂配置。
#
domain default enable system
#
telnet server enable
#
undo ip redirects
undo ip ttl-expires
undo ip unreachables
#
vlan 1
#
radius scheme system
server-type extended
primary authentication 127.0.0.1 1645
primary accounting 127.0.0.1 1646
user-name-format without-domain
#
domain system
access-limit disable
state active
idle-cut disable
---- More ----
1-8
1.1.10 display saved-configuration
【命令】
display saved-configuration [ by-linenum ] [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
by-linenum：显示每一行信息的行号。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display saved-configuration命令用来查看设备存储介质中保存的下次启动配置文件的内容。
可以在管理/维护设备时使用该命令确认重要的配置是否已经保存到下次启动配置文件。执行该命令
将显示下次主用启动配置文件的内容。
如果设备未设置下次启动配置文件，或下次启动配置文件不存在，执行display
saved-configuration命令会显示设备的缺省配置文件。如果缺省配置文件也不存在，系统会提示
指定的配置文件不存在。
相关配置可参考命令save、reset saved-configuration和display current-configuration。
【举例】
# 显示设备存储介质中保存的下次启动配置文件的内容。（本命令的显示信息请以设备的实际情况为
准）。
#
version 5.20, Alpha 2607P01
#
sysname WX5540E_LSW
#
domain default enable system
#
ipv6 prefer temporary-address
#
telnet server enable
#
vlan 1
#
1-9
vlan 100
arp-snooping enable
#
radius scheme system
server-type extended
primary authentication 127.0.0.1 1645
primary accounting 127.0.0.1 1646
user-name-format without-domain
#
domain system
---- More ----
以上显示的配置依次是全局配置、端口配置、用户接口配置。“---- More ----”表示这一屏信息已经
显示完毕，会暂停显示。按
息；按
# 使用行号显示设备存储介质中保存的下次启动配置文件的内容。（本命令的显示信息请以设备的实
际情况为准）。
1: #
2: version 5.20, Alpha 2607P01
3: #
4: sysname WX5540E_LSW
5: #
6: domain default enable system
7: #
8: telnet server enable
9: #
10: vlan 1
11: #
12: vlan 100
13: arp-snooping enable
14: #
15: radius scheme system
16: server-type extended
17: primary authentication 127.0.0.1 1645
18: primary accounting 127.0.0.1 1646
19: user-name-format without-domain
20: #
21: domain system
---- More ----
“---- More ----”表示这一屏信息已经显示完毕，会暂停显示。按
按
1.1.11 display startup
【命令】
display startup [ | { begin | exclude | include } regular-expression ]
1-10
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display startup命令用来显示用于本次及下次启动的配置文件名。
相关配置可参考命令startup saved-configuration。
【举例】
# 显示本次及下次启动的配置文件名。
MainBoard:
Current startup saved-configuration file: flash:/
Next main startup saved-configuration file: flash:/
Next backup startup saved-configuration file: NULL
表1-2 display startup命令显示信息描述表
字段
MainBoard
Current startup saved-configuration file
Next main startup saved-configuration file
Next backup startup saved-configuration file
描述
设备使用的本次及下次启动的配置文件名
当前启动使用的配置文件
下一次启动时使用的主用配置文件
下一次启动时使用的备用配置文件
表示配置文件不存在
(This file does not exist.)
如果用户在配置完下次启动配置文件后又将该文件删除了，这
种情况下会在文件名后显示该信息
1.1.12 display this
【命令】
display this [ by-linenum ] [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
1-11
【缺省级别】
1：监控级
【参数】
by-linenum：显示每一行信息的行编号。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display this命令用来显示当前视图下生效的配置。
当用户在某一视图下完成一组配置之后，需要验证是否配置成功，则可以执行display this命令来
查看当前生效的配置。
需要注意以下几点：
•
•
•
•
对于已经生效的配置如果与缺省情况相同，则不显示；
对于某些参数，虽然用户已经配置，但如果这些参数所在的功能没有生效，则不显示；
在任意一个用户界面视图下执行此命令，将会显示所有用户界面下生效的配置；
在任意一个VLAN视图下执行此命令，将会显示所有已创建的VLAN下的配置。
【举例】
# 显示接口GigabitEthernet1/0/1下生效的配置（该显示信息与设备当前的配置有关）。
[Sysname] interface GigabitEthernet 1/0/1
[Sysname-GigabitEthernet1/0/1] display this
#
interface GigabitEthernet1/0/1
port link-mode bridge
port link-type hybrid
undo port hybrid vlan 1
port hybrid vlan 2 to 4 untagged
port hybrid pvid vlan 2
#
return
# 显示所有用户界面下生效的配置（该显示信息与设备当前的配置有关）。
[Sysname] user-interface vty 0
[Sysname-ui-vty0] display this
#
user-interface vty 0 15
user privilege level 3
user-interface vty 1 15
#
1-12
return
1.1.13 reset saved-configuration
【命令】
reset saved-configuration [ backup | main ]
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
backup：删除备用下次启动配置文件。
main：删除主用下次启动配置文件。
【描述】
reset saved-configuration命令用来删除设备存储介质中保存的下次启动配置文件。
需要注意的是：
•
•
•
删除操作会将下次启动配置文件从设备上彻底删除，所以请慎用该命令。
如果当前设备的主备用下次启动配置文件相同，仅执行一次删除操作，系统只会将相应的下次
启动配置文件设置为NULL，但不会删除该文件。
reset saved-configuration和reset saved-configuration main命令执行效果相同：都会删
除主用下次启动配置文件。
相关配置可参考命令save和display saved-configuration。
【举例】
# 删除设备存储介质中保存的下次备用启动配置文件。
The saved configuration file will be erased. Are you sure? [Y/N]:y
Configuration file in flash is being cleared.
Please wait ...
..
MainBoard:
Configuration file is cleared.
1.1.14 restore startup-configuration
【命令】
restore startup-configuration from src-addr src-filename
【视图】
用户视图
【缺省级别】
3：管理级
1-13
【参数】
src-addr：TFTP服务器的IP地址或名称，取值范围1～20。
src-filename：源文件名
，
指定服务器上将下载的文件的文件名。
【描述】
restore startup-configuration命令用于从指定TFTP服务器上下载配置文件并设置为设备的下次
启动配置文件。
•
•
执行该命令设置的是主用下次启动配置文件。
执行该命令会将指定配置文件下载到设备存储介质的根目录下，并设置为设备的下次启动配置
文件。
如果设备上已经存在与源文件同名的文件，则提示用户，由用户选择是否覆盖。另外，检查重名文
件时，均默认使用相同类型的存储介质。
【举例】
# 从IP地址为2.2.2.2的TFTP服务器上下载文件作为设备的主用下次启动配置文件。
Restore next startup-configuration file from 2.2.2.2. finished!
1.1.15 save
【命令】
save file-url
save [ safely ] [ backup | main ] [ force ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
file-url：文件路径，必须以“.cfg”为后缀。
safely：以安全模式保存配置文件。如果不指定该参数，表示以快速保存方式保存配置文件。
backup：将当前配置保存到交互方式下指定的文件中，并将该文件设置为备用下次启动配置文件。
main：将当前配置保存到交互方式下指定的文件中，并将该文件设置为主用下次启动配置文件。
force：表示直接将当前配置保存到下次启动配置文件，系统不再输出交互信息。缺省情况下，用
户执行save命令，系统要求用户输入
系统会自动退出本次操作。如果在执行save操作时使用了force参数，则系统会直接保存当前配
置，不再需要用户输入任何信息。
【描述】
save file-url命令用来将当前配置保存到指定文件，但不会将该文件设置为下次启动配置文件。如
果file-url不存在，则系统会先创建该文件，再执行保存操作。
save [ safely ] [ backup | main ] [ force ]命令用来将当前配置保存到存储介质的根目录，并将该文
件设置为下次启动配置文件。不指定backup或main参数时，则缺省使用main。
1-14
相关配置可参考命令reset saved-configuration、display current-configuration和display
saved-configuration。
【举例】
# 将当前配置保存到存储介质的根目录，并将该文件设置为下次启动配置文件。
MainBoard:
Current startup saved-configuration file: NULL
Next main startup saved-configuration file: flash:/
Next backup startup saved-configuration file: NULL
//
以上显示信息表明设备的主用下次启动文件均为
。
The current configuration will be written to the device. Are you sure? [Y/N]:y
Please input the file name(*.cfg)[flash:/]
(To leave the existing filename unchanged, press the enter key):
flash:/ exists, overwrite? [Y/N]:y
Validating file.
Saved the current configuration to mainboard device successfully.
MainBoard:
Current startup saved-configuration file: NULL
Next main startup saved-configuration file: flash:/
Next backup startup saved-configuration file: NULL
//
以上显示信息表明设备的主用下次启动文件均已经改为
。
1.1.16 startup saved-configuration
【命令】
startup saved-configuration cfgfile [ backup | main ]
undo startup saved-configuration
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
cfgfile：配置文件的名称，该文件必须是存储介质根目录下、后缀为.cfg的文件。
backup：将配置文件设置为备用下次启动配置文件。
main：将配置文件设置为主用下次启动配置文件。
【描述】
startup saved-configuration命令用来配置设备的下次启动配置文件（系统下次启动时使用的配
置文件）。undo startup saved-configuration命令用来设置设备以空配置启动（空配置启动指使
用设备的出厂配置启动）。
使用本命令前，请确保指定的配置文件已经保存在设备存储介质的根目录下，否则，操作失败。
1-15
使用该命令设置配置文件时：
•
•
startup saved-configuration和startup saved-configuration main命令执行效果相同：都
是用来配置主用下次启动配置文件。
主用下次启动配置文件和备用下次启动配置文件可以设置为同一文件，但为了更可靠，建议设
置为不同的文件，或者将一份配置保存在两个不同名的文件中，一个设置为主用，一个设置为
备用。
在执行undo startup saved-configuration命令之后，系统会将主用/备用下次启动配置文件
均设置为NULL，但不会删除该文件。
•
相关配置可参考命令display startup。
【举例】
# 配置下次启动使用的配置文件。
Please wait ...
Setting the master board ..........
... Done!
1-16
目 录
1 设备管理 ············································································································································ 1-1
1.1 设备管理配置命令 ····························································································································· 1-1
1.1.1 clock datetime ························································································································· 1-1
1.1.2 clock summer-time one-off ····································································································· 1-1
1.1.3 clock summer-time repeating ································································································· 1-2
1.1.4 clock timezone ························································································································ 1-4
1.1.5 copyright-info enable ·············································································································· 1-4
1.1.6 display alarm ·························································································································· 1-5
1.1.7 display clock ··························································································································· 1-6
1.1.8 display copyright ····················································································································· 1-7
1.1.9 display cpu-usage··················································································································· 1-8
1.1.10 display cpu-usage history ··································································································· 1-10
1.1.11 display device ····················································································································· 1-12
1.1.12 display device manuinfo ····································································································· 1-13
1.1.13 display diagnostic-information ···························································································· 1-14
1.1.14 display job ··························································································································· 1-15
1.1.15 display memory ·················································································································· 1-16
1.1.16 display reboot-type ············································································································· 1-17
1.1.17 display schedule job ··········································································································· 1-18
1.1.18 display schedule reboot ······································································································ 1-18
1.1.19 display system-failure ········································································································· 1-19
1.1.20 display transceiver ·············································································································· 1-20
1.1.21 display transceiver alarm ···································································································· 1-21
1.1.22 display transceiver diagnosis ····························································································· 1-23
1.1.23 display transceiver manuinfo ······························································································ 1-24
1.1.24 display version ···················································································································· 1-25
1.1.25 display version-update-record ···························································································· 1-26
1.1.26 header ································································································································ 1-27
1.1.27 job ······································································································································· 1-29
1.1.28 reboot ································································································································· 1-30
1.1.29 reset unused porttag ·········································································································· 1-30
1.1.30 reset version-update-record ······························································································· 1-31
1.1.31 schedule job ······················································································································· 1-31
i
1.1.32 schedule reboot at ·············································································································· 1-33
1.1.33 schedule reboot delay ········································································································ 1-34
1.1.34 shutdown-interval ··············································································································· 1-35
1.1.35 sysname ····························································································································· 1-36
1.1.36 system-failure ····················································································································· 1-36
1.1.37 time at ································································································································· 1-37
1.1.38 time delay ··························································································································· 1-39
1.1.39 view ···································································································································· 1-40
ii
1
设备管理
1.1
设备管理配置命令
1.1.1 clock datetime
【命令】
clock datetime time date
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
time：设置的时间，格式为HH:MM:SS（小时:分钟:秒），HH取值范围为0～23，MM和SS取值
范围为0～59。如果是零点，整个time参数可简写为0。
date：设置的日期，格式为MM/DD/YYYY（月/日/年）或者YYYY/MM/DD（年/月/日），MM的取
值范围为1～12，DD的取值范围与月份有关，YYYY的取值范围为2000～2035。
【描述】
clock datetime命令用来设置时间和日期。
在需要严格获取绝对时间的应用环境中，必须设定设备当前日期和时钟。在输入时间参数时，可以
不输入秒。
相关配置可参考命令clock summer-time one-off、clock summer-time repeating、clock
timezone和display clock。
【举例】
# 设置设备的系统时间为2013年1月1日14时10分20秒。
# 设置设备的系统时间为2013年1月1日零点6分。
1.1.2 clock summer-time one-off
【命令】
clock summer-time zone-name one-off start-time start-date end-time end-date add-time
undo clock summer-time
【视图】
系统视图
【缺省级别】
3：管理级
1-1
【参数】
zone-name：夏令时名称，为1～32个字符的字符串，区分大小写。
start-time：起始时间，格式为HH:MM:SS，除表示零点外，格式中的其它0可以省略不写。
start-date：起始日期，格式为YYYY/MM/DD或MM/DD/YYYY。
end-time：结束时间，格式为HH:MM:SS，除表示零点外，格式中的其它0可以省略不写。
end-date：结束日期，格式为YYYY/MM/DD或MM/DD/YYYY。
add-time：相对于标准时间增加的时间，格式为HH:MM:SS，除表示零点外，格式中的其它0可以
省略不写。
【描述】
clock summer-time one-off命令用来设置从“起始日期”的“起始时间”到“结束日期”的“结
束时间”这个时间段内采用夏令时制，夏令时间要比设备的当前时间增加“add-time”。undo clock
summer-time命令用来取消夏令时设置。
缺省情况下，设备上没有配置夏令时，本地采用UTC（Universal Time Coordinated，世界调整时
间）时间。
设置完成后，可以使用display clock命令进行查看。日志、debug等信息时间将采用经过时区和
夏令时调整过的本地时间。
需要注意的是：
•
•
从“起始日期”的“起始时间”到“结束日期”的“结束时间”这个时间段长度必须大于1
天小于1年，否则视为无效参数，配置失败。
如果当前系统时间在该命令指定的时间段内，则执行该命令后，系统时间将自动增加
“add-time”。
相关配置可参考命令clock datetime、clock summer-time repeating、clock timezone和display
clock。
【举例】
# 设置夏令时abc1，从2013年8月1日的06:00:00开始，到2013年9月1日的06:00:00结束，
比当前设备标准时间增加1小时。
[Sysname] clock summer-time abc1 one-off 6 08/01/2013 6 09/01/2013 1
1.1.3 clock summer-time repeating
【命令】
clock summer-time zone-name repeating start-time start-date end-time end-date add-time
undo clock summer-time
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
zone-name：夏令时名称，为1～32个字符的字符串。
1-2
start-time：起始时间，格式为HH:MM:SS，除表示零点外，格式中的其它0可以省略不写。
start-date：起始日期，有两种设置方式：
•
•
直接一次性输入年月日，参数格式为YYYY/MM/DD或MM/DD/YYYY。
分次输入年、月、日，各参数之间以<空格>键隔开。首先输入开始的年份，取值范围2000～
2035；其次输入开始的月份，取值如下：January、February、March、April、May、June、
July、August、September、October、November、December；然后输入开始的星期（用
当月的第几个星期表示），取值如下：first、second、third、fourth、fifth、last；最后输入
起始日，取值为Sunday、Monday、Tuesday、Wednesday、Thursday、Friday、Saturday。
end-time：结束时间，格式为HH:MM:SS，除表示零点外，格式中的其它0可以省略不写。
end-date：结束日期，有两种设置方式：
•
•
直接一次性输入年月日，参数格式为YYYY/MM/DD或MM/DD/YYYY。
分次输入年、月、日，各参数之间以<空格>键隔开。首先输入结束的年份，取值范围2000～
2035；其次输入结束的月份，取值如下：January、February、March、April、May、June、
July、August、September、October、November、December；然后输入结束的星期（用
当月的第几个星期表示），取值如下：first、second、third、fourth、fifth、last；最后输入
结束日，取值为：Sunday、Monday、Tuesday、Wednesday、Thursday、Friday、Saturday。
add-time：相对于设备当前标准时间增加的时间，格式为HH:MM:SS，除表示零点外，格式中的其
它0可以省略不写。
【描述】
clock summer-time repeating命令用来设置设备重复采用夏令时制。undo clock summer-time
命令用来取消夏令时设置。
缺省情况下，设备上没有配置夏令时，本地采用UTC（Universal Time Coordinated，世界调整时
间）时间。
比如，当指定“start-date”和“start-time”为“2013/6/6”和“00:00:00”，指定“end-date”和
“end-time”为“2013/10/1
”和“00:00:00”，指定“add-time”为“01:00:00”，则表示从2013
年开始（包括2013年）以后每年的6月6号的零点整到10月1号的零点整，都采用夏令时制，夏
令时间要比设备的当前标准时间增加1小时。
设置完成后，可以使用display clock命令进行查看。日志、debug等信息时间将采用经过时区和
夏令时调整过的本地时间。
需要注意的是：
•
•
从“起始日期”的“起始时间”到“结束日期”的“结束时间”这个时间段长度必须大于1
天小于1年，否则视为无效参数，配置失败。
如果当前系统时间在该命令作用的时间段内，则执行该命令后，系统时间将自动增加
“add-time”。
相关配置可参考命令clock datetime、clock summer-time one-off、clock timezone和display
clock。
【举例】
# 设置夏令时abc2，从2013年开始（包括2013年）以后每年的8月1日的06:00:00到9月1日
的06:00:00，比当前系统时间增加1小时。
[Sysname] clock summer-time abc2 repeating 06:00:00 08/01/2013 06:00:00 09/01/2013 01:00:00
1-3
1.1.4 clock timezone
【命令】
clock timezone zone-name { add | minus } zone-offset
undo clock timezone
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
zone-name：时区名称，为1～32个字符的字符串，区分大小写。
add：在UTC（Universal Time Coordinated，通用协调时间）标准时间的基础上增加指定时间。
minus：在UTC标准时间的基础上减少指定时间。
zone-offset：与UTC的时间差，格式为HH:MM:SS，HH取值范围为0～23，MM和SS取值范围
为0～59，除表示零点外，格式中的其它0可以省略不写。
【描述】
clock timezone命令用来对本地时区信息进行设置。undo clock timezone命令用来恢复缺省情
况。
缺省情况下，本地时区采用UTC（Universal Time Coordinated，世界调整时间）时区。
设置生效后，可以用display clock命令进行查看。日志、debug等信息时间将采用经过时区和夏
令时调整过的本地时间。
相关配置可参考命令clock datetime、clock summer-time one-off、clock summer-time
repeating和display clock。
【举例】
# 设置本地时区名称为Z5，比UTC标准时间增加5小时。
[Sysname] clock timezone Z5 add 5
1.1.5 copyright-info enable
【命令】
copyright-info enable
undo copyright-info enable
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
无
1-4
【描述】
copyright-info enable命令用来使能显示版权信息。undo copyright-info enable命令用来禁止
显示版权信息。
缺省情况下，显示版权信息处于使能状态。
【举例】
# 配置使能显示版权信息。
[Sysname] copyright-info enable
•
使用Telnet方式登录设备，会显示如下信息：
**************************************************************************
* Copyright (c) 2004-2013 Hangzhou H3C Tech. Co., Ltd. All rights reserved.*
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
****************************************************************************
•
如果当前已经使用OAP方式登录设备了，再退出用户视图，会显示如下信息：
**************************************************************************
* Copyright (c) 2004-2013 Hangzhou H3C Tech. Co., Ltd. All rights reserved.*
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
****************************************************************************
User interface aux0 is available.
Please press ENTER.
# 禁止显示版权信息。
[Sysname] undo copyright-info enable
•
•
使用Telnet方式登录设备，会显示如下信息：
如果当前已经使用OAP方式登录设备了，再退出用户视图，会显示如下信息：
User interface aux0 is available.
Please press ENTER.
1.1.6 display alarm
【命令】
display alarm [ | { begin | exclude | include } regular-expression ]
1-5
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display alarm命令用来显示设备的告警信息。
用户执行该命令后，系统会自动查询并显示设备上的当前告警信息。
【举例】
# 显示设备的告警信息（本命令的显示信息与设备型号有关，请以设备的实际情况为准）。
Slot Level Info
6 ERROR Fan 2 is absent.
6 ERROR Power 2 is absent.
3 WARNING The temperature of sensor 3 exceeds the lower limit.
表1-1 display alarm命令显示信息描述表
字段
Slot
Level
Info
Fan n is absent.
Power n is absent.
感知该告警的设备号
告警的级别，级别由高到低依次为ERROR、WARNING、NOTICE、INFO
告警的详细信息
风扇n当前不在位
电源n当前不在位
描述
The temperature of sensor n
传感器 n的温度低于低温门限
exceeds the lower limit.
The temperature of sensor n
传感器 n的温度高于高温门限
exceeds the upper limit.
1.1.7 display clock
【命令】
display clock [ | { begin | exclude | include } regular-expression ]
1-6
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display clock命令用来显示系统当前的时间和日期。
该时间由clock datetime、clock summer-time one-off（或者clock summer-time repeating）
和clock timezone命令联合决定，规则请参见配置手册中的“配置系统时间”一节。
相关配置可参考命令clock datetime、clock summer-time one-off、clock summer-time
repeating和clock timezone。
【举例】
# 查看系统当前日期和时间。
09:41:23 UTC Thu 12/15/2013
1.1.8 display copyright
【命令】
display copyright [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
1-7
【描述】
display copyright命令用来显示系统软件和硬件的详细版权信息。
通过查看版权信息，可以获知系统当前使用软件和硬件版本的版权信息、版权的参照标准、版权证
书等相关信息。
【举例】
# 显示系统软件和硬件的详细版权信息。（显示信息略，请以设备的实际情况为准）
1.1.9 display cpu-usage
【命令】
display cpu-usage [ slot slot-number [ cpu cpu-number ] ] [ | { begin | exclude | include }
regular-expression ]
display cpu-usage entry-number [ offset ] [ verbose ] [ slot slot-number [ cpu cpu-number ] ] [ |
{ begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
entry-number：指定执行一次本命令将显示的条目数，取值范围为1～60。
offset：起始显示条目序号到最新条目序号之间的偏移量，取值范围为0～59。比如，最新生成的统
计信息的idx是12，如果offset设置为3，则会从idx是9的统计信息开始显示（idx表示的是第几
个周期的统计信息，从0到60循环计数。系统按周期统计CPU利用率，当一个周期结束时，就会
记录该周期内CPU的平均利用率，idx会自动加1）。
verbose：显示CPU利用率的详细信息。不使用该参数时，
显示的是简要的CPU利用率统计信息，
使用该参数时，会详细显示指定统计周期内各个任务的平均CPU利用率。
slot slot-number：取值恒定为1，表示WX5540E交换引擎。
cpu cpu-number：显示指定CPU的利用率统计信息。cpu-number表示CPU的编号取值范围为0～
3。不使用该参数时，显示指定WX5540E交换引擎所有CPU的相应信息。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display cpu-usage命令用来显示CPU利用率的统计信息。
1-8
系统每隔一定的时间（通常为60秒）对CPU的利用率进行统计，并把统计结果保存到历史记录区。
display cpu-usage entry-number表示从最新记录（倒数第一条记录）开始，显示entry-number
条记录。display cpu-usage entry-number offset表示从倒数第（offset+1）条记录开始，显示
entry-number条记录。
【举例】
# 显示当前CPU利用率统计信息。
Slot 1 CPU usage:
6% in last 5 seconds
10% in last 1 minute
5% in last 5 minutes
# 显示CPU利用率统计信息历史记录区中的倒数第5和倒数第6号记录。
===== CPU usage info (no: 0 idx: 58) =====
CPU Usage Stat. Cycle: 60 (Second)
CPU Usage : 3%
CPU Usage Stat. Time : 2013-07-10 10:56:55
CPU Usage Stat. Tick : 0x1d9d(CPU Tick High) 0x3a659a70(CPU Tick Low)
Actual Stat. Cycle : 0x0(CPU Tick High) 0x95030517(CPU Tick Low)
===== CPU usage info (no: 1 idx: 57) =====
CPU Usage Stat. Cycle: 60 (Second)
CPU Usage : 3%
CPU Usage Stat. Time : 2013-07-10 10:55:55
CPU Usage Stat. Tick : 0x1d9c(CPU Tick High) 0xa50e5351(CPU Tick Low)
Actual Stat. Cycle : 0x0(CPU Tick High) 0x950906af(CPU Tick Low)
表1-2 display cpu-usage命令显示信息描述表
字段
1% in last 5 seconds
1% in last 1 minute
1% in last 5 minutes
Slot 1 CPU usage
CPU usage info (no: idx:)
描述
设备启动后，会以5秒为周期计算并记录一次该5秒内的CPU的平均利用率。
该字段显示的是最近一个5秒统计周期内CPU的平均利用率
设备启动后，会以1分钟为周期计算并记录一次该1分钟内的CPU的平均利用
率。该字段显示的是最近一个1分钟统计周期内CPU的平均利用率
设备启动后，会以5分钟为周期计算并记录一次该5分钟内的CPU的平均利用
率。该字段显示的是最近一个5分钟统计周期内CPU的平均利用率
设备的CPU利用率信息
CPU利用率纪录的信息（no：第no+1条记录，no从0开始编号，记录越新编
号越小；idx：本次记录在历史记录表中的索引）（如果只显示系统当前CPU
的利用率信息，则no和idx的显示省略）
CPU利用率统计的时间区间（单位为秒），比如Cycle值为41，则表示统计
的是最近41秒时间内CPU利用率的平均值。该参数的取之范围为1～60
CPU利用率统计的时间区间内，CPU利用率的平均值（单位为%）
CPU利用率统计结束时间（单位为秒），即执行显示命令时的系统时间
CPU Usage Stat. Cycle
CPU Usage
CPU Usage Stat. Time
1-9
字段
CPU Usage Stat. Tick
描述
系统运行时间（单位tick，用64位的十六进制数表示，其中CPU Tick High表
示高32位，CPU Tick Low表示低32位）
CPU利用率统计的实际时间区间（单位tick，用64位的十六进制数表示，其
中CPU Tick High表示高32位，CPU Tick Low表示低32位）（因为它的精度
高于秒，所以不同记录的实际周期会有细微差别）
Actual Stat. Cycle
1.1.10 display cpu-usage history
【命令】
display cpu-usage history [ task task-id ] [ slot slot-number [ cpu cpu-number ] ] [ | { begin |
exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
task task-id：显示指定任务的CPU利用率的统计历史信息，task-id表示任务编号。不使用该参数
时，显示的是整个系统的相应信息（整个系统的CPU利用率等于所有任务CPU利用率之和）。
slot slot-number：显示设备的CPU利用率的统计历史信息。slot-number固定为1。
cpu cpu-number：显示指定CPU的利用率统计历史信息。cpu-number表示CPU的编号，取值范
围为0～3。不带该参数时，显示的是主CPU的相应信息。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display cpu-usage history
命令用来以图形方式显示CPU利用率统计历史信息。
不指定参数时，将显示系统CPU利用率统计信息。
系统每隔一定时间会对CPU的利用率进行统计，并把统计结果保存到历史记录区。通过display
cpu-usage history命令可以查看到最近60分钟记录的CPU利用率统计值。结果以坐标的形式进
行显示，显示信息中：
•
•
•
纵坐标表示利用率，采用就近显示的原则。比如，利用率的间隔为5％，则实际统计值53％
将被显示成55％，实际统计值52％将被显示成50％。
横坐标表示时间，时间越靠左表示距离当前时间越近。
用连续的＃号表示该时刻的利用率，某个时间点上最高处的#号对应的纵坐标值即为该时刻
CPU的利用率。
1-10
【举例】
# 显示整个系统的CPU利用率统计信息。
100%|
95%|
90%|
85%|
80%|
75%|
70%|
65%|
60%|
55%|
50%|
45%|
40%|
35%|
30%|
25%|
20%|
15%| #
10%| ### #
5%| ########
------------------------------------------------------------
10 20 30 40 50 60 (minutes)
cpu-usage last 60 minutes(SYSTEM)
以上显示信息表明整个系统（任务名为SYSTEM）在最近60分钟内CPU的占有率情况：12分钟
前大约为5％，13分钟前大约为10％，14分钟前大约为15％，15分钟前大约为10％，16、17
分钟前大约为5％，18分钟前大约为10％，19分钟前大约为5％，其它时间均小于或等于2％。
# 显示编号为6的任务的CPU利用率统计信息。
100%|
95%|
90%|
85%|
80%|
75%|
70%|
65%|
60%|
55%|
50%|
45%|
40%|
35%|
30%|
25%|
1-11
20%|
15%|
10%|
5%| #
------------------------------------------------------------
10 20 30 40 50 60 (minutes)
cpu-usage last 60 minutes(T03M)
以上显示信息表明编号为6的任务（任务名为T03M）在最近60分钟内CPU的占有率情况：20
分钟前大约为5％，其它时间均小于或等于2％。
1.1.11 display device
【命令】
display device [ verbose ] [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
verbose：显示详细信息。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display device命令用来显示设备信息。
【举例】
# 显示设备的设备信息（注意：本命令的显示信息与设备型号有关，请以设备的实际情况为准）。
Slot 1
SubSNo PortNum PCBVer FPGAVer CPLDVer BootRomVer AddrLM Type State
0 33 Ver.A NULL 003 003 1.02 IVL MAIN Normal
表1-3 display device命令显示信息描述表
字段
Slot 1
SubSNo
PortNum
设备信息
主机所在的槽位号
主机支持的最大端口数
1-12
描述
字段
PCBVer
FPGAVer
CPLDVer
BootRomVer
描述
主机的PCB（Printed Circuit Board，印刷电路板）版本
主机的FPGA版本
主机的CPLD版本
主机的BootRom版本
地址学习模式
AddrLM
•
IVL（Independant VLAN Learning）：独立VLAN学习模式
•
SVL（Shared VLAN Learning）：共享VLAN学习模式
Type 主机的类型
主机的状态
State
•
Normal：表示工作正常
•
Absent：表示不在位
•
Fault：表示出现故障
1.1.12 display device manuinfo
【命令】
display device manuinfo slot slot-number [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
3：管理级
【参数】
slot slot-number：显示设备的电子标签信息。slot-number固定为１。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display device manuinfo命令用来显示设备的电子标签信息。
电子标签信息也可以称为永久配置数据或档案信息等，在设备的调测（调试、测试）过程中被写入
到设备的存储器件中，包括设备的名称、生产序列号、MAC地址、制造商等信息。本命令显示的
是设备的部分电子标签信息。
【举例】
# 显示设备的电子标签信息（本命令的显示信息与设备型号有关，请以设备的实际情况为准）。
1-13
Slot 1:
DEVICE_NAME : WX5540E_LSW
DEVICE_SERIAL_NUMBER : DPPMWWB123456
MAC_ADDRESS : 00E0-FC00-5800
MANUFACTURING_DATE : 2013-05-08
VENDOR_NAME : H3C
表1-4 display device manuinfo命令信息显示描述表
字段
Slot
DEVICE_NAME
DEVICE_SERIAL_NUMBER
MAC_ADDRESS
MANUFACTURING_DATE
VENDOR_NAME
设备编号
设备名称
社备序列号
设备出厂MAC地址
设备调测日期
制造商名称
描述
1.1.13 display diagnostic-information
【命令】
display diagnostic-information [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display diagnostic-information命令用来显示或保存系统当前多个功能模块运行的统计信息。
在日常维护或系统出现故障时，为了便于问题定位，用户需要查看各个功能模块的运行信息。但各
个功能模块都有对应的display命令，逐条执行比较繁琐。为便于一次性收集更多信息，用户可以
在任意视图下执行display diagnostic-information命令，显示或保存系统当前多个功能模块运行
的统计信息。
1-14
【举例】
# 保存系统当前各个功能模块运行的统计信息。
Save or display diagnostic information (Y=save, N=display)? [Y/N]:y
Please input the file name(*.diag)[flash:/]:
Diagnostic information is outputting to flash:/.
Save succeeded.
再在用户视图下执行“more ”命令，配合使用
文件的记录的内容。
# 显示系统当前各个功能模块运行的统计信息（因为显示信息多，而且跟设备型号有关，请以设备
的实际情况为准，此处略）。
Save or display diagnostic information (Y=save, N=display)? [Y/N]:n
=================================================
===============display clock===============
=================================================
08:54:16 UTC Fri 11/15/2013
===================================================
===============display version===============
===================================================
……略……
1.1.14 display job
【命令】
display job [ job-name ] [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【命令级别】
1：监控级
【参数】
job-name：任务名，为1～32个字符的字符串。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display job命令用来查看定时执行任务的具体配置。
不带参数时表示查看当前所有定时执行任务的具体配置。
1-15
相关配置可参考命令job、time和view。
【举例】
# 查看定时执行任务saveconfig的具体配置。
Job name: saveconfig
Specified view: monitor
Time 1: Execute command save after 40 minutes
以上显示信息表明，40分钟后系统将自动将当前运行的配置保存到配置文件。
表1-5 display job命令显示信息描述表
字段
Job name
Specified view
Time timeID
Execute command
定时执行任务名
定时执行任务中命令所在视图
定时执行任务中包含的各命令执行时间记录
命令字符串
说明
1.1.15 display memory
【命令】
display memory [ slot slot-number [ cpu cpu-number ] ] [ | { begin | exclude | include }
regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
slot slot-number：显示设备的CPU的内存使用状况。slot-number固定为1。
cpu cpu-number：显示指定CPU的内存使用状况。cpu-number表示CPU的编号。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display memory命令用来显示设备内存的使用状况。
不带cpu参数时，显示的是主CPU的相应信息。
1-16
【举例】
# 显示设备内存的使用状况。
System Total Memory(bytes): 337495520
Total Used Memory(bytes): 108441564
Used Rate: 32%
表1-6 display memory命令显示信息描述表
字段
System Total Memory(bytes)
Total Used Memory(bytes)
Used Rate
描述
系统的总内存大小，单位为字节
已经使用的内存大小，单位为字节
已经使用的内存占总内存的比例
1.1.16 display reboot-type
【命令】
display reboot-type [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display reboot-type命令用来显示系统的启动方式。
【举例】
# 显示设备的启动方式。
The rebooting type this time is: Cold
以上显示信息表明：设备最近一次的重启方式为冷启动（Cold，表示本次是通过上电方式启动的设
备）。（当显示Warm时表示启动方式为热启动，表示本次是通过reboot等命令启动的设备）
1-17
1.1.17 display schedule job
【命令】
display schedule job [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display schedule job用来查看定时执行功能的具体配置。
相关配置可参考命令schedule job。
【举例】
# 查看当前定时执行功能的具体配置。
Specified command: execute
Specified view: system view
Executed time: at 12:00 10/31/2013 (in 0 hours and 16 minutes)
如果在16分钟内修改了系统时间，则定时执行批处理文件的配置将失效。再次使用display
schedule job命令查看时，显示为空。
表1-7 display schedule job命令显示信息描述表
字段
Specified command
Specified view
Executed time
定时执行的命令字符串
为定时执行的命令指定的视图
系统自动执行指定命令的时间点及与当前系统时间的间隔
描述
1.1.18 display schedule reboot
【命令】
display schedule reboot [ | { begin | exclude | include } regular-expression ]
1-18
【视图】
任意视图
【缺省级别】
3：管理级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display schedule reboot命令用来显示用户设置的设备重启时间。
相关配置可参考命令schedule reboot at和schedule reboot delay。
【举例】
# 显示设备的重启时间。
System will reboot at 16:00:00 03/10/2013 (in 2 hours and 5 minutes).
以上显示信息表明，系统将在2013年3月10日16点（2小时零5分钟之后）重启。
1.1.19 display system-failure
【命令】
display system-failure [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
3：管理级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display system-failure命令用来显示设备系统异常时的处理方式。
相关配置可参考命令system-failure。
1-19
【举例】
# 显示异常情况下系统的处理方式。
System failure handling method: reboot
1.1.20 display transceiver
【命令】
display transceiver interface [ interface-type interface-number ] [ | { begin | exclude | include }
regular-expression ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
interface [ interface-type interface-number ]：显示接口上插入的可插拔接口模块的主要特征参数。
interface-type interface-number：表示接口类型和接口编号，如果不指定该参数，表示显示所有接
口下的该信息。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display transceiver命令用来显示可插拔接口模块的主要特征参数。
【举例】
# 显示接口GigabitEthernet1/0/22上插入的可插拔接口模块的主要特征参数（本命令的显示信息与
设备型号有关，请以设备的实际情况为准）。
GigabitEthernet1/0/22 transceiver information:
Transceiver Type : 1000_BASE_SX_SFP
Connector Type : LC
Wavelength(nm) : 850
Transfer Distance(m) : 550(50um),270(62.5um)
Digital Diagnostic Monitoring : YES
Vendor Name : H3C
Ordering Name : SFP-GE-SX-MM850
1-20
表1-8 display transceiver命令显示信息描述表
字段
transceiver information
Transceiver Type
可插拔接口模块信息
可插拔接口模块的物理型号
可插拔接口模块的连接器类型，其中：
描述
•
光纤连接器包括SC（SC Connector，NTT公司推出的拔插锁紧式光纤连接
Connector Type
器）、LC（LC Connector，Lucent公司推出的1.25mm/RJ45锁紧式光纤连接
器）两种类型
•
其他连接器包括RJ-45、CX4等类型
•
光模块：显示发送激光中心波长，单位nm；对于支持多条不同波长光路的模
Wavelength(nm)
块（例如10GBASE-LX4模块），各个波长值之间用逗号分隔
•
电模块：显示为“N/A”
传输距离，对于单模模块，xx显示为km，其他模块xx显示为m。当模块支持多种
传输介质时，各个传输距离值之间用逗号分隔。距离值后面括号里包含对应的“传
输介质”。下面是各个介质的名称：
•
9um：表示9/125um单模光纤
Transfer Distance(xx)
•
50um：表示50/125um多模光纤
•
62.5um：表示62.5/125um多模光纤
•
TP：表示双绞线
•
CX4：表示CX4电缆
对数字诊断功能的支持情况，其中：
Digital Diagnostic
Monitoring
Vendor Name
Ordering Name
•
YES：表示支持数字诊断
•
NO：表示不支持数字诊断
模块生产或定制厂商名称
可插拔接口模块的对外型号
1.1.21 display transceiver alarm
【命令】
display transceiver alarm interface [ interface-type interface-number ] [ | { begin | exclude |
include } regular-expression ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
interface [ interface-type interface-number ]：显示接口上插入的可插拔接口模块的当前故障告警
信息。interface-type interface-number表示接口类型和接口编号，如果不指定该参数，表示显示所
有接口下的该信息。
1-21
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display transceiver alarm命令用来显示可插拔接口模块的当前故障告警信息。
如果没有故障，则显示为“None”。
目前，使用的可插拔接口模块可能出现的故障告警信息见表1-9
。
表1-9 display transceiver alarm命令输出信息描述表
字段
SFP/SFP+
RX loss of signal
RX power high
RX power low
TX fault
TX bias high
TX bias low
TX power high
TX power low
Temp high
Temp low
Voltage high
Voltage low
Transceiver info I/O error
Transceiver info checksum error
Transceiver type and port configuration
mismatch
Transceiver type not supported by port hardware
接收信号丢失
接收光功率高告警
接收光功率低告警
发送错误
偏置电流高告警
偏置电流低告警
发送光功率高告警
发送光功率低告警
温度高告警
温度低告警
电压高告警
电压低告警
模块信息读写错误
模块信息校验和错误
模块类型和端口配置不匹配
端口不支持该模块类型
描述
【举例】
# 显示接口GigabitEthernet1/0/22上插入的可插拔接口模块的当前故障告警信息（本命令的显示信
息与设备型号有关，请以设备的实际情况为准）。
GigabitEthernet1/0/22 transceiver current alarm information:
1-22
RX loss of signal
RX power low
表1-10 display transceiver alarm显示信息描述表
字段
transceiver current alarm information
RX loss of signal
RX power low
描述
接口光模块当前故障告警信息
接收信号丢失
接收光功率低告警
1.1.22 display transceiver diagnosis
【命令】
display transceiver diagnosis interface [ interface-type interface-number ] [ | { begin | exclude
| include } regular-expression ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
interface [ interface-type interface-number ]：显示接口上插入的可插拔光模块的数字诊断参数的
当前测量值。interface-type interface-number表示接口类型和接口编号，如果不指定该参数，表示
显示所有接口下的该信息。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display transceiver diagnosis命令用来显示可插拔光模块的数字诊断参数的当前测量值。
电子标签信息的显示与可插拔接口模块的类型有关，请以设备的实际情况为准。
【举例】
# 显示接口GigabitEthernet1/0/22上插入的可插拔光模块的数字诊断参数的当前测量值（本命令的
显示信息与设备型号有关，请以设备的实际情况为准）。
1-23
GigabitEthernet1/0/22 transceiver diagnostic information:
Current diagnostic parameters:
Temp(°C) Voltage(V) Bias(mA) RX power(dBM) TX power(dBM)
36 3.31 6.13 -35.64 -5.19
表1-11 display transceiver diagnosis显示信息描述表
字段
transceiver diagnostic information
Current diagnostic parameters
Temp.(°C)
Voltage(V)
Bias(mA)
RX power(dBM)
TX power(dBM)
描述
接口插入的光模块的数字诊断信息
当前的诊断参数
数字诊断参数——温度，单位为°C，精确到1°C
数字诊断参数——电压，单位为V，精确到0.01V
数字诊断参数——偏置电流，单位为mA，精确到0.01mA
数字诊断参数——接收光功率，单位为dBM，精确到0.01dBM
数字诊断参数——发送光功率，单位为dBM，精确到0.01dBM
1.1.23 display transceiver manuinfo
【命令】
display transceiver manuinfo interface [ interface-type interface-number ] [ | { begin | exclude
| include } regular-expression ]
【视图】
任意视图
【缺省级别】
2：系统级
【参数】
interface [ interface-type interface-number ]：显示接口上插入的可插拔接口模块的部分电子标签
信息。interface-type interface-number表示接口类型和接口编号，如果不指定该参数，表示显示所
有接口下的该信息。
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display transceiver manuinfo命令用于显示可插拔接口模块的部分电子标签信息。
1-24
数字诊断参数的显示与可插拔接口模块的类型有关，请以设备的实际情况为准。
【举例】
# 显示接口GigabitEthernet1/0/22上插入的可插拔接口模块的部分电子标签信息（本命令的显示信
息与设备型号有关，请以设备的实际情况为准）。
GigabitEthernet1/0/22 transceiver manufacture information:
Manu. Serial Number : 213410A1
Manufacturing Date : 2013-03-01
Vendor Name : H3C
表1-12 display transceiver manuinfo命令显示信息描述表
字段
Manu. Serial Number
Manufacturing Date
Vendor Name
描述
在调测（调试、测试）过程中生成的序列号
调测日期，取值为调测平台计算机的系统日期
定制厂商名称，即H3C
1.1.24 display version
【命令】
display version [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display version命令用来显示系统版本信息。
通过查看版本信息，可以获知系统当前使用的软件版本、机架类型及设备的相关信息。
1-25
【举例】
# 查看系统版本信息（不同设备的版本信息不同，请以设备的实际情况为准，此处略）。
H3C Comware Platform Software
Comware Software, Version 5.20, Alpha 2607P04
Copyright (c) 2004-2013 Hangzhou H3C Tech. Co., Ltd. All rights reserved.
H3C WX5540E-LSW uptime is 1 week, 1 day, 20 hours, 57 minutes
H3C WX5540E-LSW with 2 Processors
1024M bytes DDR3
16M bytes Nor Flash Memory
Config Register points to Nor Flash
Hardware Version is Ver.A
CPLDA Version is 003, CPLDB Version is 003
BootRom Version is 1.02
[SubSlot 0] 12GE+12SFP+4SFP Plus Hardware Version is Ver.A
表1-13 display version命令显示信息描述表
字段
H3C Comware Platform Software
Version 5.20, Alpha 2607P04
Copyright (c) 2004-2013 Hangzhou H3C
Tech. Co., Ltd. All rights reserved.
字段显示信息描述
交换机软件的运行平台
交换机软件的版本号
交换机的版权信息
H3C WX5540E-LSW uptime is 1 week, 1 day,
交换机本次启动后已运行时间
20 hours, 57 minutes
DDR3
Nor Flash Memory
Hardware Version
CPLDA Version
BootRom Version
[SubSlot 0]
交换机内存容量
交换机Nor Flash容量
交换机的硬件版本号
交换机上A型CPLD（Complex Programmable Logical Device，
复杂可编程逻辑器件）的版本
交换机BootRom的版本
交换机的端口类型、数量及硬件版本
1.1.25 display version-update-record
【命令】
display version-update-record [ | { begin | exclude | include } regular-expression ]
【视图】
任意视图
1-26
【缺省级别】
3：管理级
【参数】
|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中
的“CLI”。
begin：从包含指定正则表达式的行开始显示。
exclude：只显示不包含指定正则表达式的行。
include：只显示包含指定正则表达式的行。
regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。
【描述】
display version-update-record命令用来显示软件（即系统启动文件）版本更新操作的记录。
设备启动时会记录当前使用的软件版本信息，如果在运行过程中进行软件版本更新操作，系统会记
录该次更新的简要信息，包括升级时间和版本，以便管理员及时了解相关信息。
相关配置可参考reset version-update-record。
【举例】
# 显示设备软件版本更新操作的记录。
No. Update time version
1 2013-04-28 14:39:11 5.20 Release 0000
表1-14 display version-update-record命令显示信息描述表
字段
No.
Update time
version
显示信息的序列号
更新操作发生的时间
更新的版本
描述
1.1.26 header
【命令】
header { incoming | legal | login | motd | shell } text
undo header { incoming | legal | login | motd | shell }
【视图】
系统视图
【缺省级别】
2：系统级
【参数】
incoming：设置Modem登录用户登录进入用户视图时的欢迎信息。如果要求认证，则欢迎信息在
通过认证后输出。
1-27
legal：设置登录终端界面前的授权信息，在输入认证用户名和密码前输出。
login：设置登录验证时的欢迎信息。
motd：设置登录终端界面前的欢迎信息。
shell：设置非Modem登录用户登录进入用户视图时的欢迎信息。
text：输入欢迎信息的内容。内容的输入支持单行和多行两种方式，具体输入规则请参见“基础配
置指导”中的“设备管理”。
【描述】
header命令用来设置欢迎信息。undo header命令用来关闭欢迎信息。
【举例】
# 配置进入用户视图的欢迎信息。
[Sysname] header incoming %
Please input banner content, and quit with the character '%'.
Welcome to incoming(header incoming)%
[Sysname] header incoming %
Please input banner content, and quit with the character '%'.
Welcome to incoming(header incoming)%
[Sysname] header legal %
Please input banner content, and quit with the character '%'.
Welcome to legal (header legal)%
[Sysname] header login %
Please input banner content, and quit with the character '%'.
Welcome to login(header login)%
[Sysname] header motd %
Please input banner content, and quit with the character '%'.
Welcome to motd(header motd)%
[Sysname] header shell %
Please input banner content, and quit with the character '%'.
Welcome to shell(header shell)%
// 本例中，“%”为text的起始/结束字符，在显示文本后输入“%”表示文本结束，退出header命
令。作为起始与结束字符，“%”不会成为所设置欢迎信息的一部分。
•
用户界面下没有配置登录认证，采用Telnet方式登录设备，测试以上设置时，显示信息如下。
******************************************************************************
* Copyright (c) 2004-2013 Hangzhou H3C Tech. Co., Ltd. All rights reserved. *
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
******************************************************************************
Welcome to legal (header legal)
Press Y or ENTER to continue, N to exit.
Welcome to motd(header motd)
Welcome to shell(header shell)
1-28
•
用户界面下配置password认证方式，采用Telnet方式登录设备，测试以上设置时，显示信息
如下。
******************************************************************************
* Copyright (c) 2004-2013 Hangzhou H3C Tech. Co., Ltd. All rights reserved. *
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
******************************************************************************
Welcome to legal (header legal)
Press Y or ENTER to continue, N to exit.
Welcome to motd(header motd)
Welcome to login(header login)
Login authentication
Password:
Welcome to shell(header shell)
1.1.27 job
【命令】
job job-name
undo job job-name
【视图】
系统视图
【命令级别】
3：管理级
【参数】
job-name：任务名，为1～32个字符的字符串。
【描述】
job命令用来创建新的定时执行任务并进入job视图，如果定时执行任务已经创建，则直接进入job
视图。undo job命令用来删除定时执行任务。
缺省情况下，系统没有创建定时执行任务。
创建定时执行任务后，可以在定时执行任务视图下配置任务的具体内容，比如让系统在某个时间点
自动执行某视图下的某条命令。
多次执行该命令可以创建多个定时任务，各任务之间互不干扰。
相关配置可参考命令view和time。
1-29
【举例】
# 创建（或进入）系统定时任务saveconfiguration。
[Sysname] job saveconfiguration
[Sysname-job-saveconfiguration]
1.1.28 reboot
【命令】
reboot
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
无
【描述】
reboot命令用来重启设备。
•
重新启动会导致业务中断，请谨慎使用该命令。
•
如果主用启动文件损坏或者不存在，则不能通过reboot命令重启设备。此时，可以通过指定新
的主用启动文件再重启，或者断电后重新上电，系统将自动使用备用启动文件重启。
•
如果设备在准备重启时，用户正在进行文件操作，为了安全起见，系统将不会执行此次重启操作。
【举例】
# 重启设备。
……交互信息略……
1.1.29 reset unused porttag
【命令】
reset unused porttag
【视图】
用户视图
【缺省级别】
1：监控级
1-30
【参数】
无
【描述】
reset unused porttag命令用来清除设备当前系统中保存的但不使用的16bit索引。
执行该命令时需要得到用户的确认。若用户在30秒之内没有确认操作，或者用户输入字符“N”否
定了本次操作，则本命令退出执行。
【举例】
# 清除当前系统中保存的但不使用的16bit索引。
Current operation will delete all unused port tag(s). Continue? [Y/N]:y
1.1.30 reset version-update-record
【命令】
reset version-update-record
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
无
【描述】
reset version-update-record命令用来清除软件版本更新操作的记录。
相关配置可参考display version-update-record。
【举例】
# 清除设备软件版本更新操作的记录。
[Sysname] reset version-update-record
1.1.31 schedule job
【命令】
schedule job { at time1 [ date ] | delay time2 } view view-name command
undo schedule job
【视图】
用户视图
【缺省级别】
3：管理级
1-31
【参数】
at time1 [ date ]：指定执行命令的具体时间。
•
•
time1表示执行命令的时间，格式为hh:mm （小时:分钟）。hh取值范围为0～23，mm取值
范围为0～59。
date表示执行命令的日期，格式为MM/DD/YYYY（月/日/年）或者YYYY/MM/DD（年/月/日）。
YYYY的取值范围为2000～2035，MM的取值范围为1～12，DD的取值范围与具体月份相
关。
hh:mm（小时:分钟），hh的取值范围为0～720，mm的取值范围为0～59，hh:mm的取值不
能超过720:00。
mm（分钟），取值范围为0～43200，0表示不延时，立即执行
。
shell表示用户视图。
system表示系统视图。
delay time2：指定执行命令的延迟时间。time2表示执行命令的延迟时间，格式可以为：
•
•
•
•
view view-name：指定执行命令的视图。view-name表示命令视图的名称，当前的取值为：
command：需要定时执行的命令字符串。
【描述】
schedule job命令用来配置定时执行任务。undo schedule job命令用来取消定时执行任务。
需要注意的是：
•
•
•
•
•
若指定参数at time1 date，则设置的时间点必须为将来的时间。
若指定参数at time1，当time1在当前系统时间之前，则指定命令将在第二天的该时间点执行；
当time1在当前系统时间之后，则指定命令将在当天的该时间点执行。
无论使用参数at还是delay，设置的定时时间与当前系统时间的间隔都不能大于720小时（即
30天）。
command表示的命令行必须是设备上可成功执行的命令行，并且要求命令行是view-name
视图下的命令，由用户保证配置的正确性，否则，命令行不能自动被执行。
指定命令执行时不进行信息交互。当需要用户交互确认时，系统将自动输入“Y”或“Yes”；
当需要用户交互输入字符信息时，系统将自动输入缺省字符串，没有缺省字符串的将自动输入
空字符串。
对于切换用户操作界面的命令（如telnet、ftp、ssh2等）、切换视图的命令（如system-view、
quit等）以及修改执行命令用户状态的命令（如super命令等），自动执行命令后当前用户的
操作界面、命令视图和用户状态不变。
使用本命令配置定时执行功能后，又执行clock datetime、clock summer-time或clock
timezone命令调整了系统时间，则定时执行功能的配置将自动取消。
多次执行schedule job命令时，只有最新的配置生效。
•
•
•
【举例】
# 当前时间为11:43，设置在60分钟之后在系统视图下执行批处理文件。
Info: Command execute in system view will be executed at 12:43 10/31/2013 (in 1 hours
and 0 minutes).
# 当前时间为11:43，设置在当天中午12:00在系统视图下执行批处理文件。
1-32
Info: Command execute in system view will be executed at 12:00 10/31/2013 (in 0 hours
and 16 minutes).
1.1.32 schedule reboot at
【命令】
schedule reboot at hh:mm [ date ]
undo schedule reboot
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
hh:mm：设备重启的时间，格式为“小时:分钟”。hh取值范围为0～23，mm取值范围为0～59。
date：设备重启的日期，格式为mm/dd/yyyy（月/日/年）或者yyyy/mm/dd（年/月/日）。yyyy的取
值范围为2000～2035，mm的取值范围为1～12，dd的取值范围与具体月份相关。
【描述】
schedule reboot at命令用来开启设备定时重启功能，并指定重启的具体时间和日期。undo
schedule reboot命令用来关闭定时重启功能。
缺省情况下，设备定时重启功能处于关闭状态。
如果没有指定重启的具体日期，则分为两种情况：
•
•
•
•
•
•
•
•
设置的时间点在当前时间之后，则设备将在当天的该时间点重启；
设置的时间点在当前时间之前，则设备将在第二天的该时间点重启。
设备定时器的精度为1分钟。在到达用户设定的重启时刻的前一分钟，设备会提示：REBOOT
IN ONE MINUTE（设备将在一分钟后重启），并在一分钟后重新启动。
设置的日期与当前日期相比，不能大于30×24小时（即30天）。
配置该命令后，系统会提示输入确认信息，只有键入
前进行过相应设置，则原有配置将被覆盖。
如果schedule reboot at命令设置了重启的具体日期（月/日/年或年/月/日），而且参数表示的
是将来的日期，则设备将在设定的时间点重新启动。
使用本命令配置定时重启功能后，又执行clock datetime、clock summer-time或clock
timezone命令调整了系统时间，则定时重启功能的配置将自动取消。
如果设备在准备重启时，用户正在进行文件操作，为了安全起见，系统将不会执行此次重启操
作。
需要注意的是：
相关配置可参考命令schedule reboot delay。
1-33
该命令会使设备在将来指定的时间点重新启动，从而导致业务中断，请谨慎使用。
【举例】
# 假设系统的当前时间为2013年6月6日11:43分，设置设备在当天中午12:00重启。
Reboot system at 12:00 06/06/2013 (in 0 hour(s) and 16 minute(s)) confirm? [Y/N]:
如果在设置重启时间之前使用terminal logging命令打开终端日志显示功能的话，输入“y”之后，
系统会自动显示相关日志信息。（缺省情况下，终端对日志信息的显示功能处于开启状态）。
%Jun 6 11:43:11:629 2013 Sysname CMD/4/REBOOT:
vty0(192.168.1.54): Set schedule reboot parameters at 11:43:11 06/06/2013, and system will
reboot at 12:00 06/06/2013.
1.1.33 schedule reboot delay
【命令】
schedule reboot delay { hh:mm | mm }
undo schedule reboot
【视图】
用户视图
【缺省级别】
3：管理级
【参数】
hh:mm：设备重启的等待时延，格式为“小时:分钟”。hh的取值范围为0～720，mm的取值范围
为0～59，hh:mm的取值不能超过720:00。
mm：设备重新启动的等待时延，单位为分钟，取值范围为0～43200。
【描述】
schedule reboot delay命令用来开启设备的定时重启功能，并设定等待时延。undo schedule
reboot命令用来关闭定时重启功能。
缺省情况下，设备定时重启功能处于关闭状态。
需要注意的是：
•
•
•
可以用两种格式来设置设备定时重启的等待时延，即“小时:分钟”和“绝对分钟数”。但绝对
分钟数不能大于30×24×60分钟（即30天）。
设备定时器的精度为1分钟。在到达用户设定的重启时刻的前一分钟，设备会提示：REBOOT
IN ONE MINUTE（设备将在一分钟后重启），并在一分钟后重新启动。
配置该命令后，系统会提示输入确认信息，只有键入
前进行过相应设置，则原有配置将被覆盖。
1-34
•
•
使用本命令配置定时重启功能后，又执行clock datetime、clock summer-time或clock
timezone命令调整了系统时间，则定时重启功能的配置将自动取消。
如果设备在准备重启时，用户正在进行文件操作，为了安全起见，系统将不会执行此次重启操
作。
相关配置可参考命令schedule reboot at。
该命令会使设备在指定时延后重新启动，从而导致业务中断，请谨慎使用。
【举例】
# 假设系统的当前时间为2013年6月6日11:48分，配置设备在88分钟后重启。
Reboot system at 13:16 06/06/2013(in 1 hour(s) and 28 minute(s)). confirm? [Y/N]:
# 如果在设置重启时间之前使用terminal logging命令打开终端日志显示功能的话，输入“y”之
后，系统会自动显示相关日志信息。（缺省情况下，终端对日志信息的显示功能处于开启状态）。
%Jun 6 11:48:44:860 2013 Sysname CMD/4/REBOOT:
vty0(192.168.1.54): Set schedule reboot parameters at 11:48:44 06/06/2013, and system will
reboot at 13:16 06/06/2013.
1.1.34 shutdown-interval
【命令】
shutdown-interval time
undo shutdown-interval
【视图】
系统视图
【缺省级别】
2：系统级
【参数】
time：配置端口状态检测定时器的时长，取值范围为0～300，单位为秒。
【描述】
shutdown-interval命令用来配置端口状态检测定时器的时长。undo shutdown-interval命令用来
恢复缺省情况。
缺省情况下，配置端口状态检测定时器的时长为30秒。
某些协议模块在特定情况下会自动关闭某个端口，比如当使能了BPDU保护功能的端口收到配置消
息时，MSTP协议模块将自动关闭该端口。此时，可以配置一个端口状态检测定时器。当定时器超
时，并且该端口仍处于关闭状态，协议模块则自动取消关闭动作，使端口恢复到真实的物理状态。
需要注意的是：
1-35
•
如果用户在端口定时检测过程中将检测时间间隔修改为T1，修改时刻距协议关闭端口时间间
隔为T。若T
口会立即恢复。例如当前time设置为30，当端口被协议模块关闭2秒（T=2）后，修改time
为10（T1=10），则该接口会再经过8秒后被恢复；如果当前time为30，端口被协议模块关
闭10秒后，修改time为2，则该端口会立即恢复。
当time设置为0时，相当于定时监测时间间隔为无穷大，协议不会自动激活端口。用户需要
手工执行undo shutdown命令来立即激活，或者重新修改time值来激活（遵循上一条注意
事项的规则）。
•
【举例】
# 配置端口状态检测定时器的时长为100秒。
[Sysname] shutdown-interval 100
1.1.35 sysname
【命令】
sysname sysname
undo sysname
【视图】
系统视图
【缺省级别】
2：系统级
【参数】
sysname：设备名称，为1～30个字符的字符串。
【描述】
sysname命令用来设置设备的名称。undo sysname用来恢复设备名称为默认名称。
缺省情况下，设备名称为H3C。
设备的名称对应于命令行接口的提示符，如设备的名称为Sysname，则用户视图的提示符为
【举例】
# 设置设备的名称为S2000。
[Sysname] sysname S2000
[S2000]
1.1.36 system-failure
【命令】
system-failure { maintain | reboot }
undo system-failure
1-36
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
maintain：表示系统故障时，保持当前状态，系统不会自动采取任何相关措施。
reboot：表示系统异常时，会采用直接重启的方式来进行恢复。
【描述】
system-failure命令仅用来配置设备系统异常时的处理方式。
缺省情况下，系统异常时的处理方式为reboot。
【举例】
# 将系统异常时的处理方式设置为reboot。
[Sysname] system-failure reboot
1.1.37 time at
【命令】
time time-id at time date command command
time time-id { one-off | repeating } at time [ month-date month-day | week-day week-daylist ]
command command
undo time time-id
【视图】
定时执行任务视图
【命令级别】
3：管理级
【参数】
time time-id：时间记录，取值范围为1～10的整数。
at time：执行指定命令的时间，格式为hh:mm (小时:分钟)。hh取值范围为0～23，mm取值范围
为0～59。
one-off：表示指定命令仅执行一次。命令在该设定时间点到达时执行，执行后下次再到达该时间点
时命令不再执行。
repeating：表示循环执行指定命令。
date：执行指定命令的日期，格式为MM/DD/YYYY（月/日/年）或者YYYY/MM/DD（年/月/日）。
•
•
•
YYYY的取值范围为2000～2035；
MM的取值范围为1～12；
DD的取值范围与具体月份有关。
month-date month-day：执行指定命令在一个月中的哪天被执行。month-day表示日期，取值范围
为1～31。
1-37
week-day week-daylist：执行指定命令在一周中的哪（些）天被执行。week-daylist表示一周中任
一天或几天的组合，取值为：Mon、Tue、Wed、Thu、Fri、Sat、Sun（星期一到星期日）。设置
多天时，字符串之间用空格分开，最多可以设置七天。
command command：需要定时执行的命令字符串。命令行必须是设备上可成功执行的命令行，并
且要求命令行是view命令配置的视图下的命令，由用户保证配置的正确性，否则，命令行不能自
动被执行。
【描述】
time at命令用来配置在指定时间执行指定命令。undo time命令用来取消在指定时间执行的命令。
•
•
•
•
•
•
•
time time-id at time date command command命令用来设置在某年某月某时某刻执行命令。
配置的时间点必须晚于系统当前时间点，否则，配置失败。
time time-id one-off at time command command命令用来设置在指定时刻执行命令。若当
天该时间点已过去，则顺延到第二天。执行后下次再到达该时间点时命令不再执行。
time time-id one-off at time month-date month-day command command命令用来设置在
某天某时执行命令。若本月该时间点已过去，则顺延到下月。命令执行后不再执行。
time time-id one-off at time week-day week-daylist command command命令用来设置在某
（些）天某时执行命令。若本周该时间点已过去，则顺延到下周。命令执行后不再执行。
time time-id repeating at time command command命令用来设置在每天的指定时刻执行命
令。执行后下次再到达该时间点时命令仍执行。
time time-id repeating at time month-date month-day command command命令用来设置
在每月的某天某时执行命令。执行后下次再到达该时间时命令仍执行。
time time-id repeating at time week-day week-daylist command command命令用来设置在
每周的某（些）天某时执行命令。执行后下次再到达该时间点时命令仍执行。
相关命令可参考job和view。
•
一个定时执行任务中指定的命令必须在同一视图下执行。
•
一个定时执行任务中最多可以配置10条命令（对应10个time-id）。如果多于10条，请把这个
任务拆分为多个任务。
•
time-id在同一个任务中必须唯一。如果新执行的time at命令指定的time-id和已有配置的
time-id值相同，则新配置会覆盖旧配置。
•
修改系统时间，不会影响该命令的配置和执行。
【举例】
# 2013年5月18日3:00将设备当前配置保存到文件。
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 at 3:00 2013/5/18 command save
# 每天的12:00执行保存配置命令。
[Sysname] job saveconfig
1-38
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 repeating at 12:00 command save
# 从现在开始第一个月5号的上午8点执行一次保存配置命令。
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 one-off at 8:00 month-date 5 command save
# 从现在开始每个月5号的上午8点执行保存配置命令。
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 repeating at 8:00 month-date 5 command save
# 从现在开始第一个周五和周六的上午8点分别执行一次保存配置命令。
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 one-off at 8:00 week-day fri sat command save
# 从现在开始每个周五和周六的上午8点都执行保存配置命令。
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 repeating at 8:00 week-day fri sat command save
1.1.38 time delay
【命令】
time time-id { one-off | repeating } delay time command command
undo time time-id
【视图】
定时执行任务视图
【命令级别】
3：管理级
【参数】
time time-id：时间记录，取值范围为1～10的整数。
one-off：表示指定命令仅执行一次。命令在该时间点到达时执行，执行后下次再到达该时间点时命
令不再执行。
repeating：表示循环执行指定命令。
delay time：执行指定命令的等待时延。格式为hh:mm (小时:分钟)或mm（分钟）。
•
•
使用hh:mm格式时，hh的取值范围为0～720，mm的取值范围为0～59，hh:mm的取值不
能超过720:00；
使用mm格式时，mm的取值范围为1～43200，即定时器的最大定时时长为30天。
command command：需要定时执行的命令字符串，该字符串中指定的命令必须为完整的、不需要
进行交互的命令。
1-39
【描述】
time delay命令用来配置延迟指定时间执行指定命令。undo time命令用来取消延迟指定时间执行
的命令。
•
•
time time-id one-off delay time command command命令用来设置在指定时间间隔后执行
命令。命令执行后不再执行。
time time-id repeating delay time command command命令用来设置以指定时间间隔为周
期重复执行命令。命令以时间间隔为周期循环执行。
相关命令可参考job和view。
•
一个定时执行任务中指定的命令必须在同一视图下执行；
•
一个定时执行任务中最多可以配置10条命令（对应10个time-id）。如果多于10条，请把这个
任务拆分为多个任务。
•
time-id在同一个任务中必须唯一。如果新执行的time at命令指定的time-id和已有配置的
time-id值相同，则新配置会覆盖旧配置。
•
修改系统时间，不会影响该命令的配置和执行。
【举例】
# 5分钟后将当前配置保存到文件。
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 one-off delay 5 command save
# 每隔5分钟后将当前配置保存到文件。
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 repeating delay 5 command save
1.1.39 view
【命令】
view view-name
undo view
【视图】
job视图
【命令级别】
3：管理级
【参数】
view-name：视图名，为1～90个字符的字符串。定时任务中配置的命令在哪个视图下执行通过该
参数指定。
1-40
【描述】
view命令用来指定定时执行命令所在的视图。undo view命令用来删除定时执行任务中的视图设
置。
缺省情况下，没有指定命令所在的视图。
需要注意的是：
•
•
每个定时执行任务只能包含一个视图，该定时任务中所有命令都将在此视图下被执行。若多次
执行该命令指定了不同的视图，则最新的配置生效。
视图必须是设备当前支持的视图，而且是视图的完整形式，不能使用缩写。常用的有：用户视
图对应的view-name为monitor，系统视图对应的view-name为system，以太网接口视图对
应的view-name为GigabitEthernetx/x/x，VLAN接口视图对应的view-name为
Vlan-interfacex/x/x等。
相关配置可参考命令job和time。
【举例】
# 指定系统自动执行的命令所在视图为系统视图。
[Sysname] job creatvlan
[Sysname-job-creatvlan] view system
1-41