ansible.windows.win_shell – Выполнение команд оболочки на целевых хостах

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

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

• Модуль ansible.windows.win_shell принимает имя команды, за которым следует список аргументов, разделённых пробелами. Он похож на модуль ansible.windows.win_command, но выполняет команду через оболочку (по умолчанию PowerShell) на целевом хосте.
• Для не-Windows целей используйте модуль ansible.builtin.shell вместо него.

Параметры

Примечания

См. также

Примеры

- name: Execute a comand in the remote shell, stdout goes to the specified file on the remote
  ansible.windows.win_shell: C:\somescript.ps1 >> C:\somelog.txt

- name: Change the working directory to somedir/ before executing the command
  ansible.windows.win_shell: C:\somescript.ps1 >> C:\somelog.txt
  args:
    chdir: C:\somedir

- name: Run a command with an idempotent check on what it creates, will only run when somedir/somelog.txt does not exist
  ansible.windows.win_shell: C:\somescript.ps1 >> C:\somelog.txt
  args:
    chdir: C:\somedir
    creates: C:\somelog.txt

- name: Run a command under a non-Powershell interpreter (cmd in this case)
  ansible.windows.win_shell: echo %HOMEDIR%
  args:
    executable: cmd
  register: homedir_out

- name: Run multi-lined shell commands
  ansible.windows.win_shell: |
    $value = Test-Path -Path C:\temp
    if ($value) {
        Remove-Item -Path C:\temp -Force
    }
    New-Item -Path C:\temp -ItemType Directory

- name: Retrieve the input based on stdin
  ansible.windows.win_shell: '$string = [Console]::In.ReadToEnd(); Write-Output $string.Trim()'
  args:
    stdin: Input message

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

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

Авторы

• Matt Davis (@nitzmahone)