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_psexec.

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

Sinopsis

  • Ejecute comandos (de forma remota) a través del servicio PsExec.
  • Ejecute comandos como otro usuario (de dominio) (con privilegios elevados).

Requisitos

Los siguientes requisitos son necesarios en el host que ejecuta este módulo.

  • microsoft psexec

Parámetros

Parámetro Opciones/Predeterminados Comentarios
chdirsendero Ejecute el comando desde este directorio (remoto).
dominiostring / requerido La línea de comando para ejecutar a través de PsExec (limitado a 260 caracteres).
elevadobooleano
    Opciones:

  • no ←
  • sí
 Ejecute el comando con privilegios elevados.
ejecutablesendero Defecto:
“psexec.exe”		 La ubicación de la utilidad PsExec (en caso de que no se encuentre en su RUTA).
nombres de hostlista / elementos=string Los nombres de host para ejecutar el comando. Si no se proporcionan, el comando se ejecuta localmente.
interactivobooleano
    Opciones:

  • no ←
  • sí
 Ejecute el programa para que interactúe con el escritorio en el sistema remoto.
limitadobooleano
    Opciones:

  • no ←
  • sí
 Ejecute el comando como usuario limitado (elimina el grupo Administradores y permite solo los privilegios asignados al grupo Usuarios).
sin bannerbooleano
    Opciones:

  • no ←
  • sí
 No muestre el banner de inicio ni el mensaje de derechos de autor. Esto solo funciona para versiones específicas del binario PsExec.
sin perfilbooleano
    Opciones:

  • no ←
  • sí
 Ejecute el comando sin cargar el perfil de la cuenta.
clavestring La contraseña para que el usuario (remoto) ejecute el comando como. Esto es obligatorio para poder autenticarse.
prioridadstring
    Opciones:

  • por encima de lo normal
  • antecedentes
  • debajo de lo normal
  • alto
  • bajo
  • tiempo real
 Se utiliza para ejecutar el comando con una prioridad diferente.
sesiónentero Especifica el ID de sesión que se utilizará. Este parámetro funciona junto con interactivo.No tiene efecto cuando interactivo se establece en no.
sistemabooleano
    Opciones:

  • no ←
  • sí
 Ejecute el comando remoto en la cuenta del sistema.
se acabó el tiempoentero El tiempo de espera de la conexión en segundos
nombre de usuariostring El usuario (remoto) para ejecutar el comando como. Si no se proporciona, se utiliza el usuario actual.
Esperebooleano
    Opciones:

  • no
  • sí ←
 Espere a que finalice la aplicación. Úselo solo para aplicaciones no interactivas.

notas

Nota

Ver también

Ver también

comunidad.windows.psexec

La documentación oficial sobre el comunidad.windows.psexec módulo.

ansible.integrado.sin procesar

La documentación oficial sobre el ansible.integrado.sin procesar módulo.

ansible.windows.win_command

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

ansible.windows.win_shell

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

Ejemplos

- name: Test the PsExec connection to the local system (target node) with your user
  community.windows.win_psexec:
    command: whoami.exe

- name: Run regedit.exe locally (on target node) as SYSTEM and interactively
  community.windows.win_psexec:
    command: regedit.exe
    interactive: yes
    system: yes

- name: Run the setup.exe installer on multiple servers using the Domain Administrator
  community.windows.win_psexec:
    command: E:setup.exe /i /IACCEPTEULA
    hostnames:
    - remote_server1
    - remote_server2
    username: DOMAINAdministrator
    password: some_password
    priority: high

- name: Run PsExec from custom location C:Program Filessysinternals
  community.windows.win_psexec:
    command: netsh advfirewall set allprofiles state off
    executable: C:Program Filessysinternalspsexec.exe
    hostnames: [ remote_server ]
    password: some_password
    priority: low

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
cmdstring siempre La línea de comando completa utilizada por el módulo, incluida la llamada PsExec y opciones adicionales.
Muestra:psexec.exe -nobanner \remote_server -u “DOMINIOAdministrador” -p “alguna_contraseña” -accepteula E:setup.exe
pidentero cuando wait=False El PID del proceso asíncrono creado por PsExec.
Muestra:1532
rcentero siempre El código de retorno para el comando.
estándarstring siempre La salida de error del comando.
Muestra:Error 15 al ejecutar E:setup.exe
salida estándarstring siempre La salida estándar del comando.
Muestra:Éxito.

Autores

  • Dag Wieers (@dagwieers)