1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

[GSA: Internet] Configuring the Required DoH Disablement Prerequisite

1
Last updated at Posted at 2026-02-11

Click here for the Japanese version of this article.

Introduction

To use the Internet Access feature of Microsoft Entra Global Secure Access (GSA), all required prerequisites must be configured.

This article covers a subset of the prerequisites explained in the following article:

[GSA: Internet] How to Meet All Prerequisites for Internet Access
https://qiita.com/carol0226/items/29197f33c6537cd2b0e5

Scope of This Article

Among the prerequisites listed below, this article focuses specifically on the items highlighted in red, which require disabling DoH (DNS over HTTPS).

Public documentation: Prerequisites
https://learn.microsoft.com/en-us/entra/global-secure-access/how-to-configure-web-content-filtering?wt.mc_id=MVP_407731#prerequisites

(Excerpt from the documentation)
image.png

Important Notice
As explained in the article below, Windows Server 2025 will support DoH (DNS over HTTPS) in DNS Server starting from the February 2026 update.

However, GSA does not support DoH at this time, so DoH must be disabled when using GSA.
Since GSA may add DoH support in the future, please make sure to check the latest information on Microsoft Learn. I will also update this article as soon as I confirm any changes.

Networking Blog: Secure DNS with DoH: Public Preview for Windows DNS Server
https://techcommunity.microsoft.com/blog/networkingblog/secure-dns-with-doh-public-preview-for-windows-dns-server/4493935

Configure the DNS Client to Disable DoH

To tunnel Internet network traffic via GSA, Secure DNS (DNS over HTTPS) must be disabled.
Traffic Forwarding Profiles rely on FQDN‑based rules, which require traditional DNS lookups rather than encrypted DNS.

Public documentation: DNS over HTTPS is not supported
https://learn.microsoft.com/en-us/entra/global-secure-access/troubleshoot-global-secure-access-client-diagnostics-health-check?wt.mc_id=MVP_407731#dns-over-https-not-supported

(Excerpt)
image.png

This article explains three different ways to disable DoH:

  • 1. Disable DoH directly on client PCs
  • 2. Disable DoH via Group Policy (GPO)
  • 3. Disable DoH via Intune

1. Disable DoH on Client PCs

Both command-line and GUI methods are shown below.

Disable DoH via Command Line

  • Check current configuration:
    netsh dnsclient show global
  • Disable DoH:
    netsh dnsclient set global doh=no dot=no

image.png

Public documentation: netsh dnsclient
https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/netsh-dnsclient?wt.mc_id=MVP_407731

Disable DoH via GUI

On my PC (Windows 11 24H2), the UI differed from the documentation—but simply switching the toggle Off disables DNS encryption.
However, note that GUI settings cannot be configured when DHCP is used.
Using the command line is therefore more reliable.

UI shown in the public documentation
If you see the UI below, choose Unencrypted only:

Public documentation: Configure DNS clients to support DoH
https://learn.microsoft.com/en-us/windows-server/networking/dns/doh-client-support?wt.mc_id=MVP_407731#configure-the-dns-client-to-support-doh

Reference
After applying the settings, it is correct if “(Unencrypted)” is displayed to the right of the DNS server address in the screen below.
image.png


2. Disable DoH via Group Policy (GPO)

This section tends to be challenging due to version‑specific differences in ADMX templates.
The public documentation refers to the following settings:

Public documentation: Configure DoH using Group Policy
https://learn.microsoft.com/en-us/windows-server/networking/dns/doh-client-support?wt.mc_id=MVP_407731#configuring-doh-through-group-policy

Naming differences by Windows version

The names shown in the documentation—

  • English: Configure DNS over HTTPS (DoH) name resolution
  • Japanese: HTTPS (DoH) の名前解決ポリシー経由の DNS の構成

—did not appear on Windows Server 2022 21H2 or Windows Server 2025 24H2.

This indicates that the public documentation may not reflect the latest Windows builds.

Based on investigation:

Version English Japanese
24H2+ Configure encrypted name resolution 暗号化された名前解決の構成
21H2–23H2 Configure DNS over HTTPS (DoH) name resolution HTTPS(DoH)の名前解決による DNS を構成する

Download and Deploy ADMX Templates

To configure DoH settings, download the Windows 11 23H2 Administrative Templates and place them in the PolicyDefinitions folder on your domain controller.

Public documentation: Create and manage a Central Store for ADMX templates
https://learn.microsoft.com/en-us/troubleshoot/windows-client/group-policy/create-and-manage-central-store?wt.mc_id=MVP_407731

Why these templates are required?
You can confirm this by examining the spreadsheet linked in the documentation and comparing dnsclient.admx across versions.

image.png

Configuration Steps

After importing the correct ADMX templates, you will see the expected policy settings:

Extract from the Help text:

Specifies whether the DNS client performs name resolution using DNS over HTTPS (DoH).

Default: classic DNS (UDP or TCP).

Options:

  • Prohibit DoH – DoH name resolution is not performed.
  • Allow DoH – Use DoH when supported by the configured DNS server.
  • Require DoH – Only DoH is permitted; classic DNS fails if DoH is unavailable.

Verification

Before applying GPO: DoH/DoT = enabled
After applying GPO: DoH/DoT = disabled

image.png

Note for 24H2 Templates
Applying 23H2 template settings and later switching to 24H2 templates shows the following configuration:


3. Disable DoH via Intune

I tested many methods in Intune, and the most reliable approach is using a Detection Script + Remediation Script (formerly called Proactive Remediations).

Methods tested (but not viable):

  • Configuration Profiles → Settings Catalog → DNS Client → No DoH settings
  • Configuration Profiles → Templates → Administrative Templates → Deprecated
  • ADMX Import → Fails with 0x20101
  • CSP → No DoH CSP exists

Because Windows may revert DNS settings automatically, a remediation approach that continuously enforces the setting is recommended.

Disable DoH Using Detection & Remediation Scripts

We will use Intune’s Remediations feature:

Public documentation: Use Remediations
https://learn.microsoft.com/en-us/intune/intune-service/fundamentals/remediations?wt.mc_id=MVP_407731


Step 1: Create Two Script Files

1) Detection Script — Detect-DoH.ps1

# Detect-DoH.ps1

# Get current DoH configuration

$doh = (netsh dnsclient show global | Select-String "DoH").ToString()

# Evaluate DoH status
if ($doh -match "disabled") {
    exit 0   # No remediation needed
} else {
    exit 1   # Remediation required
}

Save with UTF‑8 encoding.
image.png

2) Remediation Script — Remediate-DoH.ps1

# Remediate-DoH.ps1

# Disable DoH and DoT
netsh dnsclient set global doh=no dot=no

Start-Sleep -Seconds 1

exit 0

Save with UTF‑8 encoding.
image.png

Step 2: Create a Remediation in Intune

Navigate to
Devices → Device Management → Scripts and Remediations → + Create.
image.png

Enter any name.
image.png

Upload detection/remediation scripts.
image.png

Skip scope tags.

Assign to a device group and configure schedule
—for example: Frequency: Hourly / Interval: 1.
image.png

Review and create the remediation.
image.png

The remediation now appears in the list.
image.png

Verification

A device with DoH enabled transitions from Issue detected → Issue resolved after remediation runs:
image.png


Reference 1

Thanks to Kunii-san’s article for guiding detection/remediation approach:

Always on the clock: Troubleshooting Intune Scripts & Remediations
https://azuread.net/archives/15219


Reference 2

(Details of unsuccessful ADMX-upload attempts for archival purposes)

ADMX Upload Method (Not Supported for DoH)

This method does not work for configuring DoH via Intune.
Still useful for understanding ADMX upload behavior.

Win32 and Desktop Bridge app ADMX policy Ingestion
https://learn.microsoft.com/en-us/windows/client-management/win32-and-centennial-app-policy-configuration?wt.mc_id=MVP_407731

Upload Custom Administrative Templates and Deploy Them via Intune

Upload the windows.admx and DnsClient.admx files located in the C:\Windows\PolicyDefinitions folder downloaded in section 1-2, along with the corresponding windows.adml and DnsClient.adml files under the en-us subfolder, to Intune as custom administrative templates.
Since there are several potential pitfalls in this process, it is recommended to follow the step-by-step guidance below to avoid common issues.

Public documentation: Import custom ADMX and ADML administrative templates into Microsoft Intune
https://learn.microsoft.com/en-us/intune/intune-service/configuration/administrative-templates-import-custom?wt.mc_id=MVP_407731

Public documentation: DnsClient.admx
https://learn.microsoft.com/en-us/previous-versions/managed-desktop/references/windows-11-policy-settings?wt.mc_id=MVP_407731#dnsclientadmx


Overview of Intune Configuration Steps (Pitfall Avoidance Guide)

  1. In the Import ADMX section, click + Import, as shown below.
    image.png

  2. First, upload Windows.admx and Windows.adml.
    (The upload process may take a significant amount of time—for reference, it took around 60 minutes in my environment.)
    image.png

  3. Next, upload DnsClient.admx and DnsClient.adml.
    (This may also take considerable time—approximately 60 minutes in my environment.)
    image.png

  4. If the files appear as shown below, the upload is complete.
    image.png

    Note: The file name appears as DnsClient2.admx because of the workaround described later.
    The one‑week timestamp difference hints at how much trouble this caused.


Important Note ①

As stated in the public documentation, ADMX files have dependency requirements.
Reviewing the dependencies of DnsClient.admx shows that it depends on Windows.admx.
Additionally, as of 2025/11/9, only the English version of ADML files is supported, so you must upload the en-us versions.

image.png

Public documentation: What you need to know
https://learn.microsoft.com/en-us/intune/intune-service/configuration/administrative-templates-import-custom?wt.mc_id=MVP_407731#what-you-need-to-know


Important Note ②

In my environment, I initially uploaded DnsClient.admx without knowing about the dependency on Windows.admx.
This caused a dependency error.
After deleting it and successfully uploading Windows.admx, I attempted to upload DnsClient.admx again—only to encounter the following error:

image.png

Error message:

Failed to upload this ADMX file. To proceed, delete this upload, review the error details, and try again.
Value cannot be null. Parameter name: input

With no obvious solution, I consulted Copilot, which suggested renaming the files.
After renaming them to DnsClient2.admx and DnsClient2.adml, the upload succeeded.

image.png


image.png

image.png

image.png

image.png

image.png

image.png

image.png


In my environment, the following error appeared, although the policy itself was saved correctly:

image.png

image.png


Important Note

When I reopened the policy, the saved value was incorrect.
After adjusting the value and saving it again, the correct configuration was applied.
Please make sure to verify this on your end.

As shown below, the setting was mistakenly saved as Allow DoH, so be sure to change it to Prohibit DoH and save again.

image.png

Conclusion

Even with correct ADMX imports and policies, deployment consistently fails.
Global research shows zero successful cases of configuring DoH via ADMX templates in Intune.
image.png

image.png

Therefore, the Detection Script + Remediation Script method is currently the only reliable method for enforcing DoH disablement using Intune.

1
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?