Объект 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 [только классические приложения] |
| Библиотека типов |
|
| DLL |
|