Edit

NetworkProxy CSP

  • Article

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 list shows the NetworkProxy configuration service provider nodes:

AutoDetect

Scope Editions Applicable OS
✅ Device
❌ User		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅ Windows 10, version 1703 [10.0.15063] and later 
./Vendor/MSFT/NetworkProxy/AutoDetect

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

Description framework properties:

Property name Property value
Format int
Access Type Delete, Get, Replace
Default Value 1

Allowed values:

Value Description
0 Disabled.
1 (Default) Enabled.

ProxyServer

Scope Editions Applicable OS
✅ Device
❌ User		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅ Windows 10, version 1703 [10.0.15063] and later 
./Vendor/MSFT/NetworkProxy/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 don't apply to VPN connections.

Description framework properties:

Property name Property value
Format node
Access Type Get

ProxyServer/Exceptions

Scope Editions Applicable OS
✅ Device
❌ User		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅ Windows 10, version 1703 [10.0.15063] and later 
./Vendor/MSFT/NetworkProxy/ProxyServer/Exceptions

Addresses that shouldn't use the proxy server. The system won't use the proxy server for addresses beginning with what's specified in this node. Use semicolons (;) to separate entries.

Description framework properties:

Property name Property value
Format chr (string)
Access Type Delete, Get, Replace
Allowed Values List (Delimiter: ;)

ProxyServer/ProxyAddress

Scope Editions Applicable OS
✅ Device
❌ User		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅ Windows 10, version 1703 [10.0.15063] and later 
./Vendor/MSFT/NetworkProxy/ProxyServer/ProxyAddress

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

Description framework properties:

Property name Property value
Format chr (string)
Access Type Delete, Get, Replace

ProxyServer/UseProxyForLocalAddresses

Scope Editions Applicable OS
✅ Device
❌ User		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅ Windows 10, version 1703 [10.0.15063] and later 
./Vendor/MSFT/NetworkProxy/ProxyServer/UseProxyForLocalAddresses

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

Description framework properties:

Property name Property value
Format int
Access Type Delete, Get, Replace
Default Value 0

Allowed values:

Value Description
0 (Default) Use proxy server for local addresses.
1 Don't use proxy server for local addresses.

ProxySettingsPerUser

Scope Editions Applicable OS
✅ Device
❌ User		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅ Windows 10, version 1803 [10.0.17134] and later 
./Vendor/MSFT/NetworkProxy/ProxySettingsPerUser

When set to 0, it enables proxy configuration as global, machine wide.

Note

Per user proxy configuration setting is not supported using a configuration file, only modifying registry settings on a local machine.

Description framework properties:

Property name Property value
Format int
Access Type Delete, Get, Replace
Default Value 1

Allowed values:

Value Description
0 Proxy configuration is global, machine wide.
1 (Default) Proxy configuration is per user.

SetupScriptUrl

Scope Editions Applicable OS
✅ Device
❌ User		 ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC		 ✅ Windows 10, version 1703 [10.0.15063] and later 
./Vendor/MSFT/NetworkProxy/SetupScriptUrl

Address to the PAC script you want to use.

Description framework properties:

Property name Property value
Format chr (string)
Access Type Delete, Get, Replace

Examples

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>

Configuration service provider reference