NetworkProxy CSP

The NetworkProxy configuration service provider (CSP) is used to configure a proxy server for ethernet and Wi-Fi connections. These settings do not apply to VPN connections. This CSP was added in Windows 10, version 1703.

Note

In Windows 10 Mobile, the NetworkProxy CSP only works in ethernet connections. Use the WiFi CSP to configure per-network proxy for Wi-Fi connections in mobile devices.

How the settings work:

  1. If auto-detect is enabled, the system tries to find the path to a proxy auto config (PAC) script and download it.
  2. If #1 fails and a setup script is specified, the system tries to download the explicitly configured PAC script.
  3. If #2 fails and a proxy server is specified, the system tries to use the explicitly configured proxy server.
  4. Otherwise, the system tries to reach the site directly.

The following diagram shows the NetworkProxy configuration service provider in tree format.

networkproxy csp

./Vendor/MSFT/NetworkProxy
The root node for the NetworkProxy configuration service provider..

ProxySettingsPerUser
Added in Windows 10, version 1803. When set to 0, it enables proxy configuration as global, machine wide.

Note

Per user proxy configuration setting is not supported.

AutoDetect
Automatically detect settings. If enabled, the system tries to find the path to a PAC script.

Valid values:

  • 0 - Disabled
  • 1 (default) - Enabled
The data type is int. Supported operations are Get and Replace.

SetupScriptUrl
Address to the PAC script you want to use.

The data type is string. Supported operations are Get and Replace.

ProxyServer
Node for configuring a static proxy for Ethernet and Wi-Fi connections. The same proxy server is used for all protocols - including HTTP, HTTPS, FTP, and SOCKS. These settings do not apply to VPN connections.

Supported operation is Get.

ProxyAddress
Address to the proxy server. Specify an address in the format <server>[“:”<port>].

The data type is string. Supported operations are Get and Replace.

Exceptions
Addresses that should not use the proxy server. The system will not use the proxy server for addresses beginning with what is specified in this node. Use semicolons (;) to separate entries.

The data type is string. Supported operations are Get and Replace.

UseProxyForLocalAddresses
Specifies whether the proxy server should be used for local (intranet) addresses.

Valid values:

  • 0 (default) - Do not use proxy server for local addresses
  • 1 - Use proxy server for local addresses
The data type is int. Supported operations are Get and Replace.