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

Новая в версии 2.8.

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

Обзор

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

Параметры

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

Примечания

Примечание

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

См. также

win_inet_proxy – Управляет настройками прокси для WinINet и Internet Explorer: Официальная документация модуля win_inet_proxy.

Примеры

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

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

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

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

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

- name: Remove any proxy settings
  win_http_proxy:
    proxy: ''
    bypass: ''

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

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.9/modules/win_http_proxy_module.html