WeeklyTrigger 对象

表示基于每周计划启动任务的触发器的脚本对象。 例如,任务从每周或每隔一周的特定日期的上午 8:00 开始。

成员

WeeklyTrigger 对象包含以下类型的成员:

属性

WeeklyTrigger 对象具有以下属性。

属性 访问类型 说明
DaysOfWeek
读取/写入
获取或设置运行任务的星期数。
Enabled
读取/写入
继承自 Trigger 对象。 获取或设置一个布尔值,该值指示是否启用触发器。
EndBoundary
读取/写入
继承自 Trigger 对象。 获取或设置停用触发器的日期和时间。 停用任务后,触发器无法启动该任务。
ExecutionTimeLimit
读取/写入
继承自 Trigger 对象。 获取或设置允许触发器启动的任务运行的最长时间。
Id
读取/写入
继承自 Trigger 对象。 获取或设置触发器的标识符。
RandomDelay
读取/写入
获取或设置随机添加到触发器开始时间的延迟时间。
重复
读取/写入
继承自 Trigger 对象。 获取或设置任务的运行频率,以及启动任务后重复重复模式的时长。
StartBoundary
读取/写入
继承自 Trigger 对象。 获取或设置激活触发器的日期和时间。
类型
只读
继承自 Trigger 对象。 获取触发器的类型。
WeeksInterval
读取/写入
获取或设置计划中周数之间的间隔。

备注

启动任务的时间由 StartBoundary 属性设置。

为任务读取或写入自己的 XML 时,使用任务计划程序架构的 ScheduleByWeek 元素指定每周触发器。

在夏令时 (DST) 在一年内开始的当天, 对于太平洋时区 (时间从 2022 年的 02:00 AM 转移到 03:00 AM) ,计划在 02:00 AM 到 02:59:59:999 AM 之间运行的任何任务都将在给定日期中存在的最早时间运行,即, 在 03:00 AM。 这适用于所有 DST 时区,具体取决于它们观察 DST 的不同时间。

假设每周任务设置为在太平洋时区的 2022 年每个星期日凌晨 2:30 运行,以便下一个运行时间为 2022 年 3 月 13 日凌晨 2:30。 由于 2:30 AM 是 2022 年 3 月 13 日不存在的时间,因此任务改为在凌晨 3:00 运行。 在一年中的其他星期日,任务照常在凌晨 2:30 运行。

示例

有关详细信息和此脚本对象的代码示例,请参阅 每周触发器示例 (脚本)

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2008 [仅限桌面应用]
类型库
Taskschd.tlb
DLL
Taskschd.dll

另请参阅

触发器

TriggerCollection

TriggerCollection.Create