ansible.builtin.winrm – Выполнение задач через WinRM Майкрософт
Примечание
Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля winrm даже без указания ключевого слова collections:. Несмотря на это, мы рекомендуем использовать полное имя класса (FQCN) для лёгкой ссылки на документацию по модулю и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.
Новый в версии 2.0: of ansible.builtin
Обзор
- Выполнение команд или put/fetch на целевой системе через 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. Может быть передан как параметр командной строки.псевдонимы: password | |
| 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 Core
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/ansible/builtin/winrm_connection.html
