community.windows.win_http_proxy – Управление настройками прокси для WinHTTP

Примечание

Этот плагин входит в коллекцию community.windows (версия 1.2.0).

Для его установки используйте: ansible-galaxy collection install community.windows.

Для использования в книге задач укажите: community.windows.win_http_proxy.

Обзор
Параметры
Примечания
См. также
Примеры

Обзор

Используется для настройки, удаления или импорта настроек прокси для служб Windows HTTP WinHTTP.
WinHTTP — это фреймворк, используемый приложениями или службами, обычно приложениями .NET или неинтерактивными службами, для выполнения веб-запросов.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
bypass list / elements=string		Список хостов, для которых будет проигнорирован настроенный прокси. Используйте `<local>` для соответствия именам хостов, которые не являются полными доменными именами. Это полезно, когда необходимо подключиться к внутренним сайтам, используя только имя хоста. Опустить, установить в null или в пустую строку/список, чтобы удалить список исключений. Если этот параметр установлен, необходимо также установить параметр proxy.
proxy raw		Строка или словарь, определяющие прокси-сервер. Если задаётся строка, она должна иметь вид `hostname`, `hostname:port`, или `protocol=hostname:port`. Если порт не определён, используется порт по умолчанию для используемого протокола. Если задаётся словарь, ключами должны быть протоколы, а значениями — имена хостов и/или порты для этих протоколов. Допустимые протоколы: `http`, `https`, `ftp`, и `socks`. Опустить, установить в null или пустую строку, чтобы удалить настройки прокси.
source string	Варианты: ie	Вместо ручного указания параметров proxy и/или bypass, установите это значение, чтобы импортировать прокси из определённого источника, например, Internet Explorer. Использование `ie` позволит импортировать настройки прокси Internet Explorer для текущего активного сетевого подключения текущего пользователя. В WinHTTP будут импортированы только URL-адрес прокси и список исключений из IE. Это аналогично выполнению `netsh winhttp import proxy source=ie`. Значение импортируется при выполнении модуля и не будет автоматически обновляться при изменении конфигурации IE в будущем. Для синхронизации последних изменений модуль необходимо будет запустить заново.

Примечания

Примечание

Это не то же самое, что настройки прокси в Internet Explorer, также известные как WinINet; для управления ими используйте модуль community.windows.win_inet_proxy.
Эти настройки применяются на уровне системы, а не на уровне пользователя. Для их выполнения требуются права администратора.

См. также

community.windows.win_inet_proxy: Официальная документация модуля community.windows.win_inet_proxy.

Примеры

- name: Set a proxy to use for all protocols
  community.windows.win_http_proxy:
    proxy: hostname

- name: Set a proxy with a specific port with a bypass list
  community.windows.win_http_proxy:
    proxy: hostname:8080
    bypass:
    - server1
    - server2
    - <local>

- name: Set the proxy based on the IE proxy settings
  community.windows.win_http_proxy:
    source: ie

- name: Set a proxy for specific protocols
  community.windows.win_http_proxy:
    proxy:
      http: hostname:8080
      https: hostname:8443

- name: Set a proxy for specific protocols using a string
  community.windows.win_http_proxy:
    proxy: http=hostname:8080;https=hostname:8443
    bypass: server1,server2,<local>

- name: Remove any proxy settings
  community.windows.win_http_proxy:
    proxy: ''
    bypass: ''

Авторы

Jordan Borean (@jborean93)

© 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/community/windows/win_http_proxy_module.html