Connection-specific DNS suffix

ComputerNative Intune settingDNS_Domain

Supported on Windows XP Professional only

25H2 · 1.0

What it does

Specifies a connection-specific DNS suffix. This policy setting supersedes local connection-specific DNS suffixes, and those configured using DHCP. To use this policy setting, click Enabled, and then enter a string value representing the DNS suffix. If you enable this policy setting, the DNS suffix that you enter will be applied to all network connections used by the DNS client. If you disable this policy setting, or if you do not configure this policy setting, the DNS client will use the local or DHCP supplied connection specific DNS suffix, if configured.

What it writes

Hive: HKEY_LOCAL_MACHINE
Registry key: Software\Policies\Microsoft\Windows NT\DNSClient

Why it needs changes for Intune

Policy references a Windows supportedOn definition.
ADMX-INTUNE-WINDOWS-SUPPORTEDON-REFERENCE

In Intune

Native Intune setting: Yes — Policy CSP

./Device/Vendor/MSFT/Policy/Config/ADMX_DnsClient/DNS_DomainADMX_DnsClient on Microsoft LearnADMX-backed: Windows ships this template, so it is set with the template's own values, without an import.Windows builds listed: 10.0.22000, 10.0.19043.1202, 10.0.19042.1202, 10.0.19041.1202.

From Microsoft's Policy CSP DDF files (DDF v2 Files, February 2026), read 18 Oct 2026.

Options

Option	Type	Registry value	Allowed values
DNS suffixRequired	Text	`AdapterDomainName`	Up to 255 characters

Configure and deploy

Choose a state and the option values; the output below is generated from the template for exactly that.

Fix the highlighted options to generate output.

History 5 retained releases

24H2 · 1.030 Sep 2024
- Description … that you enter will be applied to all network connections used by ~~[removed: computers that receive this policy setting.]~~[added: the DNS client.] If you disable this policy setting, or if you do not configure this policy setting, ~~[removed: computers]~~[added: the DNS client] will use the local or DHCP supplied connection specific DNS suffix, if configured.
  Whole description, marked
  Specifies a connection-specific DNS suffix. This policy setting supersedes local connection-specific DNS suffixes, and those configured using DHCP. To use this policy setting, click Enabled, and then enter a string value representing the DNS suffix. If you enable this policy setting, the DNS suffix that you enter will be applied to all network connections used by ~~[removed: computers that receive this policy setting.]~~[added: the DNS client.] If you disable this policy setting, or if you do not configure this policy setting, ~~[removed: computers]~~[added: the DNS client] will use the local or DHCP supplied connection specific DNS suffix, if configured.
22H2 · 1.015 Jul 2024
- Already present in the first release ChangeIntel keeps.

3 later releases left it unchanged.

Template

Internal name: DNS_Domain
Namespace: Microsoft.Policies.DNSClient
Template file: DnsClient.admx
Release: Windows 11 25H2 · 1.0 · file set de4e49983ebd651f…

Definition, editor controls and support

Definition

<policy class="Machine" displayName="$(string.DNS_Domain)" explainText="$(string.DNS_Domain_Help)" key="Software\Policies\Microsoft\Windows NT\DNSClient" name="DNS_Domain" presentation="$(presentation.DNS_Domain)" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
      <parentCategory ref="Microsoft.Policies.DNSClient:DNS_Client" />
      <supportedOn ref="Microsoft.Policies.Windows:SUPPORTED_WindowsXPOnly" />
      <elements>
        <text id="DNS_DomainLabel" required="true" valueName="AdapterDomainName" />
      </elements>
    </policy>

Editor controls

<presentation id="DNS_Domain" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
        <textBox refId="DNS_DomainLabel">
          <label>DNS suffix:</label>
        </textBox>
      </presentation>

Supported platforms and category

Microsoft.Policies.DNSClient:category:DNS_Client
<category displayName="$(string.DNS_Client)" name="DNS_Client" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
      <parentCategory ref="Microsoft.Policies.Windows:Network" />
    </category>
Microsoft.Policies.Windows:category:Network
<category displayName="$(string.Network)" explainText="$(string.Network_Help)" name="Network" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
Microsoft.Policies.Windows:definition:SUPPORTED_WindowsXPOnly
<definition displayName="$(string.SUPPORTED_WindowsXPOnly)" name="SUPPORTED_WindowsXPOnly" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
        <or>
          <reference ref="Microsoft.Policies.Products:MicrosoftWindowsXP" />
        </or>
      </definition>
Microsoft.Policies.Windows:unresolved:Microsoft.Policies.Products:MicrosoftWindowsXP
<unresolved reference="Microsoft.Policies.Products:MicrosoftWindowsXP" />
Microsoft.Policies.DNSClient:category:DNS_Client
<category displayName="$(string.DNS_Client)" name="DNS_Client" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
      <parentCategory ref="Microsoft.Policies.Windows:Network" />
    </category>
<strings><string id="Microsoft.Policies.DNSClient:DNS_Client">DNS Client</string></strings>
Microsoft.Policies.Windows:category:Network
<category displayName="$(string.Network)" explainText="$(string.Network_Help)" name="Network" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
<strings><string id="Microsoft.Policies.Windows:Network">Network</string><string id="Microsoft.Policies.Windows:Network_Help">Allows configuration of components of the operating system used by a client computer to connect to a network. This includes DNS settings and Offline Files.</string></strings>
Microsoft.Policies.Windows:definition:SUPPORTED_WindowsXPOnly
<definition displayName="$(string.SUPPORTED_WindowsXPOnly)" name="SUPPORTED_WindowsXPOnly" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
        <or>
          <reference ref="Microsoft.Policies.Products:MicrosoftWindowsXP" />
        </or>
      </definition>
<strings><string id="Microsoft.Policies.Windows:SUPPORTED_WindowsXPOnly">Windows XP Professional only</string></strings>