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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/windows/win_http_proxy_module.html