NetworkProxy CSP

This commit is contained in:
Vinay Pamnani
2023-02-17 16:51:11 -05:00
parent 2af970dae6
commit 0b446caf42
2 changed files with 564 additions and 220 deletions

View File

@ -1,29 +1,23 @@
--- ---
title: NetworkProxy CSP 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. description: Learn more about the NetworkProxy CSP.
author: vinaypamnani-msft
manager: aaroncz
ms.author: vinpa ms.author: vinpa
ms.topic: article ms.date: 02/17/2023
ms.localizationpriority: medium
ms.prod: windows-client ms.prod: windows-client
ms.technology: itpro-manage ms.technology: itpro-manage
author: vinaypamnani-msft ms.topic: reference
ms.date: 08/29/2018
ms.reviewer:
manager: aaroncz
--- ---
<!-- Auto-Generated CSP Document -->
<!-- NetworkProxy-Begin -->
# NetworkProxy CSP # NetworkProxy CSP
The table below shows the applicability of Windows: <!-- NetworkProxy-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
|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. 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: How the settings work:
@ -32,73 +26,332 @@ How the settings work:
- If #1 fails and a setup script is specified, the system tries to download the explicitly configured PAC script. - 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. - 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. - Otherwise, the system tries to reach the site directly.
<!-- NetworkProxy-Editable-End -->
The following shows the NetworkProxy configuration service provider in tree format. <!-- NetworkProxy-Tree-Begin -->
The following example shows the NetworkProxy configuration service provider in tree format.
```console ```text
./Vendor/MSFT ./Vendor/MSFT/NetworkProxy
NetworkProxy --- AutoDetect
----ProxySettingsPerUser --- ProxyServer
----AutoDetect ------ Exceptions
----SetupScriptUrl ------ ProxyAddress
----ProxyServer ------ UseProxyForLocalAddresses
--------ProxyAddress --- ProxySettingsPerUser
--------Exceptions --- SetupScriptUrl
--------UseProxyForLocalAddresses
``` ```
<!-- NetworkProxy-Tree-End -->
<a href="" id="networkproxy"></a>**./Vendor/MSFT/NetworkProxy** <!-- Device-AutoDetect-Begin -->
The root node for the NetworkProxy configuration service provider. ## AutoDetect
<a href="" id="proxysettingsperuser"></a>**ProxySettingsPerUser** <!-- Device-AutoDetect-Applicability-Begin -->
Added in Windows 10, version 1803. When set to 0, it enables proxy configuration as global, machine wide. | Scope | Editions | Applicable OS |
|:--|:--|:--|
| :heavy_check_mark: Device <br> :x: User | :x: Home <br> :heavy_check_mark: Pro <br> :heavy_check_mark: Enterprise <br> :heavy_check_mark: Education <br> :heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1703 [10.0.15063] and later |
<!-- Device-AutoDetect-Applicability-End -->
Supported operations are Add, Get, Replace, and Delete. <!-- Device-AutoDetect-OmaUri-Begin -->
```Device
./Vendor/MSFT/NetworkProxy/AutoDetect
```
<!-- Device-AutoDetect-OmaUri-End -->
> [!Note] <!-- Device-AutoDetect-Description-Begin -->
> Per user proxy configuration setting is not supported using a configuration file, only modifying registry settings on a local machine. <!-- Description-Source-DDF -->
<a href="" id="autodetect"></a>**AutoDetect**
Automatically detect settings. If enabled, the system tries to find the path to a PAC script. Automatically detect settings. If enabled, the system tries to find the path to a PAC script.
<!-- Device-AutoDetect-Description-End -->
Valid values: <!-- Device-AutoDetect-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- Device-AutoDetect-Editable-End -->
- 0 - Disabled <!-- Device-AutoDetect-DFProperties-Begin -->
- 1 (default) - Enabled **Description framework properties**:
The data type is integer. Supported operations are Get and Replace. Starting in Windows 10, version 1803, the Delete operation is also supported. | Property name | Property value |
|:--|:--|
| Format | int |
| Access Type | Delete, Get, Replace |
| Default Value | 1 |
<!-- Device-AutoDetect-DFProperties-End -->
<a href="" id="setupscripturl"></a>**SetupScriptUrl** <!-- Device-AutoDetect-AllowedValues-Begin -->
Address to the PAC script you want to use. **Allowed values**:
The data type is string. Supported operations are Get and Replace. Starting in Windows 10, version 1803, the Delete operation is also supported. | Value | Description |
|:--|:--|
| 0 | Disabled. |
| 1 (Default) | Enabled. |
<!-- Device-AutoDetect-AllowedValues-End -->
<a href="" id="proxyserver"></a>**ProxyServer** <!-- Device-AutoDetect-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- Device-AutoDetect-Examples-End -->
<!-- Device-AutoDetect-End -->
<!-- Device-ProxyServer-Begin -->
## ProxyServer
<!-- Device-ProxyServer-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| :heavy_check_mark: Device <br> :x: User | :x: Home <br> :heavy_check_mark: Pro <br> :heavy_check_mark: Enterprise <br> :heavy_check_mark: Education <br> :heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1703 [10.0.15063] and later |
<!-- Device-ProxyServer-Applicability-End -->
<!-- Device-ProxyServer-OmaUri-Begin -->
```Device
./Vendor/MSFT/NetworkProxy/ProxyServer
```
<!-- Device-ProxyServer-OmaUri-End -->
<!-- Device-ProxyServer-Description-Begin -->
<!-- Description-Source-DDF -->
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. 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.
<!-- Device-ProxyServer-Description-End -->
Supported operation is Get. <!-- Device-ProxyServer-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- Device-ProxyServer-Editable-End -->
<a href="" id="proxyaddress"></a>**ProxyAddress** <!-- Device-ProxyServer-DFProperties-Begin -->
Address to the proxy server. Specify an address in the format &lt;server&gt;[“:”&lt;port&gt;].  **Description framework properties**:
The data type is string. Supported operations are Get and Replace. Starting in Windows 10, version 1803, the Delete operation is also supported. | Property name | Property value |
|:--|:--|
| Format | node |
| Access Type | Get |
<!-- Device-ProxyServer-DFProperties-End -->
<a href="" id="exceptions"></a>**Exceptions** <!-- Device-ProxyServer-Examples-Begin -->
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.  <!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- Device-ProxyServer-Examples-End -->
The data type is string. Supported operations are Get and Replace. Starting in Windows 10, version 1803, the Delete operation is also supported. <!-- Device-ProxyServer-End -->
<a href="" id="useproxyforlocaladdresses"></a>**UseProxyForLocalAddresses** <!-- Device-ProxyServer-Exceptions-Begin -->
Specifies whether the proxy server should be used for local (intranet) addresses.  ### ProxyServer/Exceptions
Valid values: <!-- Device-ProxyServer-Exceptions-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| :heavy_check_mark: Device <br> :x: User | :x: Home <br> :heavy_check_mark: Pro <br> :heavy_check_mark: Enterprise <br> :heavy_check_mark: Education <br> :heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1703 [10.0.15063] and later |
<!-- Device-ProxyServer-Exceptions-Applicability-End -->
- 0 (default) - Use proxy server for local addresses <!-- Device-ProxyServer-Exceptions-OmaUri-Begin -->
- 1 - Do not use proxy server for local addresses ```Device
./Vendor/MSFT/NetworkProxy/ProxyServer/Exceptions
```
<!-- Device-ProxyServer-Exceptions-OmaUri-End -->
The data type is integer. Supported operations are Get and Replace. Starting in Windows 10, version 1803, the Delete operation is also supported. <!-- Device-ProxyServer-Exceptions-Description-Begin -->
<!-- Description-Source-DDF -->
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.
<!-- Device-ProxyServer-Exceptions-Description-End -->
## Configuration Example <!-- Device-ProxyServer-Exceptions-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- Device-ProxyServer-Exceptions-Editable-End -->
<!-- Device-ProxyServer-Exceptions-DFProperties-Begin -->
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | chr (string) |
| Access Type | Delete, Get, Replace |
| Allowed Values | List (Delimiter: `;`) |
<!-- Device-ProxyServer-Exceptions-DFProperties-End -->
<!-- Device-ProxyServer-Exceptions-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- Device-ProxyServer-Exceptions-Examples-End -->
<!-- Device-ProxyServer-Exceptions-End -->
<!-- Device-ProxyServer-ProxyAddress-Begin -->
### ProxyServer/ProxyAddress
<!-- Device-ProxyServer-ProxyAddress-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| :heavy_check_mark: Device <br> :x: User | :x: Home <br> :heavy_check_mark: Pro <br> :heavy_check_mark: Enterprise <br> :heavy_check_mark: Education <br> :heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1703 [10.0.15063] and later |
<!-- Device-ProxyServer-ProxyAddress-Applicability-End -->
<!-- Device-ProxyServer-ProxyAddress-OmaUri-Begin -->
```Device
./Vendor/MSFT/NetworkProxy/ProxyServer/ProxyAddress
```
<!-- Device-ProxyServer-ProxyAddress-OmaUri-End -->
<!-- Device-ProxyServer-ProxyAddress-Description-Begin -->
<!-- Description-Source-DDF -->
Address to the proxy server. Specify an address in the format `<server>`[":"`<port>`].
<!-- Device-ProxyServer-ProxyAddress-Description-End -->
<!-- Device-ProxyServer-ProxyAddress-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- Device-ProxyServer-ProxyAddress-Editable-End -->
<!-- Device-ProxyServer-ProxyAddress-DFProperties-Begin -->
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | chr (string) |
| Access Type | Delete, Get, Replace |
<!-- Device-ProxyServer-ProxyAddress-DFProperties-End -->
<!-- Device-ProxyServer-ProxyAddress-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- Device-ProxyServer-ProxyAddress-Examples-End -->
<!-- Device-ProxyServer-ProxyAddress-End -->
<!-- Device-ProxyServer-UseProxyForLocalAddresses-Begin -->
### ProxyServer/UseProxyForLocalAddresses
<!-- Device-ProxyServer-UseProxyForLocalAddresses-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| :heavy_check_mark: Device <br> :x: User | :x: Home <br> :heavy_check_mark: Pro <br> :heavy_check_mark: Enterprise <br> :heavy_check_mark: Education <br> :heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1703 [10.0.15063] and later |
<!-- Device-ProxyServer-UseProxyForLocalAddresses-Applicability-End -->
<!-- Device-ProxyServer-UseProxyForLocalAddresses-OmaUri-Begin -->
```Device
./Vendor/MSFT/NetworkProxy/ProxyServer/UseProxyForLocalAddresses
```
<!-- Device-ProxyServer-UseProxyForLocalAddresses-OmaUri-End -->
<!-- Device-ProxyServer-UseProxyForLocalAddresses-Description-Begin -->
<!-- Description-Source-DDF -->
Specifies whether the proxy server should be used for local (intranet) addresses.
<!-- Device-ProxyServer-UseProxyForLocalAddresses-Description-End -->
<!-- Device-ProxyServer-UseProxyForLocalAddresses-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- Device-ProxyServer-UseProxyForLocalAddresses-Editable-End -->
<!-- Device-ProxyServer-UseProxyForLocalAddresses-DFProperties-Begin -->
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | int |
| Access Type | Delete, Get, Replace |
| Default Value | 0 |
<!-- Device-ProxyServer-UseProxyForLocalAddresses-DFProperties-End -->
<!-- Device-ProxyServer-UseProxyForLocalAddresses-AllowedValues-Begin -->
**Allowed values**:
| Value | Description |
|:--|:--|
| 0 (Default) | Use proxy server for local addresses. |
| 1 | Do not use proxy server for local addresses. |
<!-- Device-ProxyServer-UseProxyForLocalAddresses-AllowedValues-End -->
<!-- Device-ProxyServer-UseProxyForLocalAddresses-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- Device-ProxyServer-UseProxyForLocalAddresses-Examples-End -->
<!-- Device-ProxyServer-UseProxyForLocalAddresses-End -->
<!-- Device-ProxySettingsPerUser-Begin -->
## ProxySettingsPerUser
<!-- Device-ProxySettingsPerUser-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| :heavy_check_mark: Device <br> :x: User | :x: Home <br> :heavy_check_mark: Pro <br> :heavy_check_mark: Enterprise <br> :heavy_check_mark: Education <br> :heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1803 [10.0.17134] and later |
<!-- Device-ProxySettingsPerUser-Applicability-End -->
<!-- Device-ProxySettingsPerUser-OmaUri-Begin -->
```Device
./Vendor/MSFT/NetworkProxy/ProxySettingsPerUser
```
<!-- Device-ProxySettingsPerUser-OmaUri-End -->
<!-- Device-ProxySettingsPerUser-Description-Begin -->
<!-- Description-Source-DDF -->
When set to 0, it enables proxy configuration as global, machine wide.
<!-- Device-ProxySettingsPerUser-Description-End -->
<!-- Device-ProxySettingsPerUser-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
> [!NOTE]
> Per user proxy configuration setting is not supported using a configuration file, only modifying registry settings on a local machine.
<!-- Device-ProxySettingsPerUser-Editable-End -->
<!-- Device-ProxySettingsPerUser-DFProperties-Begin -->
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | int |
| Access Type | Delete, Get, Replace |
| Default Value | 1 |
<!-- Device-ProxySettingsPerUser-DFProperties-End -->
<!-- Device-ProxySettingsPerUser-AllowedValues-Begin -->
**Allowed values**:
| Value | Description |
|:--|:--|
| 0 | Proxy configuration is global, machine wide. |
| 1 (Default) | Proxy configuration is per user. |
<!-- Device-ProxySettingsPerUser-AllowedValues-End -->
<!-- Device-ProxySettingsPerUser-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- Device-ProxySettingsPerUser-Examples-End -->
<!-- Device-ProxySettingsPerUser-End -->
<!-- Device-SetupScriptUrl-Begin -->
## SetupScriptUrl
<!-- Device-SetupScriptUrl-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| :heavy_check_mark: Device <br> :x: User | :x: Home <br> :heavy_check_mark: Pro <br> :heavy_check_mark: Enterprise <br> :heavy_check_mark: Education <br> :heavy_check_mark: Windows SE | :heavy_check_mark: Windows 10, version 1703 [10.0.15063] and later |
<!-- Device-SetupScriptUrl-Applicability-End -->
<!-- Device-SetupScriptUrl-OmaUri-Begin -->
```Device
./Vendor/MSFT/NetworkProxy/SetupScriptUrl
```
<!-- Device-SetupScriptUrl-OmaUri-End -->
<!-- Device-SetupScriptUrl-Description-Begin -->
<!-- Description-Source-DDF -->
Address to the PAC script you want to use.
<!-- Device-SetupScriptUrl-Description-End -->
<!-- Device-SetupScriptUrl-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- Device-SetupScriptUrl-Editable-End -->
<!-- Device-SetupScriptUrl-DFProperties-Begin -->
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | chr (string) |
| Access Type | Delete, Get, Replace |
<!-- Device-SetupScriptUrl-DFProperties-End -->
<!-- Device-SetupScriptUrl-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- Device-SetupScriptUrl-Examples-End -->
<!-- Device-SetupScriptUrl-End -->
<!-- NetworkProxy-CspMoreInfo-Begin -->
<!-- Add any additional information about this CSP here. Anything outside this section will get overwritten. -->
## 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. 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.
@ -149,3 +402,10 @@ These generic code portions for the options **ProxySettingsPerUser**, **Autodete
</Item> </Item>
</Replace> </Replace>
``` ```
<!-- NetworkProxy-CspMoreInfo-End -->
<!-- NetworkProxy-End -->
## Related articles
[Configuration service provider reference](configuration-service-provider-reference.md)

View File

@ -1,178 +1,262 @@
--- ---
title: NetworkProxy DDF file title: NetworkProxy DDF file
description: AppNetworkProxyLocker DDF file description: View the XML file containing the device description framework (DDF) for the NetworkProxy configuration service provider.
author: vinaypamnani-msft
manager: aaroncz
ms.author: vinpa ms.author: vinpa
ms.topic: article ms.date: 02/17/2023
ms.localizationpriority: medium
ms.prod: windows-client ms.prod: windows-client
ms.technology: itpro-manage ms.technology: itpro-manage
author: vinaypamnani-msft ms.topic: reference
ms.date: 12/05/2017
ms.reviewer:
manager: aaroncz
--- ---
<!-- Auto-Generated CSP Document -->
# NetworkProxy DDF file # NetworkProxy DDF file
This topic shows the OMA DM device description framework (DDF) for the **NetworkProxy** configuration service provider. The following XML file contains the device description framework (DDF) for the NetworkProxy configuration service provider.
Looking for the DDF XML files? See [CSP DDF files download](configuration-service-provider-ddf.md).
The XML below is the current version for this CSP.
```xml ```xml
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE MgmtTree PUBLIC " -//OMA//DTD-DM-DDF 1.2//EN" <!DOCTYPE MgmtTree PUBLIC " -//OMA//DTD-DM-DDF 1.2//EN" "http://www.openmobilealliance.org/tech/DTD/DM_DDF-V1_2.dtd"[<?oma-dm-ddf-ver supported-versions="1.2"?>]>
"http://www.openmobilealliance.org/tech/DTD/DM_DDF-V1_2.dtd"
[<?oma-dm-ddf-ver supported-versions="1.2"?>]>
<MgmtTree xmlns:MSFT="http://schemas.microsoft.com/MobileDevice/DM"> <MgmtTree xmlns:MSFT="http://schemas.microsoft.com/MobileDevice/DM">
<VerDTD>1.2</VerDTD> <VerDTD>1.2</VerDTD>
<MSFT:Diagnostics>
</MSFT:Diagnostics>
<Node>
<NodeName>NetworkProxy</NodeName>
<Path>./Vendor/MSFT</Path>
<DFProperties>
<AccessType>
<Get />
</AccessType>
<Description>The root node for the NetworkProxy configuration service provider.</Description>
<DFFormat>
<node />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME />
</DFType>
<MSFT:Applicability>
<MSFT:OsBuildVersion>10.0.15063</MSFT:OsBuildVersion>
<MSFT:CspVersion>1.0</MSFT:CspVersion>
<MSFT:EditionAllowList>0x4;0x1B;0x30;0x31;0x48;0x54;0x77;0x79;0x7A;0x7D;0x7E;0x81;0x82;0x88;0x88*;0x8A;0x8B;0xA1;0xA2;0xA4;0xA5;0xAB;0xAC;0xAF;0xB4;0xBC;0xBF;0xCA;0xCB;0xCD;</MSFT:EditionAllowList>
</MSFT:Applicability>
</DFProperties>
<Node> <Node>
<NodeName>NetworkProxy</NodeName> <NodeName>ProxySettingsPerUser</NodeName>
<Path>./Vendor/MSFT</Path> <DFProperties>
<DFProperties> <AccessType>
<AccessType> <Delete />
<Get /> <Get />
</AccessType> <Replace />
<DFFormat> </AccessType>
<node /> <DefaultValue>1</DefaultValue>
</DFFormat> <Description>When set to 0, it enables proxy configuration as global, machine wide.</Description>
<Occurrence> <DFFormat>
<One /> <int />
</Occurrence> </DFFormat>
<Scope> <Occurrence>
<Permanent /> <One />
</Scope> </Occurrence>
<DFType> <Scope>
<MIME>com.microsoft/1.0/MDM/NetworkProxy</MIME> <Permanent />
</DFType> </Scope>
</DFProperties> <DFType>
<Node> <MIME />
<NodeName>AutoDetect</NodeName> </DFType>
<DFProperties> <MSFT:Applicability>
<AccessType> <MSFT:OsBuildVersion>10.0.17134</MSFT:OsBuildVersion>
<Get /> <MSFT:CspVersion>1.0</MSFT:CspVersion>
<Replace /> </MSFT:Applicability>
</AccessType> <MSFT:AllowedValues ValueType="ENUM">
<DefaultValue>1</DefaultValue> <MSFT:Enum>
<DFFormat> <MSFT:Value>0</MSFT:Value>
<int /> <MSFT:ValueDescription>Proxy configuration is global, machine wide.</MSFT:ValueDescription>
</DFFormat> </MSFT:Enum>
<Occurrence> <MSFT:Enum>
<One /> <MSFT:Value>1</MSFT:Value>
</Occurrence> <MSFT:ValueDescription>Proxy configuration is per user.</MSFT:ValueDescription>
<Scope> </MSFT:Enum>
<Permanent /> </MSFT:AllowedValues>
</Scope> </DFProperties>
<DFType>
<MIME>text/plain</MIME>
</DFType>
</DFProperties>
</Node>
<Node>
<NodeName>SetupScriptUrl</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
</DFProperties>
</Node>
<Node>
<NodeName>ProxyServer</NodeName>
<DFProperties>
<AccessType>
<Get />
</AccessType>
<DFFormat>
<node />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<DDFName></DDFName>
</DFType>
</DFProperties>
<Node>
<NodeName>ProxyAddress</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
</DFProperties>
</Node>
<Node>
<NodeName>Exceptions</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
</DFProperties>
</Node>
<Node>
<NodeName>UseProxyForLocalAddresses</NodeName>
<DFProperties>
<AccessType>
<Get />
<Replace />
</AccessType>
<DefaultValue>0</DefaultValue>
<DFFormat>
<int />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME>text/plain</MIME>
</DFType>
</DFProperties>
</Node>
</Node>
</Node> </Node>
<Node>
<NodeName>AutoDetect</NodeName>
<DFProperties>
<AccessType>
<Delete />
<Get />
<Replace />
</AccessType>
<DefaultValue>1</DefaultValue>
<Description>Automatically detect settings. If enabled, the system tries to find the path to a PAC script.</Description>
<DFFormat>
<int />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME />
</DFType>
<MSFT:AllowedValues ValueType="ENUM">
<MSFT:Enum>
<MSFT:Value>0</MSFT:Value>
<MSFT:ValueDescription>Disabled</MSFT:ValueDescription>
</MSFT:Enum>
<MSFT:Enum>
<MSFT:Value>1</MSFT:Value>
<MSFT:ValueDescription>Enabled</MSFT:ValueDescription>
</MSFT:Enum>
</MSFT:AllowedValues>
</DFProperties>
</Node>
<Node>
<NodeName>SetupScriptUrl</NodeName>
<DFProperties>
<AccessType>
<Delete />
<Get />
<Replace />
</AccessType>
<Description>Address to the PAC script you want to use.</Description>
<DFFormat>
<chr />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME />
</DFType>
<MSFT:AllowedValues ValueType="None">
</MSFT:AllowedValues>
</DFProperties>
</Node>
<Node>
<NodeName>ProxyServer</NodeName>
<DFProperties>
<AccessType>
<Get />
</AccessType>
<Description>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.</Description>
<DFFormat>
<node />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<DDFName />
</DFType>
</DFProperties>
<Node>
<NodeName>ProxyAddress</NodeName>
<DFProperties>
<AccessType>
<Delete />
<Get />
<Replace />
</AccessType>
<Description><![CDATA[Address to the proxy server. Specify an address in the format <server>[“:”<port>]. ]]></Description>
<DFFormat>
<chr />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME />
</DFType>
<MSFT:AllowedValues ValueType="None">
</MSFT:AllowedValues>
</DFProperties>
</Node>
<Node>
<NodeName>Exceptions</NodeName>
<DFProperties>
<AccessType>
<Delete />
<Get />
<Replace />
</AccessType>
<Description>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. </Description>
<DFFormat>
<chr />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME />
</DFType>
<MSFT:AllowedValues ValueType="None">
<MSFT:List Delimiter=";" />
</MSFT:AllowedValues>
</DFProperties>
</Node>
<Node>
<NodeName>UseProxyForLocalAddresses</NodeName>
<DFProperties>
<AccessType>
<Delete />
<Get />
<Replace />
</AccessType>
<DefaultValue>0</DefaultValue>
<Description>Specifies whether the proxy server should be used for local (intranet) addresses. Valid values:</Description>
<DFFormat>
<int />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<DFType>
<MIME />
</DFType>
<MSFT:AllowedValues ValueType="ENUM">
<MSFT:Enum>
<MSFT:Value>0</MSFT:Value>
<MSFT:ValueDescription>Use proxy server for local addresses</MSFT:ValueDescription>
</MSFT:Enum>
<MSFT:Enum>
<MSFT:Value>1</MSFT:Value>
<MSFT:ValueDescription>Do not use proxy server for local addresses</MSFT:ValueDescription>
</MSFT:Enum>
</MSFT:AllowedValues>
</DFProperties>
</Node>
</Node>
</Node>
</MgmtTree> </MgmtTree>
``` ```
## Related articles
[NetworkProxy configuration service provider reference](networkproxy-csp.md)