Open in the explorer

Macro Runtime Scan Scope

Type
User
GPO path
User Configuration › Policies › Administrative Templates › Microsoft Office 2016 › Security Settings
Supported on
At least Windows Server 2016, Windows 10
ADMX file
office16.admx
Internal name
office16/L_MacroRuntimeScanScope

Explanation

This policy setting specifies the behavior for both the VBA and Excel 4.0 (XLM) runtime scan features. Multiple Office apps support VBA macros, but XLM macros are only supported by Excel. Macros can only be scanned if the anti-virus software registers as an Antimalware Scan Interface (AMSI) provider on the device.

If you enable this policy setting, you can choose from the following options to determine the macro runtime scanning behavior:

- Disable for all files (not recommended): If you choose this option, no runtime scanning of enabled macros will be performed.

- Enable for low trust files: If you choose this option, runtime scanning will be enabled for all files for which macros are enabled, except for the following files:
- Files opened while macro security settings are set to “Enable All Macros”
- Files opened from a Trusted Location
- Files that are Trusted Documents
- Files that contain VBA that is digitally signed by a Trusted Publisher

- Enable for all files: If you choose this option, then low trust files are not excluded from runtime scanning.

- Enable for files, excluding documents marked as trusted by an admin: If you choose this option, runtime scanning will be enabled for all files for which macros are enabled, except for the following files:
- Files opened from a Trusted Location
- Files that contain VBA that is digitally signed by a Trusted Publisher

The VBA and XLM runtimes report to an antivirus system certain high-risk code behaviors the macro is about to execute. This allows the antivirus system to indicate whether or not the macro behavior is malicious. If the behavior is determined to be malicious, the Office application closes the session and the antivirus system can quarantine the file. If the behavior is non-malicious, the macro execution proceeds.

Note: When macro runtime scanning is enabled, the runtime performance of affected VBA projects and XLM sheets may be reduced.

If you disable this policy setting, no runtime scanning of enabled macros will be performed.

If you don’t configure this policy setting, “Enable for low trust files” will be the default setting.

Note: This policy setting only applies to subscription versions of Office, such as Microsoft 365 Apps for enterprise.

Registry

HKEY_CURRENT_USER\software\policies\microsoft\office\16.0\common\security
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: office16/L_MacroRuntimeScanScope
$k = 'HKCU:\software\policies\microsoft\office\16.0\common\security'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
#
# Possible options:
#   Disable for all documents = 0
#   Enable for low trust documents = 1
#   Enable for all documents = 2
#   Scan excluding documents marked as trusted by an admin = 3
Set-ItemProperty -Path $k -Name 'macroruntimescanscope' -Value 0 -Type DWord

Disable

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

Revert to "Not configured"

# Revert to "Not configured": office16/L_MacroRuntimeScanScope
$k = 'HKCU:\software\policies\microsoft\office\16.0\common\security'
Remove-ItemProperty -Path $k -Name 'macroruntimescanscope' -ErrorAction SilentlyContinue

Options (1)

LabelControlRegistry valueREG typeConstraints / details
L_MacroRuntimeScanScopeEnumDrop-down listenummacroruntimescanscopeREG_DWORD
Default choice (UI): #0
LabelValue
Disable for all documentsREG_DWORD = 0
Enable for low trust documentsREG_DWORD = 1
Enable for all documentsREG_DWORD = 2
Scan excluding documents marked as trusted by an adminREG_DWORD = 3

Application

Microsoft 365 Apps / Office (Microsoft) — November 2026 templates

Official templates downloaded on November 12, 2026.