Spec-Zone.ru › Ansible 2.9

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

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

  • Описание
  • Параметры
  • Примечания
  • См. также
  • Примеры
  • Статус

Описание

  • Используется для установки или удаления настроек прокси для Windows INet, включая Internet Explorer.
  • WinINet — это фреймворк, используемый интерактивными приложениями для отправки веб-запросов.
  • Настройки прокси также могут использоваться другими приложениями, такими как Firefox, Chrome и другими, но окончательного списка нет.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
auto_config_url
строка
URL скрипта конфигурации прокси.
Скрипты конфигурации прокси обычно представляют собой JavaScript-файлы с расширением .pac, реализующие функцию C(FindProxyForURurl).
Пропускается, устанавливается в null или пустую строку для удаления URL автоконфигурации.
Соответствует флажку Использовать скрипт автоматической конфигурации в окне настроек подключения.
auto_detect
булево
    Варианты:
  • нет
  • да ←
Устанавливает WinINet для автоматического обнаружения настроек прокси с помощью Web Proxy Auto-Detection WPAD.
Соответствует флажку Автоматически обнаруживать настройки в окне настроек подключения.
bypass
список
Список хостов, которые будут игнорировать установленный прокси при обращении к ним.
Используйте <local> для сопоставления имен хостов, которые не являются полными доменными именами. Это полезно при подключении к внутренним сайтам, используя только имя хоста. Если определено, это должно быть последним элементом в списке bypass.
Используйте <-loopback> для отмены автоматического обхода прокси при подключении через любой обратный адрес, например, 127.0.0.1, localhost, или локальное имя хоста.
Пропускается, устанавливается в null или пустую строку/список для удаления списка bypass.
Если это установлено, то proxy также должен быть установлен.
connection
строка
Имя подключения IE для настройки настроек прокси.
Это подключения под заголовком Модем и виртуальные частные сети в настройках IE.
При отсутствии указания используется подключение по умолчанию для локальной сети.
proxy
-
Строка или словарь, определяющий прокси.
Если устанавливается строка, она должна быть в формате hostname, hostname:port, или protocol=hostname:port.
Если порт не определён, используется порт по умолчанию для используемого протокола.
Если устанавливается словарь, ключами должны быть протокол, а значениями — имя хоста и/или порт для этого протокола.
Допустимые протоколы: http, https, ftp, и socks.
Пропускается, устанавливается в null или пустую строку для удаления настроек прокси.

Примечания

Примечание

  • Это не то же самое, что настройки прокси, установленные в WinHTTP с помощью команды netsh. Для управления ими используйте модуль win_http_proxy.
  • По умолчанию эти настройки устанавливаются на уровне пользователя, а не на уровне системы. Для применения прокси для всех пользователей необходимо независимо установить реестровый параметр. Подробности смотрите в примерах.
  • Если необходимы настройки прокси на уровне пользователя, используйте become, чтобы стать любым локальным пользователем на хосте. Для работы не требуется пароль.
  • Если прокси требует аутентификации, установите учетные данные, используя модуль win_credential. Это требует использования become для доступа к хранилищу учетных данных.

См. также

См. также

win_http_proxy – Управляет настройками прокси для WinHTTP
Официальная документация модуля win_http_proxy.
win_credential – Управляет учетными данными Windows в диспетчере учетных данных
Официальная документация модуля win_credential.

Примеры

# This should be set before running the win_inet_proxy module
- name: Configure IE proxy settings to apply to all users
  win_regedit:
    path: HKLM:\SOFTWARE\Policies\Microsoft\Windows\CurrentVersion\Internet Settings
    name: ProxySettingsPerUser
    data: 0
    type: dword
    state: present

# This should be set before running the win_inet_proxy module
- name: Configure IE proxy settings to apply per user
  win_regedit:
    path: HKLM:\SOFTWARE\Policies\Microsoft\Windows\CurrentVersion\Internet Settings
    name: ProxySettingsPerUser
    data: 1
    type: dword
    state: present

- name: Configure IE proxy to use auto detected settings without an explicit proxy
  win_inet_proxy:
    auto_detect: yes

- name: Configure IE proxy to use auto detected settings with a configuration script
  win_inet_proxy:
    auto_detect: yes
    auto_config_url: http://proxy.ansible.com/proxy.pac

- name: Configure IE to use explicit proxy host
  win_inet_proxy:
    auto_detect: yes
    proxy: ansible.proxy

- name: Configure IE to use explicit proxy host with port and without auto detection
  win_inet_proxy:
    auto_detect: no
    proxy: ansible.proxy:8080

- name: Configure IE to use a specific proxy per protocol
  win_inet_proxy:
    proxy:
      http: ansible.proxy:8080
      https: ansible.proxy:8443

- name: Configure IE to use a specific proxy per protocol using a string
  win_inet_proxy:
    proxy: http=ansible.proxy:8080;https=ansible.proxy:8443

- name: Set a proxy with a bypass list
  win_inet_proxy:
    proxy: ansible.proxy
    bypass:
    - server1
    - server2
    - <-loopback>
    - <local>

- name: Remove any explicit proxies that are set
  win_inet_proxy:
    proxy: ''
    bypass: ''

# This should be done after setting the IE proxy with win_inet_proxy
- name: Import IE proxy configuration to WinHTTP
  win_http_proxy:
    source: ie

# Explicit credentials can only be set per user and require become to work
- name: Set credential to use for proxy auth
  win_credential:
    name: ansible.proxy  # The name should be the FQDN of the proxy host
    type: generic_password
    username: proxyuser
    secret: proxypass
    state: present
  become: yes
  become_user: '{{ ansible_user }}'
  become_method: runas

Статус

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

Авторы

  • 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_inet_proxy_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API