Модуль community.windows.win_psexec — удалённый запуск команд от имени другого пользователя (с повышенными привилегиями)

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.windows. Для работы с этим модулем потребуются дополнительные компоненты. Подробности см. в разделе Требования.

Чтобы использовать модуль в сценарии, укажите: community.windows.win_psexec.

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

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

Удалённый запуск команд через службу PsExec.
Запуск команд от имени другого пользователя (домена) с повышенными привилегиями.

Требования

На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.

Microsoft PsExec

Параметры

Параметр	Описание
chdir путь	Запустить команду из этого (удалённого) каталога.
command строка / обязательный	Командная строка для запуска через PsExec (не более 260 символов).
elevated логический	Запустить команду с повышенными привилегиями. Варианты: `false` ← (по умолчанию) `true`
executable путь	Расположение утилиты PsExec (если она не находится в PATH). По умолчанию: `"psexec.exe"`
hostnames список / элементы типа string	Имена узлов, на которых нужно выполнить команду. Если параметр не указан, команда выполняется локально.
interactive логический	Запустить программу так, чтобы она взаимодействовала с рабочим столом удалённой системы. Варианты: `false` ← (по умолчанию) `true`
limited логический	Запустить команду от имени пользователя с ограниченными правами (удаляет группу Administrators и оставляет только привилегии, назначенные группе Users). Варианты: `false` ← (по умолчанию) `true`
nobanner логический	Не отображать заставку при запуске и уведомление об авторских правах. Работает только с определёнными версиями исполняемого файла PsExec. Варианты: `false` ← (по умолчанию) `true`
noprofile логический	Запустить команду, не загружая профиль учётной записи. Варианты: `false` ← (по умолчанию) `true`
password строка	Пароль (удалённого) пользователя, от имени которого нужно выполнить команду. Этот параметр обязателен для аутентификации.
priority строка	Используется для запуска команды с другим приоритетом. Варианты: `"abovenormal"` `"background"` `"belownormal"` `"high"` `"low"` `"realtime"`
session целое число	Задаёт идентификатор сеанса. Этот параметр используется совместно с interactive. Не действует, если для interactive задано значение `no`.
system логический	Запустить удалённую команду от имени учётной записи System. Варианты: `false` ← (по умолчанию) `true`
timeout целое число	Время ожидания подключения в секундах
username строка	(Удалённый) пользователь, от имени которого нужно выполнить команду. Если параметр не указан, используется текущий пользователь.
wait логический	Ожидать завершения приложения. Используйте только для приложений, не требующих взаимодействия с пользователем. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Дополнительные сведения о Microsoft PsExec доступны по адресу https://technet.microsoft.com/en-us/sysinternals/bb897553.aspx

См. также

community.windows.psexec: Выполняет команды на удалённом узле Windows с использованием модели PsExec.
ansible.builtin.raw: Выполняет низкоуровневую команду без дополнительной обработки.
ansible.windows.win_command: Выполняет команду на удалённом узле Windows.
ansible.windows.win_shell: Выполняет команды оболочки на целевых узлах.

Примеры

- 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: true
    system: true

- 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: DOMAIN\Administrator
    password: some_password
    priority: high

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

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

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

Ключ	Описание
cmd строка	Полная командная строка, использованная модулем, включая вызов PsExec и дополнительные параметры. Возвращается: всегда Пример: `"psexec.exe -nobanner \\\\remote_server -u \"DOMAIN\\Administrator\" -p \"some_password\" -accepteula E:\\setup.exe"`
pid целое число	Идентификатор процесса (PID) асинхронного процесса, созданного PsExec. Возвращается: когда `wait=False` Пример: `1532`
rc целое число	Код возврата команды. Возвращается: всегда Пример: `0`
stderr строка	Вывод ошибок команды. Возвращается: всегда Пример: `"Error 15 running E:\\setup.exe"`
stdout строка	Стандартный вывод команды. Возвращается: всегда Пример: `"Success."`

Авторы

Dag Wieers (@dagwieers)

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

© 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_psexec_module.html