Configure proxy server settings (deprecated)
Explanation
DEPRECATED: This policy is deprecated. It is currently supported but will become obsolete in a future release.
This policy is deprecated and doesn't work in Microsoft Edge version 91. Use 'ProxySettings' (Proxy settings) instead.
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' (Configure address or URL of proxy server) and 'ProxyBypassList' (Configure proxy bypass rules).
* pac_script = A .pac proxy script. Use 'ProxyPacUrl' (Set the proxy .pac file URL) 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.
Example value: direct
Registry
HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\EdgeHKEY_CURRENT_USER\Software\Policies\Microsoft\Edge- Value name
- not defined in the ADMX
Enable / disable values: not defined in the ADMX (see the options below).
PowerShell
PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.
Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.
Computer (HKLM)
Enable
# Enable: msedge/ProxyMode
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Configure proxy server settings
# Possible options:
# Never use a proxy = direct
# Auto detect proxy settings = auto_detect
# Use a .pac proxy script = pac_script
# Use fixed proxy servers = fixed_servers
# Use system proxy settings = system
Set-ItemProperty -Path $k -Name 'ProxyMode' -Value 'direct' -Type StringDisable
# Disable: msedge/ProxyMode
# No value is written in the "Disabled" state (nothing defined in the ADMX)Revert to "Not configured"
# Revert to "Not configured": msedge/ProxyMode
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
Remove-ItemProperty -Path $k -Name 'ProxyMode' -ErrorAction SilentlyContinueUser (HKCU)
Enable
Disable
Revert to "Not configured"
Options (1)
| Label | Control | Registry value | REG type | Constraints / details | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Configure proxy server settingsProxyMode | Drop-down listenum | ProxyMode | REG_SZ |
|
Application
Microsoft Edge (+ Edge Update, WebView2) (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.