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

Примечание

Этот модуль входит в коллекцию community.windows (версия 2.3.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

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

Чтобы использовать его в плейбуке, укажите: community.windows.win_http_proxy.

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

Обзор

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

Параметры

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

Примечания

Примечание

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

См. также

community.windows.win_inet_proxy: Управление настройками прокси для WinINet и Internet Explorer.

Примеры

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