Open in the explorer

Configure Client BranchCache Version Support

Configurer la prise en charge de la version BranchCache du client

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 2012, Windows 8 or Windows RT FR: Au minimum Windows Server 2012, Windows 8 ou Windows RT
ADMX file
PeerToPeerCaching.admx
Internal name
PeerToPeerCaching/SetDowngrading

Explanation

This policy setting specifies whether BranchCache-capable client computers operate in a downgraded mode in order to maintain compatibility with previous versions of BranchCache. If client computers do not use the same BranchCache version, cache efficiency might be reduced because client computers that are using different versions of BranchCache might store cache data in incompatible formats.

If you enable this policy setting, all clients use the version of BranchCache that you specify in "Select from the following versions."

If you do not configure this setting, all clients will use the version of BranchCache that matches their operating system.

Policy configuration

Select one of the following:

- Not Configured. With this selection, this policy setting is not applied to client computers, and the clients run the version of BranchCache that is included with their operating system.

- Enabled. With this selection, this policy setting is applied to client computers based on the value of the option setting "Select from the following versions" that you specify.

- Disabled. With this selection, this policy setting is not applied to client computers, and the clients run the version of BranchCache that is included with their operating system.

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

Select from the following versions

- Windows Vista with BITS 4.0 installed, Windows 7, or Windows Server 2008 R2. If you select this version, later versions of Windows run the version of BranchCache that is included in these operating systems rather than later versions of BranchCache.

- Windows 8. If you select this version, Windows 8 will run the version of BranchCache that is included in the operating system.

French text from Windows 11 26H2

Ce paramètre de stratégie indique si les ordinateurs client BranchCache fonctionnent en mode rétrogradé pour assurer la compatibilité avec des versions antérieure de BranchCache. Si les ordinateurs client n’utilisent pas la même version de BranchCache, l’efficacité du cache risque d’être réduite car les ordinateurs client qui utilisent différentes versions de BranchCache risquent de stocker des données de cache dans des formats incompatibles.

Si vous activez ce paramètre de stratégie, tous les clients utilisent la version de BranchCache que vous spécifiez dans l’option « Sélectionner une des versions suivantes ».

Si vous ne configurez pas ce paramètre, tous les clients utiliseront la version de BranchCache qui correspond à leur système d’exploitation.

Configuration de la stratégie

Sélectionnez l’une des valeurs suivantes :

- Non configuré. Avec cette sélection, ce paramètre de stratégie n’est pas appliqué aux ordinateurs client, et les clients exécutent la version de BranchCache fournie avec leur système d’exploitation.

- Activé. Avec cette sélection, ce paramètre de stratégie est appliqué aux ordinateurs client en fonction de la valeur du paramètre de l’option « Sélectionner une des versions suivantes » que vous spécifiez.

- Désactivé. Avec cette sélection, ce paramètre de stratégie n’est pas appliqué aux ordinateurs client, et les clients exécutent la version de BranchCache fournie avec leur système d’exploitation.

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

Sélectionner une des versions suivantes

- Windows Vista avec BITS 4.0 installé, Windows 7 ou Windows Server 2008 R2. Si vous sélectionnez cette version, les versions ultérieures de Windows exécutent la version de BranchCache qui est installée sur ces systèmes d’exploitation, plutôt que les versions ultérieures de BranchCache.

- Windows 8. Si vous sélectionnez cette version, Windows 8 exécute la version de BranchCache qui est incluse dans le système d’exploitation.

Registry

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\PeerDist\Service\Versioning
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/SetDowngrading
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\PeerDist\Service\Versioning'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Select from the following versions
# Possible options:
#   Windows Vista with BITS 4.0 installed, Windows 7, or Windows Server 2008 R2 = 1
#   Windows 8 = 2
Set-ItemProperty -Path $k -Name 'PreferredContentInformationVersion' -Value 1 -Type DWord

Disable

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

Revert to "Not configured"

# Revert to "Not configured": PeerToPeerCaching/SetDowngrading
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\PeerDist\Service\Versioning'
Remove-ItemProperty -Path $k -Name 'PreferredContentInformationVersion' -ErrorAction SilentlyContinue

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Select from the following versions:Sélectionner une des versions suivantes :Downgrading_VersionDrop-down listenumPreferredContentInformationVersionREG_DWORD
Default choice (UI): #0
LabelValue
Windows Vista with BITS 4.0 installed, Windows 7, or Windows Server 2008 R2REG_DWORD = 1
Windows 8REG_DWORD = 2

Availability