Nicholas Brower 1ae3f0b230 Merged PR 4822: "msdate update (generated from most recent commit date)"
"msdate update (generated from most recent commit date)"
2017-12-05 22:36:05 +00:00

3.4 KiB

title, description, ms.author, ms.topic, ms.prod, ms.technology, author, ms.date
title description ms.author ms.topic ms.prod ms.technology author ms.date
NetworkProxy CSP NetworkProxy CSP maricia article w10 windows nickbrower 06/26/2017

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..

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.