Метод TaskFolder.RegisterTask

Статья
06/13/2023

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

Синтаксис

TaskFolder.RegisterTask( _
  ByVal path, _
  ByVal xmlText, _
  ByVal flags, _
  ByVal userId, _
  ByVal password, _
  ByVal logonType, _
  [ ByVal sddl ], _
  ByRef pTask _
)

Параметры

path [in]

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

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

xmlText [in]

Описание задачи в формате XML.

В следующих разделах содержатся задачи, определенные с помощью XML.

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.RegisterTask с этим флагом для обновления задачи служба планировщика задач не добавляет ACE для нового контекстного субъекта и не удаляет ACE из старого контекстного субъекта.
TASK_IGNORE_REGISTRATION_TRIGGERS 0x20	Планировщик задач создает задачу, но игнорирует триггеры регистрации в задаче. Игнорируя триггеры регистрации, задача не будет выполняться при регистрации, если триггер на основе времени не приведет к ее выполнению при регистрации.

userId [in]

Учетные данные пользователя, используемые для регистрации задачи.

Примечание

Если задача определена как задача Планировщика задач версии 1.0, не используйте имя группы (а не конкретное имя пользователя) в этом параметре userId. Задача определяется как задача Планировщика задач 1.0, если атрибут version элемента Task в XML задачи имеет значение 1.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 отказано в доступе к задаче, служба планировщика задач может привести к непредвиденным результатам.

pTask [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