community.windows.win_http_proxy module – Manages proxy settings for WinHTTP
This module is part of the community.windows collection (version 1.11.0).
You might already have this collection installed if you are using the
It is not included in
To check whether it is installed, run
ansible-galaxy collection list.
To install it, use:
ansible-galaxy collection install community.windows.
To use it in a playbook, specify:
Used to set, remove, or import proxy settings for Windows HTTP Services
WinHTTP is a framework used by applications or services, typically .NET applications or non-interactive services, to make web requests.
A list of hosts that will bypass the set proxy when being accessed.
Omit, set to null or an empty string/list to remove the bypass list.
If this is set then proxy must also be set.
A string or dict that specifies the proxy to be set.
If setting a string, should be in the form
If the port is undefined, the default port for the protocol in use is used.
If setting a dict, the keys should be the protocol and the values should be the hostname and/or port for that protocol.
Valid protocols are
Omit, set to null or an empty string to remove the proxy settings.
Instead of manually specifying the proxy and/or bypass, set this to import the proxy from a set source like Internet Explorer.
Only IE’s proxy URL and bypass list will be imported into WinHTTP.
This is like running
The value is imported when the module runs and will not automatically be updated if the IE configuration changes in the future. The module will have to be run again to sync the latest changes.
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.
The official documentation on the community.windows.win_inet_proxy module.
- 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: ''