DnsOverHttpsTemplates

Specify URI template of desired DNS-over-HTTPS resolver

Supported versions

• On Windows and macOS since 83 or later

Description

The URI template of the desired DNS-over-HTTPS resolver. To specify multiple DNS-over-HTTPS resolvers, separate the corresponding URI templates with spaces.

If you set DnsOverHttpsMode to "secure", then this policy must be set and can't be empty.

If you set DnsOverHttpsMode to "automatic" and this policy is set, then the URI templates specified are used. If you don't set this policy, then hardcoded mappings are used to attempt to upgrade the user's current DNS resolver to a DoH resolver operated by the same provider.

If the URI template contains a dns variable, requests to the resolver use GET; otherwise, requests use POST.

Incorrectly formatted templates will be ignored.

Supported features

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

Data type

• String

Windows information and settings

Group Policy (ADMX) info

• GP unique name: DnsOverHttpsTemplates
• GP name: Specify URI template of desired DNS-over-HTTPS resolver
• GP path (Mandatory): Administrative Templates/Microsoft Edge
• GP path (Recommended): N/A
• GP ADMX file name: MSEdge.admx

Example value

https://dns.example.net/dns-query{?dns}

Registry settings

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

Example registry value

https://dns.example.net/dns-query{?dns}

Mac information and settings

• Preference Key name: DnsOverHttpsTemplates
• Example value:

<string>https://dns.example.net/dns-query{?dns}</string>

See also

• Microsoft Edge - Policies