win_psexec - Выполняет команды (удалённо) от имени другого (привилегированного) пользователя
Новое в версии 2.3.
Описание
- Выполнение команд (удалённо) через службу PsExec
- Выполнение команд от имени другого (доменного) пользователя (с повышенными привилегиями)
Требования
Ниже перечислены требования к хосту, на котором выполняется данный модуль.
- Microsoft PsExec
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| chdir | Выполнить команду из этого (удалённого) каталога. | |
| command обязательно | Командная строка для выполнения через PsExec (ограничено 260 символами). | |
| elevated |
| Выполнить команду с повышенными привилегиями. |
| executable | Значение по умолчанию: psexec.exe | Путь к утилите PsExec (в случае, если она не находится в вашей переменной PATH). |
| hostnames | Имена хостов для выполнения команды. Если не указано, команда выполняется локально. | |
| interactive |
| Запустить программу так, чтобы она взаимодействовала с рабочим столом на удалённой системе. |
| limited |
| Выполнить команду как ограниченный пользователь (удаляет группу Администраторы и разрешает только привилегии, назначенные для группы Пользователи). |
| nobanner (добавлен в 2.4) |
| Не отображать стартовую заставку и сообщение об авторских правах. Это работает только для определённых версий двоичного файла PsExec. |
| noprofile |
| Выполнить команду без загрузки профиля учётной записи. |
| password | Пароль для (удалённого) пользователя, от имени которого выполняется команда. Это обязательно для аутентификации. | |
| priority |
| Используется для выполнения команды с другим приоритетом. |
| system |
| Выполнить удалённую команду от имени учётной записи Системы. |
| timeout | Таймаут подключения в секундах | |
| username | Имя (удалённого) пользователя, от имени которого выполняется команда. Если не указано, используется текущий пользователь. | |
| wait |
| Дождаться завершения приложения. Используется только для неинтерактивных приложений. |
Примечания
Примечание
- Дополнительную информацию о Microsoft PsExec можно найти на странице https://technet.microsoft.com/ru-ru/sysinternals/bb897553.aspx
Примеры
- name: Test the PsExec connection to the local system (target node) with your user
win_psexec:
command: whoami.exe
- name: Run regedit.exe locally (on target node) as SYSTEM and interactively
win_psexec:
command: regedit.exe
interactive: yes
system: yes
- name: Run the setup.exe installer on multiple servers using the Domain Administrator
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\
win_psexec:
command: netsh advfirewall set allprofiles state off
executable: C:\Program Files\sysinternals\psexec.exe
hostnames: [ remote_server ]
password: some_password
priority: low
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| changed bool | всегда | Были ли внесены изменения. Пример: Истина |
| cmd строка | всегда | Полная командная строка, используемая модулем, включая вызов PsExec и дополнительные параметры. Пример: psexec.exe -nobanner \\remote_server -u "DOMAIN\Administrator" -p "some_password" -accepteula E:\setup.exe |
| msg строка | ошибка | Возможные сообщения об ошибке при ошибке Пример: Параметр 'password' является обязательным параметром. |
| rc целое число | всегда | Код возврата команды |
| stderr строка | всегда | Вывод ошибок команды Пример: Ошибка 15 при выполнении E:\setup.exe |
| stdout строка | всегда | Стандартный вывод команды Пример: Успешно. |
Статус
Данный модуль помечен как превью, что означает, что его интерфейс не гарантирует обратную совместимость.
Автор
- Dag Wieers (@dagwieers)
Подсказка
Если вы заметите какие-либо проблемы в этом документе, вы можете изменить этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/win_psexec_module.html
