mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-05-12 13:27:23 +00:00
152 lines
5.2 KiB
Markdown
152 lines
5.2 KiB
Markdown
---
|
||
title: NetworkProxy CSP
|
||
description: Learn how the NetworkProxy configuration service provider (CSP) is used to configure a proxy server for ethernet and Wi-Fi connections.
|
||
ms.author: vinpa
|
||
ms.topic: article
|
||
ms.prod: w10
|
||
ms.technology: windows
|
||
author: vinaypamnani-msft
|
||
ms.date: 08/29/2018
|
||
ms.reviewer:
|
||
manager: aaroncz
|
||
---
|
||
|
||
# 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.
|
||
|
||
```console
|
||
./Vendor/MSFT
|
||
NetworkProxy
|
||
----ProxySettingsPerUser
|
||
----AutoDetect
|
||
----SetupScriptUrl
|
||
----ProxyServer
|
||
--------ProxyAddress
|
||
--------Exceptions
|
||
--------UseProxyForLocalAddresses
|
||
```
|
||
|
||
<a href="" id="networkproxy"></a>**./Vendor/MSFT/NetworkProxy**
|
||
The root node for the NetworkProxy configuration service provider.
|
||
|
||
<a href="" id="proxysettingsperuser"></a>**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.
|
||
|
||
<a href="" id="autodetect"></a>**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.
|
||
|
||
<a href="" id="setupscripturl"></a>**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.
|
||
|
||
<a href="" id="proxyserver"></a>**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.
|
||
|
||
<a href="" id="proxyaddress"></a>**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.
|
||
|
||
<a href="" id="exceptions"></a>**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.
|
||
|
||
<a href="" id="useproxyforlocaladdresses"></a>**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.
|
||
|
||
```xml
|
||
<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>
|
||
```
|
||
|
||
```xml
|
||
<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>
|
||
```
|
||
|
||
```xml
|
||
<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>
|
||
```
|