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 | Максимальное количество секунд ожидания запуска или остановки процесса до появления ошибки. |
Примеры
- name: Wait 300 seconds for all Oracle VirtualBox processes to stop. (VBoxHeadless, VirtualBox, VBoxSVC)
win_wait_for_process:
process_name: '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.7/modules/win_wait_for_process_module.html
