winrm – Выполнение задач через WinRM Майкрософт
Обзор
- Выполнение команд или передача/получение данных на целевой компьютер через WinRM
- Этот плагин позволяет передавать дополнительные аргументы, поддерживаемые протоколом, но не определённые явно здесь. Они должны иметь вид переменных, объявленных по следующему шаблону
ansible_winrm_<option>.
Требования
Ниже перечислены требования к локальному мастер-узлу, на котором выполняется данное соединение.
- pywinrm (библиотека Python)
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| connection_timeout целое число | var: ansible_winrm_connection_timeout | Устанавливает значения таймаута операции и чтения для подключения WinRM. Соответствует параметрам operation_timeout_sec и read_timeout_sec в pywinrm, поэтому избегайте установки этих переменных вместе с данным параметром.Значение по умолчанию — значение, установленное в установленной версии pywinrm. | |
| kerberos_command строка | По умолчанию: "kinit" | var: ansible_winrm_kinit_cmd | Команда Kerberos для запроса билета аутентификации |
| kerberos_mode строка |
| var: ansible_winrm_kinit_mode | Режим использования Kerberos. Вариант managed означает, что Ansible получит билет Kerberos. В то время как вариант manual означает, что билет уже должен быть получен пользователем. Если у вас возникают проблемы с зависанием Ansible при попытке получения билета Kerberos, вы можете установить его в manual и получить его вне Ansible или установить pexpect через pip и повторить попытку. |
| path строка | По умолчанию: "/wsman" | var: ansible_winrm_path | Путь URI для подключения |
| port целое число | По умолчанию: 5986 | var: ansible_port var: ansible_winrm_port | Порт для подключения winrm к удалённому целевому компьютеру По умолчанию используется порт https (5986), если используется http, он должен быть 5985 |
| remote_addr строка | По умолчанию: "inventory_hostname" | var: ansible_host var: ansible_winrm_host | Адрес компьютера с Windows |
| remote_password строка | var: ansible_password var: ansible_winrm_pass var: ansible_winrm_password | Пароль аутентификации для remote_user. Может быть предоставлен в качестве параметра командной строки.алиасы: пароль | |
| remote_user строка | var: ansible_user var: ansible_winrm_user | Пользователь для входа на компьютер с Windows | |
| scheme строка |
| var: ansible_winrm_scheme | Схема URI для использования Если не указано, по умолчанию используется https или http, если port равен 5985. |
| transport список | var: ansible_winrm_transport | Список транспортных протоколов winrm для попытки использования (ssl, plaintext, kerberos и т. д.) Если None (по умолчанию), плагин попытается автоматически определить правильный список Доступные варианты зависят от вашей версии pywinrm |
Статус
- Данное соединение не гарантирует обратную совместимость интерфейса. [превью]
- Это соединение поддерживается сообществом Ansible. [community]
Авторы
- Команда разработчиков Ansible
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
Подсказка
Элементы конфигурации для каждого типа записи имеют порядок приоритетов от низкого к высокому. Например, переменная, расположенная ниже в списке, переопределит переменную, расположенную выше.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/plugins/connection/winrm.html