Объект WeeklyTrigger

Статья
06/03/2023

Объект скрипта, представляющий триггер, запускающий задачу на основе еженедельного расписания. Например, задача начинается в 8:00 в определенный день недели каждую неделю или каждую в другую неделю.

Элементы

Объект WeeklyTrigger имеет следующие типы элементов:

Свойства

Элемент Property

Объект WeeklyTrigger имеет следующие свойства.

Свойство	Тип доступа	Описание
DaysOfWeek	Чтение/запись	Возвращает или задает дни недели, в которые выполняется задача.
Активировано	Чтение/запись	Наследуется от объекта Trigger . Возвращает или задает логическое значение, указывающее, включен ли триггер.
Конечная граница	Чтение/запись	Наследуется от объекта Trigger . Возвращает или задает дату и время отключения триггера. Триггер не может запустить задачу после ее отключения.
ExecutionTimeLimit	Чтение/запись	Наследуется от объекта Trigger . Возвращает или задает максимальное время, в течение которого разрешено выполнять задачу, запущенную триггером.
Id	Чтение/запись	Наследуется от объекта Trigger . Возвращает или задает идентификатор триггера.
RandomDelay	Чтение/запись	Возвращает или задает время задержки, которое случайным образом добавляется к времени начала триггера.
Повторение	Чтение/запись	Наследуется от объекта Trigger . Возвращает или задает частоту выполнения задачи и продолжительность повторения шаблона повторения после запуска задачи.
Начальная граница	Чтение/запись	Наследуется от объекта Trigger . Возвращает или задает дату и время активации триггера.
Тип	Только для чтения	Наследуется от объекта Trigger . Возвращает тип триггера.
WeeksInterval	Чтение/запись	Возвращает или задает интервал между неделями в расписании.

В день, когда летнее время (DST) начинается в году, для тихоокеанского часового пояса (время, смещенное с 02:00 до 03:00 в 2022 году), любая задача, запланированная для выполнения с 02:00 до 02:59:59:999, будет выполняться в самое раннее возможное время, которое существует в данный день, то есть в 03:00. Это относится ко всем часовых поясам DST в зависимости от времени, в которое они наблюдают DST.

Рассмотрим еженедельную задачу, которая будет выполняться каждое воскресенье 2022 года в 2:30 в тихоокеанском часовом поясе, чтобы следующее время выполнения было 13 марта 2022 г. 2:30. Так как 2:30 — это время, которое не существует 13 марта 2022 г., задача выполняется в 3:00. В другие воскресенье года задача выполняется в обычном режиме в 2:30.

Примеры

Дополнительные сведения и пример кода для этого объекта скрипта см. в разделе Пример еженедельного триггера (скрипты).

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Библиотека типов	Taskschd.tlb
DLL	Taskschd.dll

См. также раздел

Триггер
TriggerCollection
TriggerCollection.Create