Поделиться через


Объект WeeklyTrigger

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

Элементы

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

Элемент Property

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

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

Комментарии

Время запуска задачи задается свойством StartBoundary .

При чтении или записи собственного XML-кода для задачи еженедельный триггер указывается с помощью элемента ScheduleByWeek схемы планировщика задач.

В день, когда летнее время (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