Edit

Share via

DnsOverHttpsTemplates

  • Article

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 cannot be empty.

If you set DnsOverHttpsMode to "automatic" and this policy is set then the URI templates specified will be used. If you don't set this policy, then hardcoded mappings will be 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 will use GET; otherwise requests will 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