Модуль community.windows.win_wait_for_process — ожидает появления или завершения процесса, прежде чем продолжить.

Примечание

Этот модуль входит в коллекцию community.windows (версия 3.1.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.windows.

Чтобы использовать её в плейбуке, укажите: community.windows.win_wait_for_process.

Краткое описание
Параметры
См. также
Примеры
Возвращаемые значения

Краткое описание

Ожидание запуска или остановки процесса.
Полезно, когда службы Windows работают некорректно и не перечисляют внешние зависимости в своём манифесте.

Параметры

Параметр	Комментарии
owner string	Владелец процесса. Требуется PowerShell версии 4.0 или новее.
pid integer	Идентификатор процесса (PID). По умолчанию: `0`
post_wait_delay integer	Количество секунд ожидания после проверки процессов. По умолчанию: `0`
pre_wait_delay integer	Количество секунд ожидания перед проверкой процессов. По умолчанию: `0`
process_min_count integer	Минимальное количество процессов, соответствующих заданному шаблону, необходимое для выполнения условия `present`. Применяется только к `present`. По умолчанию: `1`
process_name_exact list / elements=string	Имя процесса или процессов, появления или завершения которых нужно дождаться. Имя процесса или процессов не должно содержать расширение файла.
process_name_pattern string	Шаблон RegEx для поиска нужных процессов.
sleep integer	Количество секунд ожидания между проверками. Применяется только при ожидании запуска процесса. Для ожидания запуска процесса нет встроенного механизма без опроса. При ожидании остановки используется встроенный механизм PowerShell, опрос не требуется. По умолчанию: `1`
state string	При проверке работающего процесса `present` блокирует выполнение до появления процесса или до истечения времени ожидания. `absent` блокирует выполнение, пока процесс не завершится или не истечёт время ожидания. При ожидании `present` модуль вернёт признак изменения, только если при начальной проверке процесс отсутствовал, но появился при последующих проверках. Если во время ожидания `absent` запускаются новые процессы, соответствующие заданному шаблону, эти процессы не будут включены в действие. Варианты: `"absent"` `"present"` ← (по умолчанию)
timeout integer	Максимальное количество секунд ожидания запуска или остановки процесса до завершения с ошибкой. По умолчанию: `300`

См. также

ansible.builtin.wait_for: Ожидает выполнения условия, прежде чем продолжить.
ansible.windows.win_wait_for: Ожидает выполнения условия, прежде чем продолжить.

Примеры

- name: Wait 300 seconds for all Oracle VirtualBox processes to stop. (VBoxHeadless, VirtualBox, VBoxSVC)
  community.windows.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
  community.windows.win_wait_for_process:
    process_name_exact: cmd
    state: present
    timeout: 500
    sleep: 5
    process_min_count: 3

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:

Ключ	Описание
elapsed float	Количество секунд, прошедших с начала опроса до завершения работы модуля. Возвращается: всегда Пример: `3.14159265`
matched_processes complex	Список совпавших процессов (остановленных или запущенных). Возвращается: всегда
name string	Имя совпавшего процесса. Возвращается: всегда Пример: `"svchost"`
owner string	Владелец совпавшего процесса. Возвращается: если поддерживается PowerShell Пример: `"NT AUTHORITY\\SYSTEM"`
pid integer	Идентификатор (PID) совпавшего процесса. Возвращается: всегда Пример: `7908`

Авторы

Charles Crossan (@crossan007)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/windows/win_wait_for_process_module.html