Edit

Share via

ProxyMode

  • Article

Configure proxy server settings (deprecated)

DEPRECATED: This policy is deprecated. It is currently supported but will become obsolete in a future release.

Supported versions

  • On Windows and macOS since 77 or later

Description

This policy is deprecated, use ProxySettings instead. It won't work in Microsoft Edge version 91.

If you set this policy to Enabled you can specify the proxy server Microsoft Edge uses and prevents users from changing proxy settings. Microsoft Edge ignores all proxy-related options specified from the command line. The policy is only applied if the ProxySettings policy isn't specified.

Other options are ignored if you choose one of the following options:

  • direct = Never use a proxy server and always connect directly
  • system = Use system proxy settings
  • auto_detect = Auto detect the proxy server

If you choose to use:

  • fixed_servers = Fixed proxy servers. You can specify further options with ProxyServer and ProxyBypassList.
  • pac_script = A .pac proxy script. Use ProxyPacUrl to set the URL to a proxy .pac file.

For detailed examples, go to https://go.microsoft.com/fwlink/?linkid=2094936.

If you don't configure this policy, users can choose their own proxy settings.

Policy options mapping:

  • ProxyDisabled (direct) = Never use a proxy

  • ProxyAutoDetect (auto_detect) = Auto detect proxy settings

  • ProxyPacScript (pac_script) = Use a .pac proxy script

  • ProxyFixedServers (fixed_servers) = Use fixed proxy servers

  • ProxyUseSystem (system) = Use system proxy settings

Use the preceding information when configuring this policy.

Policy options mapping:

Use this information when configuring this policy.

  • ProxyDisabled (direct) = Never use a proxy
  • ProxyAutoDetect (auto_detect) = Auto detect proxy settings
  • ProxyPacScript (pac_script) = Use a .pac proxy script
  • ProxyFixedServers (fixed_servers) = Use fixed proxy servers
  • ProxyUseSystem (system) = Use system proxy settings

Supported features

  • Can be mandatory: Yes
  • Can be recommended: No
  • Dynamic Policy Refresh: Yes
  • Per Profile: Yes
  • Applies to a profile that is signed in with a Microsoft account: No

Data type

  • String

Windows information and settings

Group Policy (ADMX) info

  • GP unique name: ProxyMode
  • GP name: Configure proxy server settings (deprecated)
  • GP path (Mandatory): Administrative Templates/Microsoft Edge/Proxy server
  • GP path (Recommended): N/A
  • GP ADMX file name: MSEdge.admx

Example value

Never use a proxy

Registry settings

  • Path (Mandatory): SOFTWARE\Policies\Microsoft\Edge
  • Path (Recommended): N/A
  • Value name: ProxyMode
  • Value type: REG_SZ

Example registry value

direct

Mac information and settings

  • Preference Key name: ProxyMode
  • Example value:
<string>direct</string>

See also