mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-06-15 18:33:43 +00:00
NetworkProxy CSP
This commit is contained in:
@ -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 <server>[“:”<port>].
|
**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)
|
||||||
|
@ -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)
|
||||||
|
Reference in New Issue
Block a user