Share via

DNS Searches (Standard 8 Module Reference)

  • Article

7/8/2014

Review examples of the DNS Search settings in the DNS-Client section of the Embedded Core module in the module catalog.

When running unattended setup for a DNS client, you can configure the DNS servers to search on domain names, but the entries will not be applied in any particular order.

To make sure that the searches are made in the correct order, use the following settings:

  • Use Key in DNSServerSearchOrder to specify the order in which to search the DNS servers.
  • Use Key in DNSSuffixSearchOrder to specify the order in which to search for extended domain names.

Set the Server Search Order

The following example shows how to set the order in which to search the DNS Servers.

<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>

The value for Key can be any alphanumeric string, but it must be unique. In the above example, the servers are identified by their IP Addresses, and the server search order is:

  1. 192.168.1.1
  2. 2001:4898:28:4:213:20ff:fe16:3e96
  3. 172.16.1.12

Set the Domain Search Order Suffix

For DNS clients, adding a suffix lets you extend the ability of DNS search capabilities by extending the search to include short, unqualified computer names in multiple DNS domains. If a DNS query fails, the DNS Client service can append the suffixes to the original name, and then perform DNS queries to the DNS server for these alternate, fully-qualified domain names.

The following example shows how you can specify the order in which to search for the extended domain names.

<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>

The value for Key can be any alphanumeric string, but it must be unique. In the above example, the search order is:

  1. server1.fabrikam.com
  2. fabrikam.com
  3. server2.fabrikam.com

If the suffix search order list is empty or unspecified, the system appends the primary DNS suffix of the computer to the short, unqualified names. Using a DNS query, it attempts to resolve the resulting fully qualified domain name. If this query fails, the system appends any DNS suffix that is configured for a specific network connection and attempts to resolve the fully qualified domain names.

See Also

Reference

DNS-Client