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