win_wait_for_process – Ожидание существования или отсутствия процесса перед продолжением
Новое в версии 2.7.
Описание
- Ожидание запуска или остановки процесса.
- Это полезно, когда службы Windows работают плохо и не перечисляют внешние зависимости в своём манифесте.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| owner строка | Владелец процесса. Требуется версия PowerShell 4.0 или более поздняя. | |
| pid целое число | Идентификатор процесса (PID). | |
| post_wait_delay целое число | Значение по умолчанию: 0 | Секунды ожидания после проверки процессов. |
| pre_wait_delay целое число | Значение по умолчанию: 0 | Секунды ожидания перед проверкой процессов. |
| process_min_count целое число | Значение по умолчанию: 1 | Минимальное количество процессов, соответствующих заданному шаблону, для выполнения условия present. Применимо только к present. |
| process_name_exact список | Имя процесса(ов), для которого(ых) ожидается запуск. Имя процесса(ов) не должно включать расширение файла. | |
| process_name_pattern строка | Шаблон RegEx для сопоставления нужного процесса(ов). | |
| sleep целое число | Значение по умолчанию: 1 | Количество секунд ожидания между проверками. Применимо только при ожидании запуска процесса. Ожидание запуска процесса не имеет собственного механизма без опроса. Ожидание остановки использует средства PowerShell и не требует опроса. |
| state строка |
| При проверке работающего процесса present будет блокировать выполнение, пока процесс существует или не будет достигнут предел времени ожидания. absent будет блокировать выполнение, пока процесс больше не существует или не будет достигнут предел времени ожидания.При ожидании present, модуль вернёт изменения только в случае, если процесс отсутствовал при первоначальной проверке, но появился в последующих.Если во время ожидания absent, новые процессы, соответствующие заданному шаблону, запускаются, эти новые процессы не будут включены в действие. |
| timeout целое число | Значение по умолчанию: 300 | Максимальное количество секунд ожидания запуска или остановки процесса перед ошибкой. |
См. также
См. также
- wait_for – Ожидание условия перед продолжением
- Официальная документация модуля wait_for.
- win_wait_for – Ожидание условия перед продолжением
- Официальная документация модуля win_wait_for.
Примеры
- name: Wait 300 seconds for all Oracle VirtualBox processes to stop. (VBoxHeadless, VirtualBox, VBoxSVC)
win_wait_for_process:
process_name_pattern: 'v(irtual)?box(headless|svc)?'
state: absent
timeout: 500
- name: Wait 300 seconds for 3 instances of cmd to start, waiting 5 seconds between each check
win_wait_for_process:
process_name_exact: cmd
state: present
timeout: 500
sleep: 5
process_min_count: 3
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое | Описание | |
|---|---|---|---|
| elapsed число с плавающей точкой | всегда | Прошедшие секунды с начала опроса до конца модуля. Пример: 3.14159265 | |
| matched_processes сложный тип | всегда | Список сопоставленных процессов (остановленных или запущенных). | |
| name строка | всегда | Имя сопоставленного процесса. Пример: svchost | |
| owner строка | при поддержке PowerShell | Владелец сопоставленного процесса. Пример: NT AUTHORITY\SYSTEM | |
| pid целое число | всегда | Идентификатор процесса (PID) сопоставленного процесса. Пример: 7908 | |
Статус
- Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Charles Crossan (@crossan007)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/win_wait_for_process_module.html
