Open in the explorer

Specify the maximum depth to scan archive files

Spécifier la profondeur maximale pour analyser les fichiers archivés

Type
Computer
GPO path
Computer Configuration › Policies › Administrative Templates › Windows Components › Microsoft Defender Antivirus › Scan FR: Configuration ordinateur › Stratégies › Modèles d'administration › Composants Windows › Antivirus Microsoft Defender › Analyse
Supported on
At least Windows Server 2012, Windows 8 or Windows RT FR: Au minimum Windows Server 2012, Windows 8 ou Windows RT
ADMX file
WindowsDefender.admx
Internal name
WindowsDefender/Scan_ArchiveMaxDepth

Explanation

This policy setting allows you to configure the maximum directory depth level into which archive files such as .ZIP or .CAB are unpacked during scanning. The default directory depth level is 0.

If you enable this setting, archive files will be scanned to the directory depth level specified.

If you disable or do not configure this setting, archive files will be scanned to the default directory depth level.

French text from Windows 11 26H2

Ce paramètre de stratégie vous permet de configurer le niveau de profondeur de répertoire maximal où les fichiers archivés, tels que les fichiers .ZIP ou .CAB, sont décompressés lors de l’analyse. Le niveau de profondeur de répertoire par défaut est 0.

Si vous activez ce paramètre, les fichiers archivés sont analysés au niveau de profondeur de répertoire spécifié.

Si vous désactivez ou ne configurez pas ce paramètre, les fichiers archivés sont analysés au niveau de profondeur de répertoire par défaut.

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows Defender\Scan
Value name
ArchiveMaxDepth
StateValue written
Enablednot defined in the ADMX (see the options below)
Disablednot 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.

The ADMX does not specify the value written when enabled; the GPO editor usually writes REG_DWORD 1 (enabled) / 0 (disabled). The commands below use 1/0 as an assumption.

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: WindowsDefender/Scan_ArchiveMaxDepth
$k = 'HKLM:\Software\Policies\Microsoft\Windows Defender\Scan'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# The ADMX does not specify the value written; the GPO editor usually writes REG_DWORD 1 (enabled) / 0 (disabled)
Set-ItemProperty -Path $k -Name 'ArchiveMaxDepth' -Value 1 -Type DWord  # assumed value (not defined in the ADMX)
# Specify the maximum depth to scan archive files
Set-ItemProperty -Path $k -Name 'ArchiveMaxDepth' -Value 0 -Type DWord  # between 0 and 4294967295

Disable

# Disable: WindowsDefender/Scan_ArchiveMaxDepth
$k = 'HKLM:\Software\Policies\Microsoft\Windows Defender\Scan'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# The ADMX does not specify the value written; the GPO editor usually writes REG_DWORD 1 (enabled) / 0 (disabled)
Set-ItemProperty -Path $k -Name 'ArchiveMaxDepth' -Value 0 -Type DWord  # assumed value (not defined in the ADMX)

Revert to "Not configured"

# Revert to "Not configured": WindowsDefender/Scan_ArchiveMaxDepth
$k = 'HKLM:\Software\Policies\Microsoft\Windows Defender\Scan'
Remove-ItemProperty -Path $k -Name 'ArchiveMaxDepth' -ErrorAction SilentlyContinue

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Specify the maximum depth to scan archive filesSpécifier la profondeur maximale pour analyser les fichiers archivésScan_ArchiveMaxDepthNumeric boxdecimalArchiveMaxDepthREG_DWORD
Min: 0 · Max: 4294967295 · Default (UI): 0

Availability