Configure Hosted Cache Servers
Configurer les serveurs de cache hébergé
Explanation
This policy setting specifies whether client computers are configured to use hosted cache mode and provides the computer name of the hosted cache servers that are available to the client computers. Hosted cache mode enables client computers in branch offices to retrieve content from one or more hosted cache servers that are installed in the same office location. You can use this setting to automatically configure client computers that are configured for hosted cache mode with the computer names of the hosted cache servers in the branch office.
If you enable this policy setting and specify valid computer names of hosted cache servers, hosted cache mode is enabled for all client computers to which the policy setting is applied. For this policy setting to take effect, you must also enable the "Turn on BranchCache" policy setting.
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. Client computers to which this policy setting is applied, in addition to the "Set BranchCache Hosted Cache mode" policy setting, use the hosted cache servers that are specified in this policy setting and do not use the hosted cache server that is configured in the policy setting "Set BranchCache Hosted Cache Mode."
If you do not configure this policy setting, or if you disable this policy setting, client computers that are configured with hosted cache mode still function correctly.
Policy configuration
Select one of the following:
- Not Configured. With this selection, BranchCache settings are not applied to client computers by this policy setting.
- Enabled. With this selection, the policy setting is applied to client computers, which are configured as hosted cache mode clients that use the hosted cache servers that you specify in "Hosted cache servers."
- Disabled. With this selection, this policy is not applied to client computers.
In circumstances where this setting is enabled, you can also select and configure the following option:
- Hosted cache servers. To add hosted cache server computer names to this policy setting, click Enabled, and then click Show. The Show Contents dialog box opens. Click Value, and then type the computer names of the hosted cache servers.
Ce paramètre de stratégie spécifie si les ordinateurs client sont configurés pour utiliser le mode de cache hébergé et il indique le nom d’ordinateur des serveurs de cache hébergé à la disposition des ordinateurs client. Le mode de cache hébergé permet aux ordinateurs client de filiales de récupérer du contenu sur un ou plusieurs serveurs de cache hébergé installés dans les mêmes bureaux. Ce paramètre vous permet de configurer automatiquement des ordinateurs client configurés pour le mode de cache hébergé en utilisant les noms d’ordinateur des serveurs de cache hébergé de la filiale.
Si vous activez ce paramètre de stratégie et spécifiez des noms d’ordinateur correspondant à des serveurs de cache hébergé, le mode de cache hébergé est activé pour tous les ordinateurs client auxquels le paramètre de stratégie est appliqué. Pour que ce paramètre de stratégie soit pris en compte, vous devez également activer le paramètre de stratégie « Activer BranchCache ».
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. Les ordinateurs client auxquels ce paramètre de stratégie est appliqué, en plus du paramètre de stratégie « Définir le mode de cache hébergé de BranchCache », utilisent les serveurs de cache hébergé spécifiés dans ce paramètre de stratégie et non le serveur de cache hébergé configuré dans le paramètre de stratégie « Définir le mode de cache hébergé de BranchCache ».
Si vous ne configurez pas ou désactivez ce paramètre de stratégie, les ordinateurs client configurés avec le mode de cache hébergé fonctionnent correctement.
Configuration de la stratégie
Sélectionnez l’une des valeurs suivantes :
- Non configuré. Avec cette sélection, les paramètres BranchCache ne sont pas appliqués sur les ordinateurs client par ce paramètre de stratégie.
- Activé. Avec cette sélection, le paramètre de stratégie est appliqué aux ordinateurs client qui sont configurés comme des clients en mode de cache hébergé qui utilisent les serveurs de cache hébergé spécifiés dans l’option « Serveurs de cache hébergé ».
- Désactivé. Avec cette sélection, cette stratégie n’est pas appliquée aux ordinateurs client.
Lorsque ce paramètre est activé, vous pouvez également sélectionner et configurer l’option suivante :
- Serveurs de cache hébergé. Pour ajouter des noms d’ordinateur de serveurs de cache hébergé, cliquez sur Activé, puis sur Afficher. La boîte de dialogue Afficher le contenu s’ouvre. Cliquez sur Valeur, puis tapez les noms d’ordinateur des serveurs de cache hébergé.
Registry
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\PeerDist\HostedCache\MultipleServers- 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_HostedMultipleServers
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\PeerDist\HostedCache\MultipleServers'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
#
# Non-additive list: when enabled, the GPO first clears the previous values of this list
if (Test-Path -Path $k) { (Get-Item -Path $k).Property | Where-Object { $_ -match '^\d+$' } | ForEach-Object { Remove-ItemProperty -Path $k -Name ([WildcardPattern]::Escape($_)) -ErrorAction SilentlyContinue } }
$values = @('<value1>', '<value2>') # Replace the values with your own
$i = 1
foreach ($v in $values) { Set-ItemProperty -Path $k -Name ('' + $i) -Value $v -Type String; $i++ }Disable
# Disable: PeerToPeerCaching/EnableWindowsBranchCache_HostedMultipleServers
# No value is written in the "Disabled" state (nothing defined in the ADMX)Revert to "Not configured"
# Revert to "Not configured": PeerToPeerCaching/EnableWindowsBranchCache_HostedMultipleServers
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\PeerDist\HostedCache\MultipleServers'
if (Test-Path -Path $k) { (Get-Item -Path $k).Property | Where-Object { $_ -match '^\d+$' } | ForEach-Object { Remove-ItemProperty -Path $k -Name ([WildcardPattern]::Escape($_)) -ErrorAction SilentlyContinue } }Options (1)
| Label | Control | Registry value | REG type | Constraints / details |
|---|---|---|---|---|
| WBC_MultipleServers_Listbox | List (table)list | SOFTWARE\Policies\Microsoft\PeerDist\HostedCache\MultipleServersValues named “” + number | REG_SZ (values under the key) |