Open in the explorer

Use initial DC discovery retry setting for background callers

Utiliser le paramètre Tentatives de découverte de contrôleur de domaine initial pour les appelants en arrière plan

Type
Computer
GPO path
Computer Configuration › Policies › Administrative Templates › System › Net Logon FR: Configuration ordinateur › Stratégies › Modèles d'administration › Système › Net Logon
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
Netlogon.admx
Internal name
Netlogon/Netlogon_BackgroundRetryInitialPeriod

Explanation

This policy setting determines the amount of time (in seconds) to wait before the first retry for applications that perform periodic searches for domain controllers (DC) that are unable to find a DC.

The default value for this setting is 10 minutes (10*60). The maximum value for this setting is 49 days (0x49*24*60*60=4233600). The minimum value for this setting is 0.

This setting is relevant only to those callers of DsGetDcName that have specified the DS_BACKGROUND_ONLY flag.

If the value of this setting is less than the value specified in the NegativeCachePeriod subkey, the value in the NegativeCachePeriod subkey is used.

Warning: If the value for this setting is too large, a client will not attempt to find any DCs that were initially unavailable. If the value set in this setting is very small and the DC is not available, the traffic caused by periodic DC discoveries may be excessive.

French text from Windows 11 26H2

Ce paramètre de stratégie détermine le délai d’attente (en secondes) avant la première nouvelle tentative pour les applications qui effectuent des recherches périodiques de contrôleurs de domaine incapables de trouver un contrôleur de domaine.

La valeur par défaut pour ce paramètre est 10 minutes (10*60). La valeur maximale pour ce paramètre est 49 jours (0x49*24*60*60=4 233 600). La valeur minimale pour ce paramètre est 0.

Ce paramètre ne concerne que les appelants de DsGetDcName qui ont spécifié l’indicateur DS_BACKGROUND_ONLY.

Si la valeur de ce paramètre est inférieure à la valeur spécifiée dans la sous-clé NegativeCachePeriod, la valeur de la sous-clé NegativeCachePeriod est utilisée.

Avertissement : si la valeur pour ce paramètre est trop importante, le client ne tente pas de trouver des contrôleurs de domaine qui étaient initialement indisponibles. Si la valeur pour ce paramètre est trop faible et que le contrôleur de domaine n’est pas disponible, le trafic provoqué par les découvertes périodiques des contrôleurs de domaine risque d’être excessif.

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Netlogon\Parameters
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: Netlogon/Netlogon_BackgroundRetryInitialPeriod
$k = 'HKLM:\Software\Policies\Microsoft\Netlogon\Parameters'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Seconds
Set-ItemProperty -Path $k -Name 'BackgroundRetryInitialPeriod' -Value 600 -Type DWord  # maximum 4233600

Disable

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

Revert to "Not configured"

# Revert to "Not configured": Netlogon/Netlogon_BackgroundRetryInitialPeriod
$k = 'HKLM:\Software\Policies\Microsoft\Netlogon\Parameters'
Remove-ItemProperty -Path $k -Name 'BackgroundRetryInitialPeriod' -ErrorAction SilentlyContinue

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Seconds:Secondes :Netlogon_BackgroundRetryInitialPeriodLabelNumeric boxdecimalBackgroundRetryInitialPeriodREG_DWORD
Max: 4233600 · Default (UI): 600

Availability