Open in the explorer

Set BranchCache Hosted Cache mode

Définir le mode de cache hébergé 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_Hosted

Explanation

This policy setting specifies whether BranchCache hosted 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.

When a client computer is configured as a hosted cache mode client, it is able to download cached content from a hosted cache server that is located at the branch office. In addition, when the hosted cache client obtains content from a content server, the client can upload the content to the hosted cache server for access by other hosted cache clients at 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 hosted 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 hosted cache mode is turned on for all domain member client computers to which the policy is applied.

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

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

- Type the name of the hosted cache server. Specifies the computer name of the hosted cache server. Because the hosted cache server name is also specified in the certificate enrolled to the hosted cache server, the name that you enter here must match the name of the hosted cache server that is specified in the server certificate.

Hosted cache clients must trust the server certificate that is issued to the hosted cache server. Ensure that the issuing CA certificate is installed in the Trusted Root Certification Authorities certificate store on all hosted cache client computers.

* 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.

Lorsqu’un ordinateur client est configuré en tant que client en mode de cache hébergé, il peut télécharger le contenu en cache du serveur en cache hébergé de la filiale. De plus, lorsque le client de cache hébergé obtient du contenu d’un serveur de contenu, le client peut télécharger le contenu sur le serveur de cache hébergé pour que d’autres clients de cache hébergé de la filiale puissent y accéder.

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 hébergé 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 hébergé de BranchCache est activé pour tous les ordinateurs client membres du domaine auxquels la stratégie est appliquée.

- Désactivé. Avec cette sélection, le mode de cache hébergé de BranchCache est activé pour tous les ordinateurs client auxquels la stratégie est appliquée.

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

- Spécifier le nom du serveur de cache hébergé. Spécifie le nom d’ordinateur du serveur de cache hébergé. Puisque le nom de serveur de cache hébergé est également spécifié dans le certificat inscrit auprès du serveur de cache hébergé, le nom que vous indiquez ici doit correspondre à celui du serveur de cache hébergé spécifié dans le certificat de serveur.

Les clients de cache hébergé doivent approuver le certificat de serveur qui est délivré au serveur de cache hébergé. Veillez à ce que le certificat émis par l’autorité de certification soit installé dans le magasin de certificats des Autorités de certification racines de confiance sur tous les ordinateurs client de cache hébergé.

* 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\HostedCache\Connection
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/EnableWindowsBranchCache_Hosted
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\PeerDist\HostedCache\Connection'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Type the name of the hosted cache server
Set-ItemProperty -Path $k -Name 'Location' -Value '<value>' -Type String

Disable

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

Revert to "Not configured"

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

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Type the name of the hosted cache serverSpécifier le nom du serveur de cache hébergéWBC_Cache_TextBoxText boxtextLocationREG_SZ
Required

Availability