Open in the explorer

DNS suffix search list

Liste de recherche de suffixes DNS

Type
Computer
GPO path
Computer Configuration › Policies › Administrative Templates › Network › DNS Client FR: Configuration ordinateur › Stratégies › Modèles d'administration › Réseau › Client DNS
Supported on
At least Windows Server 2003 operating systems or Windows XP Professional FR: Au minimum Windows Server 2003 ou Windows XP Professionnel
ADMX file
DnsClient.admx
Internal name
DnsClient/DNS_SearchList

Explanation

Specifies the DNS suffixes to attach to an unqualified single-label name before submission of a DNS query for that name.

An unqualified single-label name contains no dots. The name "example" is a single-label name. This is different from a fully qualified domain name such as "example.microsoft.com."

DNS clients that receive this policy setting will attach one or more suffixes to DNS queries for a single-label name. For example, a DNS query for the single-label name "example" will be modified to "example.microsoft.com" before sending the query to a DNS server if this policy setting is enabled with a suffix of "microsoft.com."

To use this policy setting, click Enabled, and then enter a string value representing the DNS suffixes that should be appended to single-label names. You must specify at least one suffix. Use a comma-delimited string, such as "microsoft.com,serverua.microsoft.com,office.microsoft.com" to specify multiple suffixes.

If you enable this policy setting, one DNS suffix is attached at a time for each query. If a query is unsuccessful, a new DNS suffix is added in place of the failed suffix, and this new query is submitted. The values are used in the order they appear in the string, starting with the leftmost value and proceeding to the right until a query is successful or all suffixes are tried.

If you disable this policy setting, or if you do not configure this policy setting, the primary DNS suffix and network connection-specific DNS suffixes are appended to the unqualified queries.

French text from Windows 11 26H2

Spécifie les suffixes DNS à attacher à un nom non qualifié à étiquette unique avant la soumission d'une requête DNS pour ce nom.

Un nom d’étiquette non-qualifié en une seule partie non complet ne contient pas de points, , comme le nom « exemple ». Il est différent d’un nom de domaine complet, tel que « exemple.microsoft.com ».

Les ordinateurs clients qui reçoivent ce paramètre de stratégie attachent un ou plusieurs suffixes aux requêtes DNS pour un nom en une seule partie. Par exemple, une requête DNS pour le nom en une seule partie « exemple » est modifiée en « exemple.microsoft.com » avant son envoi à un serveur DNS si ce paramètre de stratégie est activé avec le suffixe « microsoft.com ».

Pour utiliser ce paramètre de stratégie, cliquez sur Activer, puis entrez une valeur de chaîne représentant les suffixes DNS qui doivent être ajoutés aux noms en une seule partie. Vous devez spécifier au moins un suffixe.

Si vous utilisez une chaîne délimitée par des virgules, comme « microsoft.com,serverua.microsoft.com,office.microsoft.com » pour spécifier plusieurs suffixes.

Si vous désactivez ce paramètre de stratégie, un seul suffixe DNS est attaché à la fois pour chaque requête. Si une requête ne réussit pas, un nouveau suffixe DNS est ajouté à la place du suffixe en erreur et cette nouvelle requête est soumise. Les valeurs sont utilisées dans leur ordre d’apparition dans la chaîne, en commençant par la valeur la plus à gauche et en continuant vers la droite jusqu’à ce qu’une requête réussisse ou que tous les suffixes aient été essayés. Si vous désactivez ce paramètre de stratégie ou ne le configurez pas, le suffixe DNS principal et les suffixes DNS spécifiques à la connexion réseau sont ajoutés aux requêtes non qualifiées.

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows NT\DNSClient
Value name
not defined in the ADMX

Enable / disable values: not defined in the ADMX (see the options below).

PowerShell

PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.

Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.

Enable

# Enable: DnsClient/DNS_SearchList
$k = 'HKLM:\Software\Policies\Microsoft\Windows NT\DNSClient'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# DNS Suffixes
Set-ItemProperty -Path $k -Name 'SearchList' -Value '<value>' -Type String

Disable

# Disable: DnsClient/DNS_SearchList
# No value is written in the "Disabled" state (nothing defined in the ADMX)

Revert to "Not configured"

# Revert to "Not configured": DnsClient/DNS_SearchList
$k = 'HKLM:\Software\Policies\Microsoft\Windows NT\DNSClient'
Remove-ItemProperty -Path $k -Name 'SearchList' -ErrorAction SilentlyContinue

Options (1)

LabelControlRegistry valueREG typeConstraints / details
DNS Suffixes:Suffixes DNS :DNS_SearchListLabelText boxtextSearchListREG_SZ
Required

Availability