winhttp_proxy

Table of Contents

1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with winhttp_proxy
   • What winhttp_proxy affects
   • Setup requirements
4. Reference - An under-the-hood peek at what the module is doing and how
5. Limitations - OS compatibility, etc.
6. Development - Guide for contributing to the module

Overview

Manage Windows system proxy (i.e. WinHTTP Proxy, not the Internet Explorer one).

Module Description

This module use netsh command to change the Windows system proxy settings.

Setup

What winhttp_proxy affects

This module changes the "netsh winhttp proxy" context.

For more info, read M$ docs

###Setup Requirements

Winhttp_proxy uses Ruby-based providers, so you must enable pluginsync enabled.

Reference

winhttp_proxy

Examples :

winhttp_proxy { 'proxy':
  proxy_server => 'proxy',
  bypass_list  => '<local>'
}

winhttp_proxy { 'proxy':
  proxy_server => 'http=proxy.example.com;https=proxy.example.org',
  bypass_list  => '<local>;*.example.org;*.example.com'
}

Limitations

Requires Windows >= 7 or Windows >= 2008 (netsh provider).

Development

As any github project, you can read the source, fork and report issues.