Open in the explorer

Specify positive periodic DC Cache refresh for non-background callers

Spécifier l’intervalle d’actualisation du cache de contrôleur de domaine périodique positif pour les appelants non 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_NonBackgroundSuccessfulRefreshPeriod

Explanation

This policy setting determines when a successful DC cache entry is refreshed. This policy setting is applied to caller programs that do not periodically attempt to locate DCs, and it is applied before the returning the DC information to the caller program. This policy setting is relevant to only those callers of DsGetDcName that have not specified the DS_BACKGROUND_ONLY flag.

The default value for this setting is 30 minutes (1800). The maximum value for this setting is (4294967200), while the maximum that is not treated as infinity is 49 days (49*24*60*60=4233600). Any larger value will be treated as infinity. The minimum value for this setting is to always refresh (0).

French text from Windows 11 26H2

Ce paramètre de stratégie détermine lorsqu’une entrée de cache réussie de contrôleur de domaine est actualisée. Ce paramètre de stratégie est appliqué aux programmes appelants qui ne tentent pas périodiquement de localiser des contrôleurs de domaine ; il est appliqué avant de retourner les informations de contrôleur de domaine au programme appelant. Ce paramètre de stratégie ne concerne que les appelants de DsGetDcName qui n’ont pas spécifié l’indicateur DS_BACKGROUND_ONLY.

La valeur par défaut pour ce paramètre est 30 minutes (1 800). La valeur maximale pour ce paramètre est (4 294 967 200), tandis que le maximum qui n’est pas considéré comme étant infini est 49 jours (49*24*60*60=4 233 600). Toute valeur supérieure sera considérée comme étant infinie. La valeur minimale pour ce paramètre est de toujours actualiser (0).

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_NonBackgroundSuccessfulRefreshPeriod
$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 'NonBackgroundSuccessfulRefreshPeriod' -Value 1800 -Type DWord  # maximum 4294967200

Disable

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

Revert to "Not configured"

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

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Seconds:Secondes :Netlogon_NonBackgroundSuccessfulRefreshPeriodLabelNumeric boxdecimalNonBackgroundSuccessfulRefreshPeriodREG_DWORD
Max: 4294967200 · Default (UI): 1800

Availability