Open in the explorer

Enable Automatic Hosted Cache Discovery by Service Connection Point

Activer la découverte automatique du cache hébergé par le point de connexion de service

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/EnableWindowsBranchCache_HostedCacheDiscovery

Explanation

This policy setting specifies whether client computers should attempt the automatic configuration of hosted cache mode by searching for hosted cache servers publishing service connection points that are associated with the client's current Active Directory site. If you enable this policy setting, client computers to which the policy setting is applied search for hosted cache servers using Active Directory, and will prefer both these servers and hosted cache mode rather than manual BranchCache configuration or BranchCache configuration by other group policies.

If you enable this policy setting in addition to the "Turn on BranchCache" policy setting, BranchCache clients attempt to discover hosted cache servers in the local branch office. If client computers detect hosted cache servers, hosted cache mode is turned on. If they do not detect hosted cache servers, hosted cache mode is not turned on, and the client uses any other configuration that is specified manually or by Group Policy.

When this policy setting is applied, the client computer performs or does not perform automatic hosted cache server discovery under the following circumstances:

If no other BranchCache mode-based policy settings are applied, the client computer performs automatic hosted cache server discovery. If one or more hosted cache servers is found, the client computer self-configures for hosted cache mode.

If the policy setting "Set BranchCache Distributed Cache Mode" is applied in addition to this policy, the client computer performs automatic hosted cache server discovery. If one or more hosted cache servers are found, the client computer self-configures for hosted cache mode only.

If the policy setting "Set BranchCache Hosted Cache Mode" is applied, the client computer does not perform automatic hosted cache discovery. This is also true in cases where the policy setting "Configure Hosted Cache Servers" is applied.

This policy setting can only be applied to client computers that are running at least Windows 8. This policy has no effect on computers that are running Windows 7 or Windows Vista.

If you disable, or do not configure this setting, a client will not attempt to discover hosted cache servers by service connection point.

Policy configuration

Select one of the following:

- Not Configured. With this selection, BranchCache settings are not applied to client computers by this policy setting, and client computers do not perform hosted cache server discovery.

- Enabled. With this selection, the policy setting is applied to client computers, which perform automatic hosted cache server discovery and which are configured as hosted cache mode clients.

- Disabled. With this selection, this policy is not applied to client computers.

French text from Windows 11 26H2

Ce paramètre de stratégie spécifie si les ordinateurs client doivent tenter une configuration automatique du mode de cache hébergé en recherchant les points de connexion de service des serveurs de cache hébergé qui sont associés au site Active Directory actuel. Si vous activez ce paramètre de stratégie, les ordinateurs client auxquels le paramètre est appliqué recherchent des serveurs de cache hébergé à l’aide d’Active Directory et préfèrent ces serveurs et le mode de cache hébergé à la configuration BranchCache manuelle ou exécutée par d’autres stratégies de groupe.

Si vous activez ce paramètre de stratégie, ainsi que le paramètre de stratégie « Activer BranchCache », les clients BranchCache tentent de découvrir les serveurs de cache hébergé de la filiale locale. Si les ordinateurs client détectent des serveurs de cache hébergé, le mode de cache hébergé est activé. Dans le cas contraire, le mode de cache hébergé n’est pas activé et les clients utilisent une autre configuration spécifiée manuellement ou par la stratégie de groupe.

Lorsque ce paramètre de stratégie est appliqué, l’ordinateur client procède ou non à la découverte automatique de serveurs de cache hébergé dans les cas suivants :

Si aucun autre paramètre de stratégie BranchCache n’est appliqué, l’ordinateur client procède à la découverte automatique du serveur de cache hébergé. Si un ou plusieurs serveurs de cache hébergé sont détectés, l’ordinateur client procède à sa propre configuration pour le mode de cache hébergé.

Si le paramètre de stratégie « Définir le mode de cache distribué de BranchCache » est appliqué en plus de cette stratégie, l’ordinateur client procède à la découverte automatique du serveur de cache hébergé. Si un ou plusieurs serveurs de cache hébergé sont détectés, l’ordinateur client procède à sa propre configuration pour le mode de cache hébergé uniquement.

Si le paramètre de stratégie « Définir le mode de cache hébergé de BranchCache » est appliqué, l’ordinateur client ne procède à aucune découverte automatique du cache hébergé. Cela est également vrai lors de l’application du paramètre de stratégie « Configurer les serveurs de cache hébergé ».

Ce paramètre de stratégie ne peut être appliqué qu’aux ordinateurs clients qui exécutent au minimum Windows 8. Cette stratégie n’a aucun effet sur les ordinateurs qui exécutent Windows 7 ou Windows Vista.

Si vous désactivez ou ne configurez pas ce paramètre, aucun client n’essaie de découvrir des serveurs de cache hébergé via un point de connexion de service.

Configuration de la stratégie

Sélectionnez l’une des valeurs suivantes :

- Non configuré. Avec cette sélection, ce paramètre de stratégie ne permet pas d’appliquer les paramètres BranchCache aux ordinateurs client, lesquels ne procèdent pas à la découverte des serveurs de cache hébergé.

- Activé. Avec cette sélection, le paramètre de stratégie est appliqué aux ordinateurs client qui procèdent à la découverte automatique des serveurs de cache hébergé et qui sont configurés comme des clients en mode de cache hébergé.

- Désactivé. Avec cette sélection, cette stratégie n’est pas appliquée aux ordinateurs client.

Registry

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

Disable

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

Revert to "Not configured"

# Revert to "Not configured": PeerToPeerCaching/EnableWindowsBranchCache_HostedCacheDiscovery
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\PeerDist\HostedCache\Discovery'
Remove-ItemProperty -Path $k -Name 'SCPDiscoveryEnabled' -ErrorAction SilentlyContinue

Availability