Nota

Este complemento es parte del colección community.windows (versión 1.2.0).

Para instalarlo usa: ansible-galaxy collection install community.windows.

Para usarlo en un libro de jugadas, especifique: community.windows.win_wait_for_process.

  • Sinopsis
  • Parámetros
  • Ver también
  • Ejemplos
  • Valores devueltos

Sinopsis

  • Esperando a que un proceso comience o se detenga.
  • Esto es útil cuando los servicios de Windows se comportan mal y no enumeran las dependencias externas en su manifiesto.

Parámetros

Parámetro Opciones/Predeterminados Comentarios
propietariostring El propietario del proceso. Requiere PowerShell versión 4.0 o posterior.
pidentero El PID del proceso.
post_esperar_retrasoentero Defecto:
0
Segundos de espera después de verificar los procesos.
pre_esperar_retrasoentero Defecto:
0
Segundos de espera antes de comprobar los procesos.
process_min_countentero Defecto:
1
Número mínimo de procesos que coinciden con el patrón proporcionado para satisfacer present condition.Only se aplica a present.
proceso_nombre_exactolista / elementos=string El nombre de los procesos por los que esperar. El nombre de los procesos no debe incluir el sufijo de extensión de archivo.
nombre_del_proceso_patrónstring Patrón RegEx que coincide con los procesos deseados.
dormirentero Defecto:
1
Número de segundos para dormir entre cheques. Solo se aplica cuando se espera que comience un proceso. Esperar a que se inicie un proceso no tiene un mecanismo nativo de no sondeo. Esperar una parada usa PowerShell nativo y no requiere sondeo.
Expresarstring
    Opciones:

  • ausente
  • presente
Al comprobar si hay un proceso en ejecución present bloqueará la ejecución hasta que exista el proceso, o hasta que se alcance el tiempo de espera. absent bloqueará la ejecución hasta que el proceso ya no exista, o hasta que se alcance el tiempo de espera. presentel módulo regresará cambiado solo si el proceso no estaba presente en la verificación inicial pero estuvo presente en las verificaciones posteriores. Si, mientras esperaba absentse inician nuevos procesos que coinciden con el patrón proporcionado, estos nuevos procesos no se incluirán en la acción.
se acabó el tiempoentero Defecto:
300
El número máximo de segundos que se debe esperar para que un proceso se inicie o se detenga antes de que se produzca un error.

Ver también

Ver también

ansible.incorporado.wait_for

La documentación oficial sobre el ansible.incorporado.wait_for módulo.

ansible.windows.win_wait_for

La documentación oficial sobre el ansible.windows.win_wait_for módulo.

Ejemplos

-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:500sleep:5process_min_count:3

Valores devueltos

Los valores de retorno comunes están documentados aquílos siguientes son los campos exclusivos de este módulo:

Llave devuelto Descripción
transcurridoflotar siempre Los segundos transcurridos entre el inicio de la encuesta y el final del módulo.
Muestra:3.14159265
procesos_emparejadoscomplejo siempre Lista de procesos coincidentes (detenidos o iniciados).
nombrestring siempre El nombre del proceso coincidente.
Muestra:svchost
propietariostring cuando es compatible con PowerShell El propietario del proceso coincidente.
Muestra:AUTORIDADSISTEMA NT
pidentero siempre El PID del proceso coincidente.
Muestra:7908

Autores

  • Carlos Crossan (@crossan007)