基础配置命令参考

07-设备管理命令

l 不同型号产品的特性功能支持情况略有不同，详细请参见“特性差异化列表” 部分的介绍。

l 设备支持的接口类型和编号与设备的实际情况相关，本手册涉及以太网接口的配置举例统一使用Eth口举例说明。实际使用中请根据具体设备的接口类型和编号进行配置。

1 设备管理命令

本手册中举例使用的应用程序文件名称是test.bin，实际使用中，请以具体设备的实际情况为准。

1.1 设备管理命令

1.1.1 boot-loader

【命令】

boot-loader file file-url

【视图】

用户视图

【缺省级别】

2：系统级

【参数】

file file-url：文件名，如果用户输入的是相对路径，则执行命令时系统会自动将相对路径转换为绝对路径，同时要求绝对路径最多不能超过63个字符，否则，命令执行失败、格式为[drive:/]file-name，其中：

l [ ]表示该参数可选。

l drive用来指定文件在设备的哪个存储介质上，取值为存储介质的名称。如果设备上只有一个存储介质，可以不用输入该参数。

l file-name表示文件的名称，文件名的后缀为“.bin”。

【描述】

boot-loader命令用来指定设备的启动文件。

必须先将下次启动文件保存到设备存储介质的根目录下，boot-loader命令才能执行成功。

相关配置可参考命令display boot-loader。

【举例】

# 指定设备下次启动时所用的启动文件为test.bin。

<Sysname> boot-loader file test.bin

This command will set boot file, Continue? [Y/N]:y

The specified file will be used as the boot at the next reboot on slot 1!

1.1.2 bootrom

【命令】

bootrom { backup | read | restore | update file file-url } [ all | part ]

【视图】

用户视图

【缺省级别】

2：系统级

【参数】

read：读取Bootrom，即将Bootrom程序从Bootrom存储器的Normal区读取到Flash中以作备份。当Bootrom存储器损坏，可以重新运行Flash上的Bootrom文件来恢复Bootrom。

restore：恢复Bootrom，即将Bootrom代码从Bootrom存储器的Backup区恢复到Normal区。如果当前的Bootrom被损坏，并且在损坏前备份了Bootrom，可以用restore操作来恢复Bootrom。

backup：备份Bootrom，即。将Bootrom代码从Bootrom存储器的Normal区备份到Backup区，以便Normal区损坏时，可以从Backup区恢复Bootrom程序。建议在升级Bootrom前备份Bootrom。

update file file-url：升级Bootrom，file-url表示用于升级的文件名，file-url参数的详细介绍请参见命令boot-loader。

all：操作Bootrom的全部内容。

part：只操作Bootrom的扩展内容（Bootrom分两部分：常规部分和扩展部分，常规部分提供Bootrom的基本操作项，扩展部分提供更多的Bootrom操作项）。

【描述】

bootrom命令用来读取、恢复、备份或升级系统的Bootrom程序。

必须先将Bootrom程序保存到设备存储介质的根目录下，bootrom命令用来才能执行成功。

不指定all和part参数时，操作Bootrom的全部内容。

【举例】

# 使用boot.btm文件升级设备的Bootrom。

<H3C> bootrom update file boot.btm

This command will update bootrom file, Continue? [Y/N]:y

Now updating bootrom, please wait...

Updating basic bootrom!

Update basic bootrom success!

Updating extended bootrom!

Update extended bootrom success!

Update bootrom success!

<H3C>

1.1.3 display boot-loader

【命令】

display boot-loader

【视图】

任意视图

【缺省级别】

2：系统级

【参数】

无

【描述】

display boot-loader命令用来显示启动文件信息。

相关配置可参考命令boot-loader。

【举例】

# 显示设备本次启动和下次启动所采用的启动文件。

<Sysname> display boot-loader

The boot file used this time:flash:/test.bin attribute:Main

The boot file used next time:flash:/test.bin attribute:Main

Failed to get the backup boot file used next time!

Failed to get the secure boot file used next time!

表1-1 display boot-loader命令显示信息描述表

字段	说明
The boot file used this time	系统本次启动时使用的启动文件
attribute	启动文件的属性：main（主用）/backup（备用）
The boot file used next time	设备下次启动时使用的启动文件

1.1.4 display cpu-usage

【命令】

display cpu-usage [ entry-number [ offset ] [ verbose ] [ from-device ] ]

【视图】

任意视图

【缺省级别】

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利用率。

from-device：查看外部存储设备（比如flash、硬盘等）中保存的统计信息（该参数设备暂不支持）。

【描述】

display cpu-usage命令用来显示CPU利用率的统计信息。

系统每隔一定的时间（通常为60秒）对CPU的利用率进行统计，并把统计结果保存到历史记录区。display cpu-usage entry-number表示从最新记录（倒数第一条记录）开始，显示entry-number条记录。display cpu-usage entry-number offset表示从倒数第（offset+1）条记录开始，显示entry-number条记录。

【举例】

# 显示当前CPU利用率统计信息。

<Sysname> display cpu-usage

Uint CPU usage:

14% in last 5 seconds

12% in last 1 minute

8% in last 5 minutes

# 显示CPU利用率统计信息历史记录区中的倒数第5和倒数第6号记录。

<Sysname> display cpu-usage 2 4

===== CPU usage info (no: 0 idx: 58) =====

CPU Usage Stat. Cycle: 60 (Second)

CPU Usage : 3%

CPU Usage Stat. Time : 2006-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 : 2006-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命令显示信息描述表

字段	说明
Unit CPU usage	CPU利用率信息
14% in last 5 seconds	设备启动后，会以5秒为周期计算并记录一次该5秒内的CPU的平均利用率。该字段显示的是最近一个5秒统计周期内CPU的平均利用率
12% in last 1 minute	设备启动后，会以1分钟为周期计算并记录一次该1分钟内的CPU的平均利用率。该字段显示的是最近一个1分钟统计周期内CPU的平均利用率
8% in last 5 minutes	设备启动后，会以5分钟为周期计算并记录一次该5分钟内的CPU的平均利用率。该字段显示的是最近一个5分钟统计周期内CPU的平均利用率
CPU usage info (no: idx:)	CPU利用率纪录的信息（no：第no+1条记录，no从0开始编号，记录越新编号越小；idx：本次记录在历史记录表中的索引）（如果只显示系统当前CPU的利用率信息，则no和idx的显示省略）
CPU Usage Stat. Cycle	CPU利用率统计的时间区间（单位为秒），比如Cycle值为41，则表示统计的是最近41秒时间内CPU利用率的平均值。该参数的取之范围为1～60
CPU Usage	CPU利用率统计的时间区间内，CPU利用率的平均值（单位为%）
CPU Usage Stat. Time	CPU利用率统计结束时间（单位为秒），即执行显示命令时的系统时间
CPU Usage Stat. Tick	系统运行时间（单位tick，用64位的十六进制数表示，其中CPU Tick High表示高32位，CPU Tick Low表示低32位）
Actual Stat. Cycle	CPU利用率统计的实际时间区间（单位tick，用64位的十六进制数表示，其中CPU Tick High表示高32位，CPU Tick Low表示低32位）（因为它的精度高于秒，所以不同记录的实际周期会有细微差别）
TaskName	任务名称
CPU	CPU利用率统计的时间区间内，当前任务CPU使用率的平均值

1.1.5 display cpu-usage history

【命令】

display cpu-usage history [ task task-id ]

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

task task-id：显示指定任务的CPU利用率的统计历史信息，task-id表示任务编号，取值范围为1～180。不使用该参数时，显示的是整个系统的相应信息（整个系统的CPU利用率等于所有任务CPU利用率之和）。

【描述】

display cpu-usage history命令用来以图形方式显示CPU利用率统计历史信息。

不指定参数时，将显示整个系统的CPU利用率统计信息。

系统每隔一定时间会对CPU的利用率进行统计，并把统计结果保存到历史记录区。通过display cpu-usage history命令可以查看到最近60分钟记录的CPU利用率统计值。结果以坐标的形式进行显示，显示信息中：

l 纵坐标表示利用率，采用就近显示的原则。比如，利用率的步长为5％，则实际统计值53％将被显示成55％，实际统计值52％将被显示成50％。

l 横坐标表示时间。

l 用连续的＃号表示该时刻的利用率，某个时间点上最高处的#号对应的纵坐标值即为该时刻CPU的利用率。

【举例】

# 显示整个系统的CPU利用率统计信息。

<Sysname> display cpu-usage history

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利用率统计信息。

<Sysname> display cpu-usage history task 6

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(T03M)

以上显示信息表明编号为6的任务（任务名为T03M）在最近60分钟内CPU的占有率情况：第20分钟大约为5％，其它时间均小于或等于2％。

1.1.6 display device

【命令】

display device [ verbose ]

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

verbose：显示详细信息。

【描述】

display device命令用来显示设备的详细信息。

【举例】

# 显示设备的概要信息（本命令的显示信息中的Board Type与设备型号有关，请以设备的实际情况为准）。

<Sysname> display device

Slot No. Board Type Status Max Ports

1 WA2200 Board Normal 5

# 显示设备的详细信息。

<Sysname> display device verbose

Slot No. Board Type Status Max Ports

1 WA2200 Board Normal 5

Slot 1

Status: Normal

Type: WA2200 Board

Hardware: Ver.A

Driver: 1.0

表1-3 display device命令显示信息描述表

字段	说明
Slot No.	设备的槽位号
Board Type	设备的硬件类型
Status	设备状态
Max Ports	设备支持的最大物理端口数
Type	当前设备的板卡类型
Hardware	当前设备的硬件版本
Driver	当前设备的驱动版本

1.1.7 display device manuinfo

【命令】

display device manuinfo

【视图】

任意视图

【缺省级别】

3：管理级

【参数】

无

【描述】

display device manuinfo命令用来显示设备的电子标签信息。

电子标签信息也可以称为永久配置数据或档案信息等，在单板或者设备的调测（调试、测试）过程中被写入到设备的存储器件中，包括单板的名称、生产序列号、MAC地址、制造商等信息。本命令显示的是设备的部分电子标签信息。

【举例】

# 显示设备的电子标签信息。

<Sysname> display device manuinfo

DEVICE_NAME: WA2220X-AGP

DEVICE_SERIAL_NUMBER: 1234567890

MAC_ADDRESS: 000f-e2c0-0100

MANUFACTURING_DATE: 2007-09-20

VENDOR_NAME: H3C

表1-4 display device manuinfo命令信息显示描述表

字段	说明
DEVICE_NAME	设备名称
DEVICE_SERIAL_NUMBER	设备序列号
MAC_ADDRESS	设备出厂MAC地址
MANUFACTURING_DATE	设备调测日期
VENDOR_NAME	制造商名称

1.1.8 display environment

【命令】

display environment

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

无

【描述】

display environment命令用来显示设备的温度信息，包括单板当前温度和设定的温度门限。

【举例】

# 显示设备的温度信息。

<Sysname> display environment

System Temperature information (degree centigrade):

----------------------------------------------------

SlotNo Temperature Lower limit Upper limit

0 41 5 60

表1-5 display environment命令显示信息描述表

字段	描述
System Temperature information (degree centigrade)	系统各单板温度信息（摄氏度）
SlotNO	单板所在的槽位号
Temperature	当前温度
Lower limit	温度下限
Upper limit	温度上限

1.1.9 display job

【命令】

display job [ job-name ]

【视图】

任意视图

【命令级别】

1：监控级

【参数】

job-name：任务名，为1～32个字符的字符串。

【描述】

display job命令用来查看定时执行任务的相关信息。

不带参数时表示查看当前所有定时执行任务的相关信息。

相关配置可参考命令job、time和view。

【举例】

# 查看定时执行任务saveconfig的相关信息。

<Sysname> display job saveconfig

Job name: saveconfig

Specified view: monitor

Time 1: Execute command save 1.cfg after 40 minutes

以上显示信息表明，40分钟后系统将自动将当前运行的配置保存到配置文件1.cfg。

表1-6 display job命令显示信息描述表

字段	说明
Job name	定时执行任务名
Specified view	定时执行任务中命令所在视图
Time timeID	定时执行任务中包含的各命令执行时间记录
Execute command	命令字符串

1.1.10 display memory

【命令】

display memory

【视图】

任意视图

【缺省级别】

1：监控级

【参数】

无

【描述】

display memory命令用来显示设备内存的使用状况。

【举例】

# 显示设备内存的使用状况。

<Sysname> display memory

display memory

System Total Memory(bytes): 35506944

Total Used Memory(bytes): 19185480

Used Rate: 54%

表1-7 display memory命令显示信息描述表

字段	说明
System Total Memory(bytes)	系统的总内存大小，单位为字节
Total Used Memory(bytes)	已经使用的内存大小，单位为字节
Used Rate	已经使用的内存占总内存的比例

1.1.11 display reboot-type

【命令】

display reboot-type

【视图】

任意视图

【缺省级别】

2：系统级

【参数】

无

【描述】

display reboot-type命令用来显示系统的启动方式。

【举例】

# 显示设备的启动方式。

<Sysname> display reboot-type

The rebooting type this time is: Cold

以上显示信息表明：设备最近一次的重启方式为冷启动（Cold，表示本次是通过上电方式启动的设备）。（当显示Warm时表示启动方式为热启动，表示本次是通过reboot等命令启动的设备。）

1.1.12 display schedule reboot

【命令】

display schedule reboot

【视图】

任意视图

【缺省级别】

3：管理级

【参数】

无

【描述】

display schedule reboot命令用来显示用户设置的设备重启时间。

相关配置可参考命令schedule reboot at和schedule reboot delay。

【举例】

# 显示设备的重启时间。

<Sysname> display schedule reboot

System will reboot at 16:00:00 03/10/2008 (in 2 hours and 5 minutes).

以上显示信息表明，系统将在2006年3月10日16点（2小时零5分钟之后）重启。

1.1.13 display system-failure

【命令】

display system-failure

【视图】

任意视图

【缺省级别】

3：管理级

【参数】

无

【描述】

display system-failure命令用来显示异常情况下系统的处理方式。

相关配置可参考命令system-failure。

【举例】

# 显示异常情况下系统的处理方式。

<Sysname> display system-failure

System failure handling method: reboot

1.1.14 job

【命令】

job job-name

undo job job-name

【视图】

系统视图

【命令级别】

3：管理级

【参数】

job-name：任务名，为1～32个字符的字符串。

【描述】

job命令用来创建新的定时执行任务并进入job视图，如果定时执行任务已经创建，则直接进入job视图。undo job命令用来删除定时执行任务。

缺省情况下，系统没有创建定时执行任务。

创建定时执行任务后，可以在定时执行任务视图下配置任务的具体内容，比如让系统在某个时间点自动执行某视图下的某条命令。

多次执行该命令可以创建多个定时任务，各任务之间互不干扰。

相关配置可参考命令view和time。

【举例】

# 创建（或进入）系统定时任务saveconfiguration。

<Sysname> system-view

[Sysname] job saveconfiguration

[Sysname-job-saveconfiguration]

1.1.15 reboot

【命令】

reboot

【视图】

用户视图

【缺省级别】

2：系统级

【参数】

无

【描述】

reboot命令用来重启设备。

l 重新启动会导致业务中断，请谨慎使用该命令。

l 如果主用启动文件损坏或者不存在，则不能通过reboot命令重启设备。此时，可以通过指定新的主用启动文件再重启，或者断电后重新上电，系统将自动使用备用启动文件重启。

l 如果设备在准备重启时，用户正在进行文件操作，为了安全起见，系统将不会执行此次重启操作。

【举例】

# 当配置没有变化时，重启设备。

<Sysname> reboot

Start to check configuration with next startup configuration file, please wait.........DONE!

This command will reboot the device. Continue? [Y/N]:y

Now rebooting, please wait....

# 当配置有变化时，重启设备。

<Sysname> reboot

Start to check configuration with next startup configuration file, please wait.........DONE!

This command will reboot the device. Current configuration will be lost in next startup if you continue. Continue? [Y/N]:y

Now rebooting, please wait....

1.1.16 reset unused porttag

【命令】

reset unused porttag

【视图】

用户视图

【缺省级别】

1：监控级

【参数】

无

【描述】

reset unused porttag命令用来清除当前系统中保存的但不使用的16bit索引。

执行该命令时需要得到用户的确认。若用户在30秒之内没有确认操作，或者用户输入字符“N”否定了本次操作，则本命令退出执行。

【举例】

# 清除当前系统中保存的但不使用的16bit索引。

<Sysname> reset unused porttag

Current operation will delete all unused port tag(s). Continue? [Y/N]:y

1.1.17 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命令用来关闭设备定时重启功能。

缺省情况下，设备定时重启功能处于关闭状态。

如果没有指定重启的具体日期，则分为两种情况：

l 设置的时间点在当前时间之后，则设备将在当天的该时间点重启；

l 设置的时间点在当前时间之前，则设备将在第二天的该时间点重启。

需要注意的是：

l 设备定时器的精度为1分钟。在到达用户设定的重启时刻的前一分钟，设备会提示：REBOOT IN ONE MINUTE（设备将在一分钟后重启），并在一分钟后重新启动。

l 设置的日期与当前日期相比，不能大于30×24小时（即30天）。

l 配置该命令后，系统会提示输入确认信息，只有键入<Y>或者<y>后，设置才能生效。如果之前进行过相应设置，则原有配置将被覆盖。

l 如果schedule reboot at命令设置了重启的具体日期（月/日/年或年/月/日），而且参数表示的是将来的日期，则设备将在设定的时间点重新启动。

l 如果进行schedule reboot at命令配置后，又用clock命令对系统时间进行了调整，则schedule reboot at命令配置的重启时间将失效。

l 如果设备在准备重启时，用户正在进行文件操作，为了安全起见，系统将不会执行此次重启操作。

该命令会使设备在将来的某个时间点重新启动，从而导致业务中断，请谨慎使用。

【举例】

# 当前时间为11:43，设置设备在当天中午12:00重启。

<Sysname> schedule reboot at 12:00

Reboot system at 12:00 06/06/2008(in 0 hour(s) and 16 minute(s)) confirm? [Y/N]:

# 如果在设置重启时间之前使用terminal logging命令打开终端日志显示功能的话，输入“y”之后，系统会自动显示相关日志信息。（缺省情况下，终端对日志信息的显示功能处于开启状态）。

%Jun 6 11:43:11:629 2006 Sysname CMD/4/REBOOT:

vty0(192.168.1.54): Set schedule reboot parameters at 11:43:11 2006/06/06, and system will reboot at 12:00 06/06/2008.

1.1.18 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命令用来关闭设备的定时重启功能。

缺省情况下，设备定时重启功能处于关闭状态。

需要注意的是：

l 可以用两种格式来设置设备定时重启的等待时延，即“小时:分钟”和“绝对分钟数”。但绝对分钟数不能大于30×24×60分钟（即30天）。

l 配置该命令后，系统会提示输入确认信息，只有键入<Y>或者<y>后，设置才能生效。如果之前进行过相应设置，则原有配置将被覆盖。

l 如果用户进行schedule reboot delay命令配置后，又用clock命令对系统时间进行了调整，则schedule reboot delay命令配置的重启时间将失效。

l 如果设备在准备重启时，用户正在进行文件操作，为了安全起见，系统将不会执行此次重启操作。

该命令会使设备在指定时延后重新启动，从而导致业务中断，请谨慎使用。

【举例】

# 当前时间是11:48，配置设备在88分钟后重启。

<Sysname> schedule reboot delay 88

Reboot system at 13:16 06/06/2008(in 1 hour(s) and 28 minute(s)) confirm? [Y/N]:

%Jun 6 11:48:44:860 2006 Sysname CMD/4/REBOOT:

vty0(192.168.1.54): Set schedule reboot parameters at 11:48:44 2006/06/06, and system will reboot at 13:16 06/06/2008.

1.1.19 system-failure

【命令】

system-failure { maintain | reboot }

undo system-failure { maintain | reboot }

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

maintain：表示系统故障时，保持当前状态，系统不会自动采取任何相关措施。

reboot：表示系统异常时，会采用直接重启的方式来进行恢复。

【描述】

system-failure命令用来配置系统异常时的处理方式。

缺省情况下，系统异常时的处理方式为reboot。

【举例】

# 将系统异常时的处理方式设置为maintain。

<Sysname> system-view

[Sysname] system-failure maintain

Change the system failure handling method from reboot to maintain. Continue? [Y/N]: y

1.1.20 temperature-limit

【命令】

temperature-limit slot-number lower-value upper-value

undo temperature-limit slot-number

【视图】

系统视图

【缺省级别】

2：系统级

【参数】

slot-number：槽位编号。

lower-value：温度下限值，单位为摄氏度，取值范围为0～70。

upper-value：温度上限值，单位为摄氏度，取值范围为20～90。upper-value的值必须大于lower-value的值。

【描述】

temperature-limit命令用来设置单板上的温度告警门限。undo temperature-limit命令用来恢复缺省情况。

缺省情况下，单板上的温度告警下限为5，上限为60。

【举例】

# 配置设备的温度告警下限为10摄氏度，告警上限为75摄氏度。

<Sysname> system-view

[Sysname] temperature-limit 0 10 75

Setting temperature limit succeeded.

1.1.21 time

【命令】

time timeID at time1 date command command

time timeID { one-off | repeating } at time1 [ month-date month-day | week-day week-daylist ] command command

time timeID { one-off | repeating } delay time2 command command

undo time timeID

【视图】

job视图

【命令级别】

3：管理级

【参数】

timeID：时间索引，取值范围为1～10的整数。

at time1：执行命令的时间点，格式为hh:mm（小时:分钟）。hh取值范围为0～23，mm取值范围为0～59。

date：执行命令的日期，格式为MM/DD/YYYY（月/日/年）或者YYYY/MM/DD（年/月/日）。YYYY的取值范围为2000～2035，MM的取值范围为1～12，DD的取值范围与具体月份相关。指定该参数时，配置时间点必须在系统当前时间之后。

command command：需要定时执行的命令行，文本格式。命令行必须是设备上可成功执行的命令行，并且要求命令行是view命令配置的视图下的命令，由用户保证配置的正确性，否则，命令行不能自动被执行。

one-off：表示执行命令一次。

repeating：表示循环执行命令。

month-date month-day：表示命令在一个月中的某天被执行。month-day表示日期，取值范围为1～31。

week-day week-daylist：表示命令在一周中的某（些）天被执行。week-daylist表示一周中任一天或几天的组合，包括Sun、Mon、Tue、Wed、Thu、Fri、Sat，依次表示周日到周一。如，命令在周一执行，输入week-day Mon；命令在周五和周六执行，输入week-day Fri Sat。设置多天时，代表各天的字符串彼此间用空格分开，最多可设置七天。

delay time2：执行命令的延迟时间，格式为hh:m（小时:分钟）或mm（分钟）。使用hh:mm格式时，hh的取值范围为0～719，mm的取值范围为0～59。使用mm格式时，mm的取值不能超过43200。该参数与系统绝对时间无关，即使系统时间变化命令也将在相应时延后执行。

【描述】

time命令用来绑定时间和命令，即配置在指定时间点执行指定命令。undo time命令用来取消绑定关系。

每个绑定关系用timeID参数来唯一标识，一个定时执行任务最多可以同时配置10条绑定关系。

l time timeID at time1 date command command命令用来设置在某年某月某时某刻执行命令。配置的时间点必须晚于系统当前时间点，否则，配置失败。

l time timeID one-off at time1 command command命令用来设置在当天的指定时刻执行命令。若当天该时间点已过去，则顺延到第二天。执行后下次再到达该时间点时命令不再执行。

l time timeID one-off at time1 month-date month-day command command命令用来设置在本月的某天某时执行命令。若本月该时间点已过去，则顺延到下月。命令执行后不再执行。

l time timeID one-off at time1 week-day week-daylist command command命令用来设置在本周的某（些）天某时执行命令。若本周该时间点已过去，则顺延到下周。命令执行后不再执行。

l time timeID repeating at time1 command command命令用来设置在每天的指定时刻执行命令。执行后下次再到达该时间点时命令仍执行。

l time timeID repeating at time1 month-date month-day command command命令用来设置在每月的某天某时执行命令。执行后下次再到达该时间时命令仍执行。

l time timeID repeating at time1 week-day week-daylist command command命令用来设置在每周的某（些）天某时执行命令。执行后下次再到达该时间点时命令仍执行。

l time timeID one-off delay time2 command command命令用来设置在指定时间间隔后执行命令。命令执行后不再执行。

l time timeID repeating delay time2 command command命令用来设置以指定时间间隔为周期重复执行命令。命令以时间间隔为周期循环执行。

l undo time timeID命令用来删除已存在的时间记录。

【举例】

# 2009年5月18日24:00将设备当前配置保存到文件a.cfg。

<Sysname> system-view

[Sysname] job saveconfig