community.windows.win_http_proxy – Manages proxy settings for WinHTTP¶
Note
This plugin is part of the community.windows collection (version 1.3.0).
To install it use: ansible-galaxy collection install community.windows
.
To use it in a playbook, specify: community.windows.win_http_proxy
.
Synopsis¶
Used to set, remove, or import proxy settings for Windows HTTP Services
WinHTTP
.WinHTTP is a framework used by applications or services, typically .NET applications or non-interactive services, to make web requests.
Parameters¶
Notes¶
Note
This is not the same as the proxy settings set in Internet Explorer, also known as
WinINet
; use the community.windows.win_inet_proxy module to manage that instead.These settings are set system wide and not per user, it will require Administrative privileges to run.
See Also¶
See also
- community.windows.win_inet_proxy
The official documentation on the community.windows.win_inet_proxy module.
Examples¶
- 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: ''
Authors¶
Jordan Borean (@jborean93)