deepblue/windows-itpro-docs
1
0
Fork 0
mirror of https://github.com/MicrosoftDocs/windows-itpro-docs.git synced 2025-05-12 21:37:22 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity
windows-itpro-docs/windows/client-management/mdm/networkproxy-csp.md
Daniel Ring 0cedc46474
Fix typos in NetworkProxy CSP detail page
2019-06-24 12:20:06 -07:00

3.6 KiB
Raw Blame History

title, description, ms.author, ms.topic, ms.prod, ms.technology, author, ms.date, ms.reviewer, manager
title description ms.author ms.topic ms.prod ms.technology author ms.date ms.reviewer manager
NetworkProxy CSP NetworkProxy CSP dansimp article w10 windows manikadhiman 08/29/2018 dansimp

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.

Supported operations are Add, Get, Replace, and Delete.

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. Starting in Windows 10, version 1803, the Delete operation is also supported.

SetupScriptUrl
Address to the PAC script you want to use.

The data type is string. Supported operations are Get and Replace. Starting in Windows 10, version 1803, the Delete operation is also supported.

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. Starting in Windows 10, version 1803, the Delete operation is also supported.

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. Starting in Windows 10, version 1803, the Delete operation is also supported.

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

  • 0 (default) - Use proxy server for local addresses
  • 1 - Do not use proxy server for local addresses

The data type is int. Supported operations are Get and Replace. Starting in Windows 10, version 1803, the Delete operation is also supported.