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.
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:
- ./Vendor/MSFT/NetworkProxy
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. |
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 |
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: ; ) |
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 |
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. |
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. |
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 |
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>