Open in the explorer

Hash Version support for BranchCache

Prise en charge de la version de hachage pour BranchCache

Type
Computer
GPO path
Computer Configuration › Policies › Administrative Templates › Network › Lanman Server FR: Configuration ordinateur › Stratégies › Modèles d'administration › Réseau › Serveur Lanman
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
LanmanServer.admx
Internal name
LanmanServer/Pol_HashSupportVersion

Explanation

This policy setting specifies whether the BranchCache hash generation service supports version 1 (V1) hashes, version 2 (V2) hashes, or both V1 and V2 hashes. Hashes, also called content information, are created based on the data in shared folders where BranchCache is enabled.

If you specify only one version that is supported, content information for that version is the only type that is generated by BranchCache, and it is the only type of content information that can be retrieved by client computers. For example, if you enable support for V1 hashes, BranchCache generates only V1 hashes and client computers can retrieve only V1 hashes.

Policy configuration

Select one of the following:

- Not Configured. With this selection, BranchCache settings are not applied to client computers by this policy setting. In this circumstance, which is the default, both V1 and V2 hash generation and retrieval are supported.

- Enabled. With this selection, the policy setting is applied and the hash version(s) that are specified in "Hash version supported" are generated and retrieved.

- Disabled. With this selection, both V1 and V2 hash generation and retrieval are supported.

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

Hash version supported:

- To support V1 content information only, configure "Hash version supported" with the value of 1.

- To support V2 content information only, configure "Hash version supported" with the value of 2.

- To support both V1 and V2 content information, configure "Hash version supported" with the value of 3.

French text from Windows 11 26H2

Ce paramètre de stratégie spécifie si le service de génération de hachages BranchCache prend en charge les hachages de version 1 (V1), de version 2 (V2) ou de versions 1 et 2. Les hachages, également appelés informations de contenu, sont créés sur la base des données des dossiers partagés sur lesquels BranchCache est activé.

Si vous spécifiez une seule version de hachage prise en charge, les informations de contenu de cette version sont le seul type généré par BranchCache, ainsi que le seul type d’informations de contenu pouvant être récupéré par les ordinateurs clients. Par exemple, si vous activez la prise en charge des hachages V1, BranchCache ne génère que des hachages V1 et les ordinateurs clients ne peuvent récupérer que des hachages V1.

Configuration de la stratégie

Sélectionnez l’une des valeurs suivantes :

- Non configuré. Lorsque cette valeur est sélectionnée, les paramètres BranchCache ne sont pas appliqués sur les ordinateurs clients par ce paramètre de stratégie. Dans ce cas (par défaut), la génération et la récupération de hachages V1 et V2 sont prises en charge.

- Activé. Lorsque cette valeur est sélectionnée, le paramètre de stratégie est appliqué et les versions de hachage qui sont spécifiées dans « Version de hachage prise en charge » sont générées et récupérées.

- Désactivé. Lorsque cette valeur est sélectionnée, la génération et la récupération de hachages V1 et V2 sont prises en charge.

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

Version de hachage prise en charge :

- Pour prendre en charge uniquement les informations de contenu V1, définissez « Version de hachage prise en charge » sur la valeur 1.

- Pour prendre en charge uniquement les informations de contenu V2, définissez « Version de hachage prise en charge » sur la valeur 2.

- Pour prendre en charge les informations de contenu V1 et V2, définissez « Version de hachage prise en charge » sur la valeur 3.

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\LanmanServer
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: LanmanServer/Pol_HashSupportVersion
$k = 'HKLM:\Software\Policies\Microsoft\Windows\LanmanServer'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Hash version supported
# Possible options:
#   Supports V1 hash version only = 1
#   Supports V2 hash version only = 2
#   Supports V1 as well as V2 versions = 3
Set-ItemProperty -Path $k -Name 'HashSupportVersion' -Value 1 -Type DWord

Disable

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

Revert to "Not configured"

# Revert to "Not configured": LanmanServer/Pol_HashSupportVersion
$k = 'HKLM:\Software\Policies\Microsoft\Windows\LanmanServer'
Remove-ItemProperty -Path $k -Name 'HashSupportVersion' -ErrorAction SilentlyContinue

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Hash version supported:Version de hachage prise en charge :Lbl_HashVersionSupportActionComboDrop-down listenumHashSupportVersionREG_DWORD
Required · Default choice (UI): #0
LabelValue
Supports V1 hash version onlyREG_DWORD = 1
Supports V2 hash version onlyREG_DWORD = 2
Supports V1 as well as V2 versionsREG_DWORD = 3

Availability