windows-itpro-docs/windows/client-management/mdm/networkproxy-csp.md

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	Learn how the NetworkProxy configuration service provider (CSP) is used to configure a proxy server for ethernet and Wi-Fi connections.	dansimp	article	w10	windows	dansimp	08/29/2018		dansimp

NetworkProxy CSP

The table below shows the applicability of Windows:

Edition	Windows 10	Windows 11
Home	No	No
Pro	Yes	Yes
Windows SE	No	Yes
Business	Yes	Yes
Enterprise	Yes	Yes
Education	Yes	Yes

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.

How the settings work:

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

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

./Vendor/MSFT
NetworkProxy
----ProxySettingsPerUser
----AutoDetect
----SetupScriptUrl
----ProxyServer
--------ProxyAddress
--------Exceptions
--------UseProxyForLocalAddresses

./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 using a configuration file, only modifying registry settings on a local machine.

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 integer. 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 integer. Supported operations are Get and Replace. Starting in Windows 10, version 1803, the Delete operation is also supported.

Configuration Example

These generic code portions for the options ProxySettingsPerUser, Autodetect, and SetupScriptURL can be used for a specific operation, for example Replace. Only enter the portion of code needed in the Replace section.

<Replace>
    <CmdID>1</CmdID>
    <Item>
        <Target>
            <LocURI>./Vendor/MSFT/NetworkProxy/ProxySettingsPerUser</LocURI>
        </Target>
        <Meta>
            <Format xmlns="syncml:metinf">int</Format>
            <Type>text/plain</Type>
        </Meta>
        <Data>0</Data>
    </Item>
</Replace>

<Replace>
    <CmdID>2</CmdID>
    <Item>
        <Target>
            <LocURI>./Vendor/MSFT/NetworkProxy/AutoDetect</LocURI>
        </Target>
        <Meta>
            <Format xmlns="syncml:metinf">int</Format>
            <Type>text/plain</Type>
        </Meta>
        <Data>1</Data>
    </Item>
</Replace> 

<Replace>
    <CmdID>3</CmdID>
    <Item>
        <Target>
            <LocURI>./Vendor/MSFT/NetworkProxy/SetupScriptUrl</LocURI>
        </Target>
        <Meta>
            <Format xmlns="syncml:metinf">chr</Format>
            <Type>text/plain</Type>
        </Meta>
        <Data>Insert the proxy PAC URL location here:</Data>
    </Item>
</Replace>