Open in the explorer

Hash Publication for BranchCache

Publication de hachages 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 2008 R2 or Windows 7 FR: Au minimum Windows Server 2008 R2 ou Windows 7
ADMX file
LanmanServer.admx
Internal name
LanmanServer/Pol_HashPublication

Explanation

This policy setting specifies whether a hash generation service generates hashes, also called content information, for data that is stored in shared folders. This policy setting must be applied to server computers that have the File Services role and both the File Server and the BranchCache for Network Files role services installed.

Policy configuration

Select one of the following:

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

- Enabled. With this selection, hash publication is turned on for all file servers where Group Policy is applied. For example, if Hash Publication for BranchCache is enabled in domain Group Policy, hash publication is turned on for all domain member file servers to which the policy is applied. The file servers are then able to create content information for all content that is stored in BranchCache-enabled file shares.

- Disabled. With this selection, hash publication is turned off for all file servers where Group Policy is applied.

In circumstances where this policy setting is enabled, you can also select the following configuration options:

- Allow hash publication for all shared folders. With this option, BranchCache generates content information for all content in all shares on the file server.

- Allow hash publication only for shared folders on which BranchCache is enabled. With this option, content information is generated only for shared folders on which BranchCache is enabled. If you use this setting, you must enable BranchCache for individual shares in Share and Storage Management on the file server.

- Disallow hash publication on all shared folders. With this option, BranchCache does not generate content information for any shares on the computer and does not send content information to client computers that request content.

French text from Windows 11 26H2

Ce paramètre de stratégie spécifie si un service de génération de hachages génère des hachages, également appelés informations de contenu, pour les données qui sont stockées dans des dossiers partagés. Ce paramètre de stratégie doit être appliqué aux ordinateurs serveur sur lesquels le rôle Services de fichiers, ainsi que les deux services de rôle Serveur de fichiers et BranchCache pour fichiers réseau sont installés.

Configuration de la stratégie

Sélectionnez l’une des valeurs suivantes :

- Non configuré. Lorsque cette valeur est sélectionné, les paramètres de publication de hachages ne sont pas appliqués aux serveurs de fichiers. Si les serveurs de fichiers sont membres du domaine mais que vous ne voulez pas activer BranchCache sur tous les serveurs de fichiers, 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 serveurs de fichiers 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 serveurs individuels sur lesquels vous voulez activer BranchCache.

- Activé. Lorsque cette valeur est sélectionnée, la publication de hachages est activée pour tous les serveurs de fichiers sur lesquels la stratégie de groupe est appliquée. Par exemple, si Publication de hachages pour BranchCache est activé dans la stratégie de groupe du domaine, la publication de hachages est activée pour tous les serveurs de fichiers qui sont membres du domaine et auxquels cette stratégie est appliquée. Les serveurs de fichiers peuvent ensuite créer des informations de contenu pour tout le contenu qui est stocké dans les partages de fichiers sur lesquels BranchCache est activé.

- Désactivé. Lorsque cette valeur est sélectionnée, la publication de hachages est désactivée pour tous les serveurs de fichiers sur lesquels la stratégie de groupe est appliquée.

Lorsque ce paramètre de stratégie est appliqué, vous pouvez également sélectionner les options de configuration suivantes :

- Autoriser la publication de hachages pour tous les dossiers partagés. Avec cette option, BranchCache génère des informations de contenu pour tout le contenu de tous les partages du serveur de fichiers.

- Autoriser la publication de hachages uniquement pour les dossiers partagés sur lesquels BranchCache est activé. Avec cette option, les informations de contenu sont générées uniquement pour les dossiers partagés sur lesquels BranchCache est activé. Si vous utilisez ce paramètre, vous devez activer BranchCache pour tous les partages individuels dans Gestion du stockage et du partage sur le serveur de fichiers.

- N’autoriser la publication de hachages dans aucun dossier partagé. Avec cette option, BranchCache ne génère d’informations de contenu pour aucun des partages de l’ordinateur et n’envoie aucune information de contenu aux ordinateurs clients qui demandent du contenu.

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_HashPublication
$k = 'HKLM:\Software\Policies\Microsoft\Windows\LanmanServer'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Hash publication actions
# Possible options:
#   Allow hash publication only for shared folders on which BranchCache is enabled = 0
#   Disallow hash publication on all shared folders = 1
#   Allow hash publication for all shared folders = 2
Set-ItemProperty -Path $k -Name 'HashPublicationForPeerCaching' -Value 0 -Type DWord

Disable

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

Revert to "Not configured"

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

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Hash publication actions:Actions de la publication de hachages :Lbl_HashPublicationActionComboDrop-down listenumHashPublicationForPeerCachingREG_DWORD
Required · Default choice (UI): #0
LabelValue
Allow hash publication only for shared folders on which BranchCache is enabledREG_DWORD = 0
Disallow hash publication on all shared foldersREG_DWORD = 1
Allow hash publication for all shared foldersREG_DWORD = 2

Availability