Open in the explorer

Set BranchCache Distributed Cache mode

Définir le mode de cache distribué de BranchCache

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 7 or Windows Server 2008 R2* FR: Au minimum Windows 7 ou Windows Server 2008 R2*
ADMX file
PeerToPeerCaching.admx
Internal name
PeerToPeerCaching/EnableWindowsBranchCache_Distributed

Explanation

This policy setting specifies whether BranchCache distributed cache mode is enabled on client computers to which this policy is applied. In addition to this policy, you must use the policy "Turn on BranchCache" to enable BranchCache on client computers.

In distributed cache mode, client computers download content from BranchCache-enabled main office content servers, cache the content locally, and serve the content to other BranchCache distributed cache mode clients in the branch office.

Policy configuration

Select one of the following:

- Not Configured. With this selection, BranchCache 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 enable BranchCache on all client computers, you can specify Not Configured for this domain Group Policy setting, and then configure local computer policy to enable BranchCache on individual client computers. Because the domain Group Policy setting is not configured, it will not over-write the enabled setting that you use on individual client computers where you want to enable BranchCache.

- Enabled. With this selection, BranchCache distributed cache mode is enabled for all client computers where the policy is applied. For example, if this policy is enabled in domain Group Policy, BranchCache distributed cache mode is turned on for all domain member client computers to which the policy is applied.

- Disabled. With this selection, BranchCache distributed cache mode is turned off for all client computers where the policy is applied.

* This policy setting is supported on computers that are running Windows Vista Business, Enterprise, and Ultimate editions with Background Intelligent Transfer Service (BITS) 4.0 installed.

French text from Windows 11 26H2

Ce paramètre de stratégie spécifie si le mode de cache hébergé de BranchCache est activé sur les ordinateurs client auxquels cette stratégie est appliquée. Outre cette stratégie, vous devez utiliser la stratégie « Activer BranchCache » pour activer BranchCache sur les ordinateurs client.

En mode de cache distribué, les ordinateurs client téléchargent le contenu des serveurs de contenu BranchCache du bureau principal, mettent le contenu en cache localement et transmettent le contenu aux autres clients en mode de cache distribué de la filiale.

Configuration de la stratégie

Sélectionnez l’une des valeurs suivantes :

- Non configuré. Avec cette sélection, cette stratégie n’applique pas les paramètres BranchCache aux ordinateurs client. Si les ordinateurs clients sont membres du domaine mais que vous ne voulez pas activer BranchCache sur tous les ordinateurs clients, 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 afin d’activer BranchCache sur des ordinateurs clients individuels. Étant donné que le paramètre de stratégie de groupe de domaine n’est pas configuré, il ne remplace pas le paramètre activé que vous utilisez sur les ordinateurs clients individuels sur lesquels vous souhaitez activer BranchCache.

- Activé. Avec cette sélection, le mode de cache distribué de BranchCache est activé pour tous les ordinateurs client auxquels la stratégie est appliquée. Par exemple, si cette stratégie est activée dans la stratégie de groupe de domaine, le mode de cache distribué de BranchCache est activé pour tous les ordinateurs client membres du domaine auxquels la stratégie est appliquée.

- Désactivé. En sélectionnant cette valeur, le mode de cache distribué de BranchCache est activé pour tous les ordinateurs client auxquels la stratégie est appliquée.

* Ce paramètre de stratégie est pris en charge sur les ordinateurs qui exécutent Windows Vista Professionnel, Entreprise et Édition Intégrale avec BITS (Background Intelligent Transfer Service) 4.0 installé.

Registry

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\PeerDist\CooperativeCaching
Value name
Enable
StateValue written
EnabledREG_DWORD = 1
DisabledREG_DWORD = 0

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_Distributed
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\PeerDist\CooperativeCaching'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'Enable' -Value 1 -Type DWord

Disable

# Disable: PeerToPeerCaching/EnableWindowsBranchCache_Distributed
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\PeerDist\CooperativeCaching'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'Enable' -Value 0 -Type DWord

Revert to "Not configured"

# Revert to "Not configured": PeerToPeerCaching/EnableWindowsBranchCache_Distributed
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\PeerDist\CooperativeCaching'
Remove-ItemProperty -Path $k -Name 'Enable' -ErrorAction SilentlyContinue

Availability