Open in the explorer

Enable Transparent Caching

Activer la mise en cache transparente

Type
Computer
GPO path
Computer Configuration › Policies › Administrative Templates › Network › Offline Files FR: Configuration ordinateur › Stratégies › Modèles d'administration › Réseau › Fichiers hors connexion
Supported on
At least Windows Server 2008 R2 or Windows 7 FR: Au minimum Windows Server 2008 R2 ou Windows 7
ADMX file
OfflineFiles.admx
Internal name
OfflineFiles/Pol_OnlineCachingSettings

Explanation

This policy setting controls whether files read from file shares over a slow network are transparently cached in the Offline Files cache for future reads. When a user tries to access a file that has been transparently cached, Windows reads from the cached copy after verifying its integrity. This improves end-user response times and decreases bandwidth consumption over WAN links.

The cached files are temporary and are not available to the user when offline. The cached files are not kept in sync with the version on the server, and the most current version from the server is always available for subsequent reads.

This policy setting is triggered by the configured round trip network latency value. We recommend using this policy setting when the network connection to the server is slow. For example, you can configure a value of 60 ms as the round trip latency of the network above which files should be transparently cached in the Offline Files cache. If the round trip latency of the network is less than 60ms, reads to remote files will not be cached.

If you enable this policy setting, transparent caching is enabled and configurable.

If you disable or do not configure this policy setting, remote files will be not be transparently cached on client computers.

French text from Windows 11 26H2

Ce paramètre de stratégie détermine si les fichiers lus à partir de partages de fichiers sur un réseau lent sont mis en cache de manière transparente dans le cache des fichiers hors connexion pour des opérations de lecture ultérieure. Lorsqu’un utilisateur tente d’accéder à un fichier mis en cache de manière transparente, Windows lit la copie mise en cache après s’être assuré de son intégrité. Cela permet d’améliorer les temps de réponse de l’utilisateur final et de réduire la consommation de bande passante sur des liaisons réseau étendu.

Les fichiers mis en cache sont temporaires et les utilisateurs ne peuvent pas y accéder lorsqu’ils sont hors connexion. Les fichiers mis en cache ne restent pas synchronisés avec la version figurant sur le serveur et il est toujours possible de lire ultérieurement la version la plus récente sur le serveur.

Ce paramètre de stratégie est déclenché par la valeur configurée de temps de réponse du réseau aller-retour. Il est recommandé d’utiliser ce paramètre de stratégie lorsque la connexion réseau au serveur est lente. Par exemple, vous pouvez configurer une valeur de temps de réponse du réseau aller-retour de 60 ms au-delà de laquelle les fichiers seront mis en cache de façon transparente dans le cache des fichiers hors connexion. Si le temps de réponse du réseau aller-retour est inférieur à 60 ms, les lectures des fichiers distants ne seront pas mises en cache.

Si vous activez ce paramètre de stratégie, la mise en cache de manière transparente est activée et configurable.

Si vous désactivez ou ne configurez pas ce paramètre de stratégie, les fichiers distants ne sont pas mis en cache de façon transparente sur les ordinateurs client.

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\NetCache
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: OfflineFiles/Pol_OnlineCachingSettings
$k = 'HKLM:\Software\Policies\Microsoft\Windows\NetCache'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Enter network latency value in milliseconds
Set-ItemProperty -Path $k -Name 'OnlineCachingLatencyThreshold' -Value 32000 -Type DWord  # maximum 100000000

Disable

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

Revert to "Not configured"

# Revert to "Not configured": OfflineFiles/Pol_OnlineCachingSettings
$k = 'HKLM:\Software\Policies\Microsoft\Windows\NetCache'
Remove-ItemProperty -Path $k -Name 'OnlineCachingLatencyThreshold' -ErrorAction SilentlyContinue

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Enter network latency value in millisecondsEntrez la valeur de latence du réseau en millisecondes.Lbl_OnlineCachingSettingsListNumeric boxdecimalOnlineCachingLatencyThresholdREG_DWORD
Max: 100000000 · Default (UI): 32000

Availability