Open in the explorer

Configure BranchCache for network files

Configurer BranchCache pour les fichiers réseau

Type
Computer
GPO path
Computer Configuration › Policies › Administrative Templates › Network › BranchCache FR: Configuration ordinateur › Stratégies › Modèles d'administration › Réseau › BranchCache
Supported on
At least Windows Server 2008 R2 or Windows 7 FR: Au minimum Windows Server 2008 R2 ou Windows 7
ADMX file
PeerToPeerCaching.admx
Internal name
PeerToPeerCaching/EnableWindowsBranchCache_SMB

Explanation

This policy setting is used only when you have deployed one or more BranchCache-enabled file servers at your main office. This policy setting specifies when client computers in branch offices start caching content from file servers based on the network latency - or delay - that occurs when the clients download content from the main office over a Wide Area Network (WAN) link. When you configure a value for this setting, which is the maximum round trip network latency allowed before caching begins, clients do not cache content until the network latency reaches the specified value; when network latency is greater than the value, clients begin caching content after they receive it from the file servers.

Policy configuration

Select one of the following:

- Not Configured. With this selection, BranchCache latency settings are not applied to client computers by this policy. In the circumstance where client computers are domain members but you do not want to configure a BranchCache latency setting on all client computers, you can specify Not Configured for this domain Group Policy setting, and then configure local computer policy to enable BranchCache latency settings on individual client computers. Because the domain Group Policy setting is not configured, it will not over-write the latency setting that you use on individual client computers.

- Enabled. With this selection, the BranchCache maximum round trip latency setting is enabled for all client computers where the policy is applied. For example, if Configure BranchCache for network files is enabled in domain Group Policy, the BranchCache latency setting that you specify in the policy is turned on for all domain member client computers to which the policy is applied.

- Disabled. With this selection, BranchCache client computers use the default latency setting of 80 milliseconds.

In circumstances where this policy setting is enabled, you can also select and configure the following option:

- Type the maximum round trip network latency (milliseconds) after which caching begins. Specifies the amount of time, in milliseconds, after which BranchCache client computers begin to cache content locally.

French text from Windows 11 26H2

Ce paramètre de stratégie n’est utilisé que si vous avez déployé un ou plusieurs serveurs de fichiers BranchCache dans votre bureau principal. Ce paramètre de stratégie spécifie quand les ordinateurs client des bureaux principaux commencent à mettre en cache le contenu de serveurs de fichiers en fonction du temps de réponse du réseau, ou du retard, résultant du téléchargement par les clients de contenu provenant du bureau principal via un lien de réseau étendu. Lorsque vous configurez une valeur pour ce paramètre qui représente le temps de réponse maximum du réseau aller-retour autorisé avant que la mise en cache ne commence, les clients ne mettent en cache le contenu que lorsque le temps de réponse du réseau a atteint la valeur spécifiée. Lorsqu’il est supérieur à cette valeur, les clients commencent à mettre en cache le contenu une fois qu’il a été transmis par les serveurs de fichiers et reçu.

Configuration de la stratégie

Sélectionnez l’une des valeurs suivantes :

- Non configuré. Avec cette sélection, les paramètres de latence BranchCache ne sont pas appliqués sur les ordinateurs client par cette stratégie. Si les ordinateurs client sont membres du domaine, mais que vous ne voulez pas configurer de paramètre de latence BranchCache sur tous les ordinateurs client, vous pouvez spécifier Non configuré pour ce paramètre de stratégie de groupe du domaine, puis configurer la stratégie de l’ordinateur local pour activer les paramètres de latence BranchCache sur des ordinateurs client individuels. Puisque le paramètre de stratégie de groupe de domaine n’est pas configuré, il ne remplace pas le paramètre de latence que vous utilisez sur des ordinateurs client individuels.

- Activé. En sélectionnant cette valeur, le paramètre de latence aller-retour maximum est activé pour tous les ordinateurs client auxquels la stratégie est appliquée. Par exemple, si l’option Configurer BranchCache pour les fichiers réseau est activée dans la stratégie de groupe du domaine, le paramètre de latence BranchCache que vous spécifiez dans la stratégie est activé pour tous les ordinateurs client membres du domaine auxquels la stratégie est appliquée.

- Désactivé. Avec cette sélection, les ordinateurs client BranchCache utilisent le paramètre de latence par défaut équivalent à 80 millisecondes.

Lorsque ce paramètre de stratégie est activé, vous pouvez également sélectionner et configurer l’option suivante :

- Entrer le temps de réponse maximum du réseau aller-retour (millisecondes) avant que la mise en cache ne commence. Indique la durée, en millisecondes, après laquelle les ordinateurs client BranchCache commencent à mettre en cache le contenu localement.

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\NetCache
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: PeerToPeerCaching/EnableWindowsBranchCache_SMB
$k = 'HKLM:\Software\Policies\Microsoft\Windows\NetCache'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
#
Set-ItemProperty -Path $k -Name 'PeerCachingLatencyThreshold' -Value 80 -Type DWord  # maximum 100000000

Disable

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

Revert to "Not configured"

# Revert to "Not configured": PeerToPeerCaching/EnableWindowsBranchCache_SMB
$k = 'HKLM:\Software\Policies\Microsoft\Windows\NetCache'
Remove-ItemProperty -Path $k -Name 'PeerCachingLatencyThreshold' -ErrorAction SilentlyContinue

Options (1)

LabelControlRegistry valueREG typeConstraints / details
WBC_SMBLatency_DecimalTextBoxNumeric boxdecimalPeerCachingLatencyThresholdREG_DWORD
Max: 100000000 · Default (UI): 80

Availability