Open in the explorer

Set percentage of disk space used for client computer cache

Définir le pourcentage d’espace disque utilisé pour la mémoire cache de l’ordinateur client

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

Explanation

This policy setting specifies the default percentage of total disk space that is allocated for the BranchCache disk cache on client computers.

If you enable this policy setting, you can configure the percentage of total disk space to allocate for the cache.

If you disable or do not configure this policy setting, the cache is set to 5 percent of the total disk space on the client computer.

Policy configuration

Select one of the following:

- Not Configured. With this selection, BranchCache client computer cache 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 configure a BranchCache client computer cache setting on all client computers, you can specify Not Configured for this domain Group Policy setting, and then configure local computer policy to enable BranchCache client computer cache settings on individual client computers. Because the domain Group Policy setting is not configured, it will not over-write the client computer cache setting that you use on individual client computers.

- Enabled. With this selection, the BranchCache client computer cache setting is enabled for all client computers where the policy is applied. For example, if Set percentage of disk space used for client computer cache is enabled in domain Group Policy, the BranchCache client computer cache setting that you specify in the policy is turned on for all domain member client computers to which the policy is applied.

- Disabled. With this selection, BranchCache client computers use the default client computer cache setting of five percent of the total disk space on the client computer.

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

- Specify the percentage of total disk space allocated for the cache. Specifies an integer that is the percentage of total client computer disk space to use for the BranchCache client computer cache.

* 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 le pourcentage par défaut d’espace disque total alloué au cache disque BranchCache sur les ordinateurs client.

Si vous activez ce paramètre de stratégie, vous pouvez configurer le pourcentage d’espace disque à allouer au cache.

Si vous le désactivez ou ne le configurez pas, le pourcentage alloué au cache représente 5 pour cent de l’espace disque total de l’ordinateur client.

Configuration de la stratégie

Sélectionnez l’une des valeurs suivantes :

- Non configuré. Avec cette sélection, les paramètres du cache de l’ordinateur client BranchCache ne sont pas appliqués par cette stratégie aux ordinateurs client. Si les ordinateurs client sont membres du domaine, mais que vous ne voulez pas configurer de paramètre de cache d’ordinateur client BranchCache sur tous les ordinateurs client, 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 pour activer les paramètres du cache de l’ordinateur client BranchCache sur des ordinateurs client individuels. Puisque le paramètre de stratégie de groupe de domaine n’est pas configuré, il ne remplace pas le paramètre de cache de l’ordinateur client que vous utilisez sur des ordinateurs client individuels.

- Activé. Avec cette sélection, le paramètre de cache de l’ordinateur client BranchCache est activé pour tous les ordinateurs client auxquels la stratégie est appliquée. Par exemple, si l’option Définir le pourcentage d’espace disque utilisé pour la mémoire cache de l’ordinateur client est activée dans la stratégie de groupe du domaine, le paramètre de cache de l’ordinateur client BranchCache que vous spécifiez dans la stratégie est activé pour tous les ordinateurs client membres du domaine auxquels la stratégie est appliquée.

- Désactivé. Avec cette sélection, les ordinateurs client BranchCache utilisent le paramètre de cache de l’ordinateur client par défaut, à savoir cinq pour cent de l’espace disque total sur l’ordinateur client.

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

- Spécifier le pourcentage d’espace disque total alloué au cache. Spécifie un entier représentant le pourcentage d’espace disque total de l’ordinateur client à utiliser pour le cache de l’ordinateur client BranchCache.

* 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\CacheMgr\Republication
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/SetCachePercent
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\PeerDist\CacheMgr\Republication'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
#
Set-ItemProperty -Path $k -Name 'SizePercent' -Value 5 -Type DWord  # between 1 and 100

Disable

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

Revert to "Not configured"

# Revert to "Not configured": PeerToPeerCaching/SetCachePercent
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\PeerDist\CacheMgr\Republication'
Remove-ItemProperty -Path $k -Name 'SizePercent' -ErrorAction SilentlyContinue

Options (1)

LabelControlRegistry valueREG typeConstraints / details
WBC_Cache_Size_Percent_dctxtboxNumeric boxdecimalSizePercentREG_DWORD
Required · Min: 1 · Max: 100 · Default (UI): 5

Availability