Scan encrypted macros in Excel Open XML workbooks
| Registry value | excelbypassencryptedmacroscan |
| Group Policy | Scan encrypted macros in Excel Open XML workbooks |
| German version | Verschlüsselte Makros in Excel Open XML-Arbeitsmappen überprüfen |
| Intune settings catalog | Scan encrypted macros in Excel Open XML workbooks (User) |
| Scope | User · HKCU |
| ADMX | excel16.admx · L_DeterminewhethertoforceencryptedExcel |
Group Policy path
Registry
| Value | Data |
|---|---|
HKCU\Software\policies\microsoft\office\16.0\excel\security | |
| excelbypassencryptedmacroscan | 0 = Scan encrypted macros (default) · 1 = Scan if anti-virus software available · 2 = Load macros without scanning |
Not configured = the value does not exist – the application default applies and users may change the setting.
PowerShell
Check the current value (read-only)
# --- Settings ---
$root = 'HKCU:' # other signed-in user (elevated): 'Registry::HKEY_USERS\<SID>'
$key = "$root\Software\policies\microsoft\office\16.0\excel\security"
foreach ($name in @('excelbypassencryptedmacroscan')) {
try { '{0} = {1}' -f $name, (Get-ItemPropertyValue -Path $key -Name $name -ErrorAction Stop) }
catch { '{0}: not configured' -f $name }
}Admin rights needed: HKCU\Software\Policies is read-only for standard users. An elevated session writes to the admin's own HKCU – to set it for another signed-in user, change $root to Registry::HKEY_USERS\<SID>.
Enable
# --- Settings ---
$root = 'HKCU:' # other signed-in user (elevated): 'Registry::HKEY_USERS\<SID>'
try {
$key = "$root\Software\policies\microsoft\office\16.0\excel\security"
if (-not (Test-Path $key)) { New-Item -Path $key -Force -ErrorAction Stop | Out-Null }
New-ItemProperty -Path $key -Name 'excelbypassencryptedmacroscan' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null # options: 0 = Scan encrypted macros (default), 1 = Scan if anti-virus software available, 2 = Load macros without scanning
'Done.'
}
catch { Write-Error "Failed: $($_.Exception.Message)" }Reset to Not configured
# --- Settings --- $root = 'HKCU:' # other signed-in user (elevated): 'Registry::HKEY_USERS\<SID>' $key = "$root\Software\policies\microsoft\office\16.0\excel\security" Remove-ItemProperty -Path $key -Name 'excelbypassencryptedmacroscan' -ErrorAction SilentlyContinue 'Policy values removed (Not configured).'
Intune (settings catalog)
Scan encrypted macros in Excel Open XML workbooks (User)
Settings catalog → Add settings → search for the name above.
Intune Settings Catalog Viewer ↗
Alternative: custom profile (OMA-URI)
| OMA-URI | ./User/Vendor/MSFT/Policy/Config/excel16v2~Policy~L_MicrosoftOfficeExcel~L_ExcelOptions~L_Security/L_DeterminewhethertoforceencryptedExcel |
| Data type | String |
| Value | <enabled/> · <disabled/> |
This policy has options: add one <data id="…" value="…"/> per element after <enabled/>. The element IDs are in the ADMX file.
Cloud Policy
Cloud Policy (config.office.com → Customization → Policy Management) offers many user policies of the Microsoft 365 Apps – search for Scan encrypted macros in Excel Open XML workbooks. It also applies to unmanaged devices and wins over GPO and Intune for the same setting.
Microsoft explanation
This policy setting controls whether encrypted macros in Open XML workbooks be are required to be scanned with anti-virus software before being opened.
If you enable this policy setting, you may choose one of these options:
- Scan encrypted macros: encrypted macros are disabled unless anti-virus software is installed. Encrypted macros are scanned by your anti-virus software when you attempt to open an encrypted workbook that contains macros.
- Scan if anti-virus software available: if anti-virus software is installed, scan the encrypted macros first before allowing them to load. If anti-virus software is not available, allow encrypted macros to load.
- Load macros without scanning: do not check for anti-virus software and allow macros to be loaded in an encrypted file.
If you disable or do not configure this policy setting, the behavior will be similar to the "Scan encrypted macros" option.
Same category: Microsoft Excel 2016 › Excel Options › Security
- Perform file validation on pivot cachespivotoptions
- Turn off file validationenableonload
- Block Insecure Protocols in Excel Worksheet Functionsblockinsecureprotocolworksheetfunctions
- Force file extension to match file typeextensionhardening
- WEBSERVICE Function Notification Settingswebservicefunctionwarnings
All policies in this category · All 173 policies of excel16.admx