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. [сообщество]
Авторы
- 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.8/modules/win_wait_for_process_module.html
