DNSSuffixSearchOrder
specifies the suffix search
order for the name resolution.
For DNS clients, you can configure a DNS domain suffix search list that extends or revises DNS search capabilities. By adding suffixes to the list, you can search for short, unqualified computer names in more than one specified DNS domain. Then, if a DNS query fails, the DNS Client service can use this list to append other name suffix endings to your original name and to repeat DNS queries to the DNS server for these alternate, fully qualified domain names.
When the suffix search list is empty or unspecified, the primary DNS suffix of the computer is appended to short, unqualified names, and a DNS query is used to resolve the resulting fully qualified domain name. If this query fails, the computer can try additional queries for alternate fully qualified domain names by appending any connection-specific DNS suffix that is configured for network connections.
When running unattended setup for a DNS client, you can configure a list of suffixes for the DNS Client to search, and a list of DNS servers to use.
However, the entries are not guaranteed to be applied in any particular order.
To ensure that the correct ordering of DNS servers, use Key in DNSServerSearchOrder
and Key in
DNSSuffixSearchOrder
to specify the order in which
each DNS server should be searched. For example,
Copy Code | |
---|---|
<DNSServerSearchOrder> <IpAddress wcm:action="add" wcm:keyValue="2">2001:4898:28:4:213:20ff:fe16:3e96</IpAddress> <IpAddress wcm:action="add" wcm:keyValue="3">172.16.1.12</IpAddress> <IpAddress wcm:action="add" wcm:keyValue="1">192.168.1.1</IpAddress> </DNSServerSearchOrder> |
You can also use the Key setting under
DNSSuffixSearchOrder
element to ensure that suffixes
are searched in a specific order. For example,
Copy Code | |
---|---|
<DNSSuffixSearchOrder> <DomainName wcm:action="add" wcm:keyValue="2">fabrikam.com</DomainName> <DomainName wcm:action="add" wcm:keyValue="3">server2.fabrikam.com</DomainName> <DomainName wcm:action="add" wcm:keyValue="1">server1.fabrikam.com</DomainName> </DNSSuffixSearchOrder> |
For both of these examples, the value for Key in DNSServerSearchOrder
and Key in
DNSSuffixSearchOrder
indicates the order in which the
DNS servers are searched. In this example, the server search order
list is:
- 192.168.1.1
- 2001:4898:28:4:213:20ff:fe16:3e96
- 172.16.1.12
The suffix search order is:
- server1.fabrikam.com
- fabrikam.com
- server2.fabrikam.com
The value for Key in DNSServerSearchOrder
and Key in
DNSSuffixSearchOrder
must be unique, and can be set to
any alphanumeric character. If the value is numeric (contains
numbers only) these will be applied to order the list of IpAddress within
DNSServerSearchOrder.
Child Elements
Specifies a domain name. |
Parent Hierarchy
Microsoft-Windows-DNS-Client | DNSSuffixSearchOrder
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> |