Control the mode of DNS-over-HTTPS
Explanation
Control the mode of the DNS-over-HTTPS resolver. This policy only sets the default mode for each query.
The mode can be overridden for special types of queries such as requests to resolve a DNS-over-HTTPS server hostname.
The "off" mode disables DNS-over-HTTPS.
The "automatic" mode sends DNS-over-HTTPS queries first if a DNS-over-HTTPS server is available, and falls back to sending insecure queries on error.
The "secure" mode only sends DNS-over-HTTPS queries and will fail to resolve on error.
If you don't configure this policy for managed devices, DNS-over-HTTPS queries aren't sent. Instead, the browser
may send DNS requests to a resolver associated with the user's system resolver.
This could lead to a less secure or private DNS resolution process, depending on the resolver in use.
Policy options mapping:
* off (off) = Disable DNS-over-HTTPS
* automatic (automatic) = Enable DNS-over-HTTPS with insecure fallback
* secure (secure) = Enable DNS-over-HTTPS without insecure fallback
Use the preceding information when configuring this policy.
Example value: off
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/DnsOverHttpsMode
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Control the mode of DNS-over-HTTPS
# Possible options:
# Disable DNS-over-HTTPS = off
# Enable DNS-over-HTTPS with insecure fallback = automatic
# Enable DNS-over-HTTPS without insecure fallback = secure
Set-ItemProperty -Path $k -Name 'DnsOverHttpsMode' -Value 'off' -Type StringDisable
# Disable: msedge/DnsOverHttpsMode
# No value is written in the "Disabled" state (nothing defined in the ADMX)Revert to "Not configured"
# Revert to "Not configured": msedge/DnsOverHttpsMode
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
Remove-ItemProperty -Path $k -Name 'DnsOverHttpsMode' -ErrorAction SilentlyContinueUser (HKCU)
Enable
Disable
Revert to "Not configured"
Options (1)
| Label | Control | Registry value | REG type | Constraints / details | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Control the mode of DNS-over-HTTPSDnsOverHttpsMode | Drop-down listenum | DnsOverHttpsMode | REG_SZ |
|
Application
Microsoft Edge (+ Edge Update, WebView2) (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.