Spec-Zone.ru › Ansible 2.8

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. [сообщество]

Авторы

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

Spec-Zone.ru

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