/system/scheduler
scheduler
Scheduler entries run RouterOS commands or a /system/script entry at a set date and time, repeatedly at an interval, during startup, or on selected weekdays. See the Scheduler guide for examples and for how the next...
system/scheduler
Type: Directory
计划任务条目在设定的日期和时间运行 RouterOS 命令或 /system/script 条目,可按间隔重复、在启动期间运行,或在选定的星期几运行。有关示例以及下次运行时间的计算方式,参见 计划任务。reset 命令会清除 on-event 并将 interval 设置为 0s;它不会重置 run-count。
| 标志 | 名称 | 描述 |
|---|---|---|
X | disabled | 已禁用的条目;启用前不会运行。 |
| 参数 | 类型 | 描述 |
|---|---|---|
name * | string | Name of the entry. Log messages from its runs refer to it as scheduler:<name>. |
start-date | date | 首次运行的日期,格式为 YYYY-MM-DD(年份 1970..2106)。默认值:添加条目的日期。 |
start-time | alt { startup: enum (startup) { startup:0xffffffff } , time: date } | 首次运行的时间: - HH:MM:SS - 在 start-date 的该时间进行首次运行。 - startup - 在系统启动期间运行。使用 interval=0s 时,条目在每次启动时运行一次。使用非零 interval 时,首次运行发生在启动后一个间隔(或路由器运行期间添加条目后一个间隔),而不是在启动时本身。 启动运行发生在接口启用之前,也发生在 DHCP 客户端获得地址之前。默认值:添加条目的时间。 |
days | alt { day: enum (never | always) { never:0, always:127 } , day: ubit (sun, mon, tue, wed, thu, fri, sat) } | 条目运行的星期几: - 未设置(默认)- 不考虑星期几。运行按 start-time 加 interval 连续跨午夜进行。 - always - 每天,按天调度:每天从 start-time 重新开始。 - never - 条目永不运行。 - sun、mon、tue、wed、thu、fri、sat - 仅在列出的日期运行(逗号分隔)。每个匹配的日期从 start-time 开始,并按 interval 重复直到当天结束。使用 interval=0s 时,条目在每个匹配的日期运行一次。 设置 days 时不支持 1d 或更长的 interval;此时条目会显示注释 multi-day intervals are not supported with active day scheduling。 |
interval | time | 运行之间的时间。运行发生在 start-date 和 start-time 加上间隔的整数倍时刻,因此过去的开始时间会与计划对齐:start-time=00:00:00 interval=1h 会在每个整点运行。0s 使条目在 start-date 和 start-time 运行一次(设置 days 时,在每个匹配的日期运行一次)。默认值:0s。 |
on-event | alt { script: string } | 要运行的 RouterOS 命令,或 /system/script 条目的名称。按名称调用的脚本使用此条目的 policy 运行;如果脚本自身的策略具有此条目策略缺少的权限,则会以 not enough permissions 拒绝运行。默认值:empty。 |
policy | multi { array-id, policy: enum } | 命令运行所使用的策略。需要缺少的策略的命令会在日志中失败并显示 not enough permissions (9)。参见 脚本权限。默认值:添加条目的用户的策略,限制为 ftp、reboot、read、write、policy、test、password、sniff、sensitive 和 romon。 |
| 只读参数 | 类型 | 描述 |
|---|---|---|
owner | string | 添加条目的用户。 |
run-count | num | 自上次启动以来的运行次数。重启会将其重置为 0。 |
next-run | date | 下次运行的日期和时间。没有待运行项时为空:interval=0s 的条目在运行后、interval=0s 的 startup 条目,或 days=never 的条目。 |