DNSDomain specifies the primary Domain Name System (DNS) domain to be searched for the name resolution. The DNS suffix is used by the DNS client for registrations and to assist with resolution if no DNSSuffixSearchOrder is configured.

By default, a global DNSDomain parameter applies to all configured network interfaces. A connection-specific DNS domain name can also be applied if DNSDomain is used on an interface-specific basis. For example, if DNSDomain is specified as a global parameter (x) and as an interface-specific parameter (y), both parameters are used, x first and then y, by the DNS client for that interface.

Values

Domain_name

Specifies the DNS domain. Domain_name is a string with a maximum length of 255 characters.

This string type does not support empty elements. Do not create an empty value for this setting.

Parent Hierarchy

Valid Passes

specialize

Applies To

For the list of the supported Windows® editions and architectures that this component supports, see Microsoft-Windows-DNS-Client.

XML Example

The following XML output shows a DNS domain configuration for Fabrikam.

  Copy Code
   <DNSDomain>fabrikam.com</DNSDomain>
   <DNSSuffixSearchOrder>
	<DomainName wcm:action="add" wcm:keyValue="1">server1.fabrikam.com</DomainName>
	<DomainName wcm:action="add" wcm:keyValue="2">fabrikam.com</DomainName>
   </DNSSuffixSearchOrder>
   <UseDomainNameDevolution>true</UseDomainNameDevolution>
   <Interfaces>
	<Interface wcm:action="add">
		 <Identifier>Local Area Connection</Identifier>
		 <DNSDomain>fabrikam.com</DNSDomain>
		 <DNSServerSearchOrder>
			<IpAddress wcm:action="add" wcm:keyValue="1">192.168.1.1</IpAddress>
			<IpAddress wcm:action="add" wcm:keyValue="2">192.168.1.2</IpAddress>
		 </DNSServerSearchOrder>
		 <EnableAdapterDomainNameRegistration>true</EnableAdapterDomainNameRegistration>
		 <DisableDynamicUpdate>false</DisableDynamicUpdate>
	</Interface>
	<Interface wcm:action="add">
		 <Identifier>Local Area Connection 2</Identifier>
		 <DNSDomain>fabrikam.com</DNSDomain>
		 <DNSServerSearchOrder>
			<IpAddress wcm:action="add" wcm:keyValue="1">192.168.1.1</IpAddress>
			<IpAddress wcm:action="add" wcm:keyValue="2">2001:4898:28:4:213:20ff:fe16:3e96</IpAddress>
		 </DNSServerSearchOrder>
		 <EnableAdapterDomainNameRegistration>true</EnableAdapterDomainNameRegistration>
		<DisableDynamicUpdate>false</DisableDynamicUpdate>
	</Interface>
   </Interfaces>

See Also