Proxy settings
Jump to overview

Policy overview

Key metadata and intent for this policy.

Category
Microsoft Edge > Proxy server
Supported on
Microsoft Edge version 77, Windows 7 or later

Supported OS tags: Windows7

Configures the proxy settings for Microsoft Edge. If you enable this policy, Microsoft Edge ignores all proxy-related options specified from the command line. If you don't configure this policy, users can choose their own proxy settings. This policy overrides the following individual policies: 'ProxyMode' (Configure proxy server settings) 'ProxyPacUrl' (Set the proxy .pac file URL) 'ProxyServer' (Configure address or URL of proxy server) 'ProxyBypassList' (Configure proxy bypass rules) Setting the 'ProxySettings' (Proxy settings) policy accepts the following fields: * ProxyMode, which lets you specify the proxy server used by Microsoft Edge and prevents users from changing proxy settings * ProxyPacUrl, a URL to a proxy .pac file or a PAC script encoded as a data URL with MIME type application/x-ns-proxy-autoconfig * ProxyPacMandatory, a boolean flag that prevents the network stack from falling back to direct connections with invalid or unavailable PAC script * ProxyServer, a URL for the proxy server * ProxyBypassList, a list of proxy hosts that Microsoft Edge bypasses For ProxyMode, the following values when chosen lead to the following results: * direct, a proxy is never used and all other fields are ignored. * system, the systems's proxy is used and all other fields are ignored. * auto_detect, all other fields are ignored. * fixed_servers, the ProxyServer and ProxyBypassList fields are used. * pac_script, the ProxyPacUrl, ProxyPacMandatory and ProxyBypassList fields are used. For more detailed examples, see https://go.microsoft.com/fwlink/?linkid=2094936. Example value: { "ProxyBypassList": "https://www.example1.com,https://www.example2.com,https://internalsite/", "ProxyMode": "pac_script", "ProxyPacMandatory": false, "ProxyPacUrl": "https://internal.site/example.pac", "ProxyServer": "123.123.123.123:8080" } Compact example value: {"ProxyBypassList": "https://www.example1.com,https://www.example2.com,https://internalsite/", "ProxyMode": "pac_script", "ProxyPacMandatory": false, "ProxyPacUrl": "https://internal.site/example.pac", "ProxyServer": "123.123.123.123:8080"}

Internal name
ProxySettings
Policy ID
e0b7cf70a74a
Elements
1

Registry values

How enabled and disabled states update the registry.

No explicit registry values are set for enabled or disabled states.

Policy elements

Inputs and configuration options exposed by this policy.

ScopeElementTypeRegistry mappingConstraints & behaviorCopy
Proxy settings
ID ProxySettings
text
Path
Software\Policies\Microsoft\Edge
Value name
ProxySettings
Type
REG_SZ
None
Proxy settings
Both · Type text
Registry mapping
Path
Software\Policies\Microsoft\Edge
Value name
ProxySettings
Type
REG_SZ
DetailsNone