Configurer BranchCache pour les fichiers réseau
Vérifié avec Windows 11 25H2 — mis à jour le 30 juillet 2026
Pris en charge sur : Au minimum Windows Server 2008 R2 ou Windows 7
Chemin dans la console GPO
Configuration ordinateur\Modèles d'administration\Réseau\BranchCache Description
Ce paramètre de stratégie n’est utilisé que si vous avez déployé un ou plusieurs serveurs de fichiers BranchCache dans votre bureau principal. Ce paramètre de stratégie spécifie quand les ordinateurs client des bureaux principaux commencent à mettre en cache le contenu de serveurs de fichiers en fonction du temps de réponse du réseau, ou du retard, résultant du téléchargement par les clients de contenu provenant du bureau principal via un lien de réseau étendu. Lorsque vous configurez une valeur pour ce paramètre qui représente le temps de réponse maximum du réseau aller-retour autorisé avant que la mise en cache ne commence, les clients ne mettent en cache le contenu que lorsque le temps de réponse du réseau a atteint la valeur spécifiée. Lorsqu’il est supérieur à cette valeur, les clients commencent à mettre en cache le contenu une fois qu’il a été transmis par les serveurs de fichiers et reçu. Configuration de la stratégie Sélectionnez l’une des valeurs suivantes : - Non configuré. Avec cette sélection, les paramètres de latence BranchCache ne sont pas appliqués sur les ordinateurs client par cette stratégie. Si les ordinateurs client sont membres du domaine, mais que vous ne voulez pas configurer de paramètre de latence 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 de latence 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 latence que vous utilisez sur des ordinateurs client individuels. - Activé. En sélectionnant cette valeur, le paramètre de latence aller-retour maximum est activé pour tous les ordinateurs client auxquels la stratégie est appliquée. Par exemple, si l’option Configurer BranchCache pour les fichiers réseau est activée dans la stratégie de groupe du domaine, le paramètre de latence 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 latence par défaut équivalent à 80 millisecondes. Lorsque ce paramètre de stratégie est activé, vous pouvez également sélectionner et configurer l’option suivante : - Entrer le temps de réponse maximum du réseau aller-retour (millisecondes) avant que la mise en cache ne commence. Indique la durée, en millisecondes, après laquelle les ordinateurs client BranchCache commencent à mettre en cache le contenu localement.
Registre
Software\Policies\Microsoft\Windows\NetCache MDM / Intune (CSP)
./Device/Vendor/MSFT/Policy/Config/ADMX_PeerToPeerCaching/EnableWindowsBranchCache_SMB Documentation Microsoft Learn Données de correspondance : Microsoft Learn (CC BY 4.0)
Générateur d'exports
BETAConfigurez l'état, la portée et les options, puis générez les sorties .reg, PowerShell, Intune et SCCM — ou ajoutez le paramètre à une collection multi-paramètres.
Ces exports écrivent le registre — ce n'est pas une GPO managée. ⓘ
Fichier .reg
Windows Registry Editor Version 5.00
; Exported from gporais.com
; Policy: Configurer BranchCache pour les fichiers réseau
; State: Enabled
; Supported on: Au minimum Windows Server 2008 R2 ou Windows 7
[HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\NetCache]
"PeerCachingLatencyThreshold"=dword:00000050 Autres formats (PowerShell, Intune, SCCM)
PowerShell
# Exported from gporais.com
# Policy: Configurer BranchCache pour les fichiers réseau
# State: Enabled
# Supported on: Au minimum Windows Server 2008 R2 ou Windows 7
$path = 'HKLM:\Software\Policies\Microsoft\Windows\NetCache'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'PeerCachingLatencyThreshold' -Value 80 -Type DWord Intune XML
OMA-URI: ./Device/Vendor/MSFT/Policy/Config/ADMX_PeerToPeerCaching/EnableWindowsBranchCache_SMB
Data type: String
Value:
<enabled/>
<data id="WBC_SMBLatency_DecimalTextBox" value="80"/> Intune Remediation
# === Detection script ===
# Exported from gporais.com
# Policy: Configurer BranchCache pour les fichiers réseau
# State: Enabled
# Supported on: Au minimum Windows Server 2008 R2 ou Windows 7
function Test-RegistryValue {
param(
[Parameter(Mandatory = $true)][string]$Path,
[Parameter(Mandatory = $true)][string]$Name,
[object]$Expected,
[ValidateSet('String', 'DWord', 'MultiString')][string]$Kind = 'String',
[switch]$Absent
)
try {
$item = Get-ItemProperty -LiteralPath $Path -Name $Name -ErrorAction Stop
} catch {
return $Absent.IsPresent
}
if ($Absent.IsPresent) { return $false }
$actual = $item.$Name
if ($Kind -eq 'DWord') { return ([int64]$actual) -eq ([int64]$Expected) }
if ($Kind -eq 'MultiString') {
$actualValues = @($actual)
$expectedValues = @($Expected)
if ($actualValues.Count -ne $expectedValues.Count) { return $false }
for ($i = 0; $i -lt $expectedValues.Count; $i++) {
if ([string]$actualValues[$i] -ne [string]$expectedValues[$i]) { return $false }
}
return $true
}
return [string]$actual -eq [string]$Expected
}
$checks = @(
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Microsoft\Windows\NetCache' -Name 'PeerCachingLatencyThreshold' -Expected 80 -Kind DWord)
)
if ($checks -notcontains $false) {
Write-Output 'Compliant'
exit 0
}
Write-Output 'Non-compliant'
exit 1
# === Remediation script ===
# Exported from gporais.com
# Policy: Configurer BranchCache pour les fichiers réseau
# State: Enabled
# Supported on: Au minimum Windows Server 2008 R2 ou Windows 7
$path = 'HKLM:\Software\Policies\Microsoft\Windows\NetCache'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'PeerCachingLatencyThreshold' -Value 80 -Type DWord Scripts SCCM
# Exported from gporais.com
# Policy: Configurer BranchCache pour les fichiers réseau
# State: Enabled
# Supported on: Au minimum Windows Server 2008 R2 ou Windows 7
# SCCM Configuration Item guidance:
# Create a Configuration Item of type "Setting: Script".
# Discovery script: use the Detection script below.
# Remediation script: use the Remediation script below.
# Compliance rule: the Discovery script output equals 'Compliant'.
# === Detection script ===
# Exported from gporais.com
# Policy: Configurer BranchCache pour les fichiers réseau
# State: Enabled
# Supported on: Au minimum Windows Server 2008 R2 ou Windows 7
function Test-RegistryValue {
param(
[Parameter(Mandatory = $true)][string]$Path,
[Parameter(Mandatory = $true)][string]$Name,
[object]$Expected,
[ValidateSet('String', 'DWord', 'MultiString')][string]$Kind = 'String',
[switch]$Absent
)
try {
$item = Get-ItemProperty -LiteralPath $Path -Name $Name -ErrorAction Stop
} catch {
return $Absent.IsPresent
}
if ($Absent.IsPresent) { return $false }
$actual = $item.$Name
if ($Kind -eq 'DWord') { return ([int64]$actual) -eq ([int64]$Expected) }
if ($Kind -eq 'MultiString') {
$actualValues = @($actual)
$expectedValues = @($Expected)
if ($actualValues.Count -ne $expectedValues.Count) { return $false }
for ($i = 0; $i -lt $expectedValues.Count; $i++) {
if ([string]$actualValues[$i] -ne [string]$expectedValues[$i]) { return $false }
}
return $true
}
return [string]$actual -eq [string]$Expected
}
$checks = @(
(Test-RegistryValue -Path 'HKLM:\Software\Policies\Microsoft\Windows\NetCache' -Name 'PeerCachingLatencyThreshold' -Expected 80 -Kind DWord)
)
if ($checks -notcontains $false) {
Write-Output 'Compliant'
exit 0
}
Write-Output 'Non-compliant'
exit 1
# === Remediation script ===
# Exported from gporais.com
# Policy: Configurer BranchCache pour les fichiers réseau
# State: Enabled
# Supported on: Au minimum Windows Server 2008 R2 ou Windows 7
$path = 'HKLM:\Software\Policies\Microsoft\Windows\NetCache'
New-Item -Path $path -Force | Out-Null
Set-ItemProperty -Path $path -Name 'PeerCachingLatencyThreshold' -Value 80 -Type DWord Vous construisez une collection multi-paramètres ? Ajoutez ce paramètre et générez des exports combinés (.reg, PowerShell, GPO).