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

Метод TaskFolder.RegisterTaskDefinition

  • Статья

Для создания скриптов регистрирует (создает) задачу в указанном расположении с помощью объекта TaskDefinition для определения задачи.

Синтаксис

TaskFolder.RegisterTaskDefinition( _
  ByVal path, _
  ByVal definition, _
  ByVal flags, _
  ByVal userId, _
  ByVal password, _
  ByVal logonType, _
  [ ByVal sddl ], _
  ByRef task _
)

Параметры

path [in]

Имя данной задачи. Если это значение равно Nothing, задача будет зарегистрирована в корневой папке задач, а имя задачи будет значением GUID, созданным службой планировщика задач.

Имя задачи не может начинаться или заканчиваться пробелом. Символ "." не может использоваться для указания текущей папки задач и .. Символы нельзя использовать для указания родительской папки задач в пути.

definition [in]

Определение зарегистрированной задачи.

flags [in]

Константой TASK_CREATION.

Значение Значение
TASK_VALIDATE_ONLY
0x1
 Планировщик задач проверяет синтаксис XML,который описывает задачу, но не регистрирует ее. Эту константу нельзя сочетать со значениями TASK_CREATE, TASK_UPDATE или TASK_CREATE_OR_UPDATE .
TASK_CREATE
0x2
 Планировщик задач регистрирует задачу как новую.
TASK_UPDATE
0x4
 Планировщик задач регистрирует задачу как обновленную версию существующей задачи. При обновлении задачи с триггером регистрации задача будет выполняться после обновления.
TASK_CREATE_OR_UPDATE
0x6
 Планировщик задач регистрирует задачу как новую или обновленную версию, если задача уже существует. Эквивалент TASK_CREATE | TASK_UPDATE.
TASK_DISABLE
0x8
 Планировщик задач отключает существующую задачу.
TASK_DONT_ADD_PRINCIPAL_ACE
0x10
 Планировщик задач не может добавить запись разрешения управления доступом (ACE) для участника контекста. При вызове функции TaskFolder.RegisterTaskDefinition с этим флагом для обновления задачи служба планировщика задач не добавляет ACE для нового контекстного субъекта и не удаляет ACE из старого субъекта контекста.
TASK_IGNORE_REGISTRATION_TRIGGERS
0x20
 Планировщик задач создает задачу, но игнорирует триггеры регистрации в задаче. Игнорируя триггеры регистрации, задача не будет выполняться при регистрации, если триггер на основе времени не приведет к ее выполнению при регистрации.

userId [in]

Учетные данные пользователя, используемые для регистрации задачи. Если эти учетные данные присутствуют, они берут приоритет над учетными данными, указанными в объекте определения задачи, на который указывает параметр определения .

Примечание

Если задача определена как задача Планировщика задач версии 1.0, не используйте имя группы (а не конкретное имя пользователя) в этом параметре userId. Задача определяется как задача планировщика задач версии 1.0, если свойству Compatibility задано значение 1 в параметрах задачи.

password [in]

Пароль для userId, используемого для регистрации задачи. При использовании типа входа TASK_LOGON_SERVICE_ACCOUNT пароль должен быть пустым значением VARIANT , например VT_NULL или VT_EMPTY.

logonType [in]

Определяет, какой метод входа используется для выполнения зарегистрированной задачи.

Значение Значение
TASK_LOGON_NONE
0
 Метод входа не указан. Используется для учетных данных, отличных от NT.
TASK_LOGON_PASSWORD
1
 Используйте пароль для входа пользователя. Пароль должен быть указан во время регистрации.
TASK_LOGON_S4U
2
 Используйте существующий интерактивный маркер для выполнения задачи. Пользователь должен войти в систему с помощью службы для входа пользователя (S4U). При использовании входа S4U система не сохраняет пароль, а также нет доступа ни к сети, ни к зашифрованным файлам.
TASK_LOGON_INTERACTIVE_TOKEN
3
 Пользователь уже должен войти в систему. Задача будет выполняться только в существующем интерактивном сеансе.
TASK_LOGON_GROUP
4
 Активация группы. Поле groupId указывает группу.
TASK_LOGON_SERVICE_ACCOUNT
5
 Указывает, что учетная запись локальной системы, локальной службы или сетевой службы используется в качестве контекста безопасности для выполнения задачи.
TASK_LOGON_INTERACTIVE_TOKEN_OR_PASSWORD
6
 Сначала используйте интерактивный маркер. Если пользователь не вошел в систему (интерактивный маркер недоступен), используется пароль. Пароль должен быть указан при регистрации задачи. Этот флаг не рекомендуется использовать для новых задач, так как он менее надежный, чем TASK_LOGON_PASSWORD.

sddl [in, необязательный]

Дескриптор безопасности, связанный с зарегистрированной задачей. Вы можете указать список управления доступом (ACL) в дескрипторе безопасности для задачи, чтобы разрешить или запретить определенным пользователям и группам доступ к задаче.

Примечание

Если учетной записи Local System отказано в доступе к задаче, служба планировщика задач может привести к непредвиденным результатам.

task [out]

Объект RegisteredTask , представляющий новую задачу.

Возвращаемое значение

Этот метод не возвращает значение.

Комментарии

Для задачи, содержащей действие окна сообщения, окно сообщения будет отображаться, если задача активирована и задача имеет тип интерактивного входа. Чтобы задать интерактивный тип входа в задачу, укажите 3 (TASK_LOGON_INTERACTIVE_TOKEN) или 4 (TASK_LOGON_GROUP) в свойстве LogonType субъекта задачи или в параметре logonTypeпараметра TaskFolder.RegisterTask или TaskFolder.RegisterTaskDefinition.

Только член группы "Администраторы" может создать задачу с триггером загрузки.

Вы можете успешно зарегистрировать задачу с помощью группы, указанной в параметре userId , и 3 (TASK_LOGON_INTERACTIVE_TOKEN), указанной в параметре logonTypeобъекта TaskFolder.RegisterTask или TaskFolder.RegisterTaskDefinition, но задача не будет выполняться.

Требования

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

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

Планировщик заданий

RegisteredTask

TaskFolder