win_scheduled_task - Управление запланированными задачами

Новое в версии 2.0.

Обзор
Параметры
Примеры
Примечания
- Статус

Обзор

Управление запланированными задачами

Параметры

параметр	обязательно	по умолчанию	значения	комментарии
arguments	нет			Аргументы для выполнения запланированной задачи псевдонимы: argument
days_of_week	нет			Дни недели для запуска еженедельной задачи, не идемпотентно. Этот параметр требуется, когда `frequence=weekly`.
description	нет			Описание запланированной задачи
enabled	нет	True	True False	Включить/выключить задачу
executable	нет			Команда, которую должна выполнить запланированная задача. Этот параметр требуется, когда `state=true`. псевдонимы: execute
frequency	нет		once daily weekly	Частота выполнения команды, не идемпотентно. Этот параметр требуется, когда `state=true`
name	да			Имя запланированной задачи
password (добавлено в 2.4)	нет			Пароль для учетной записи пользователя, от имени которого должна выполняться запланированная задача. Требуется для запуска задачи без входа пользователя, за исключением встроенных учетных записей служб Windows. Этот параметр предназначен для задания учетных данных при первоначальном создании задачи и изменении сохраненных учетных данных пользователя, так как установка этого значения приведет к повторному созданию задачи.
path	нет	\		Папка задач, в которой будет храниться эта задача - создает несуществующий путь, когда `state` является `present`, и удаляет пустой путь, когда `state` является `absent`.
runlevel (добавлено в 2.4)	нет	ограниченный	ограниченный высший	Уровень прав пользователя, используемых для выполнения задачи
state	да		present absent	Состояние, которое должна получить задача
store_password (добавлено в 2.4)	нет	True		Сохранять пароль пользователя, от имени которого выполняется задача. Если `false`, задача будет иметь доступ только к локальным ресурсам.
time	нет			Время выполнения запланированной задачи, не идемпотентно. Этот параметр требуется, когда `state=true`.
user	нет	DOMAIN\user		Пользователь, от имени которого должна выполняться запланированная задача; по умолчанию текущий пользователь

Примеры

# Create a scheduled task to open a command prompt
- win_scheduled_task:
    name: TaskName
    description: open command prompt
    executable: cmd
    arguments: -opt1 -opt2
    path: \example
    time: 9am
    frequency: daily
    state: present
    enabled: yes
    user: SYSTEM

- name: Create a task to run a PowerShell script as NETWORK SERVICE at the highest user rights level
  win_scheduled_task:
    name: TaskName2
    description: Run a PowerShell script
    executable: C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe
    arguments: -ExecutionPolicy Unrestricted -NonInteractive -File C:\TestDir\Test.ps1
    time: 6pm
    frequency: once
    state: present
    enabled: yes
    user: NETWORK SERVICE
    runlevel: highest

- name: Change the above task to run under a domain user account, storing credentials for the task
  win_scheduled_task:
    name: TaskName2
    description: Run a PowerShell script
    executable: C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe
    arguments: -ExecutionPolicy Unrestricted -NonInteractive -File C:\TestDir\Test.ps1
    time: 6pm
    frequency: once
    state: present
    enabled: yes
    user: DOMAIN\user
    password: passwordGoesHere
    runlevel: highest

- name: Change the above task again, choosing not to store the password for the account
  win_scheduled_task:
    name: TaskName2
    description: Run a PowerShell script
    executable: C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe
    arguments: -ExecutionPolicy Unrestricted -NonInteractive -File C:\TestDir\Test.ps1
    time: 6pm
    frequency: once
    state: present
    enabled: yes
    user: DOMAIN\user
    runlevel: highest
    store_password: no

Примечания

Примечание

Этот модуль требует Windows Server 2012 или более поздней версии.

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимостью.

Для получения помощи в разработке модулей, если вы так пожелаете, пожалуйста, прочитайте Информация сообщества и вклад, Тестирование Ansible и Разработка модулей.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/win_scheduled_task_module.html