Allow add-in usage data to be generated and collected by the Readiness Toolkit
| Registry value | enableusageagent |
| Group Policy | Allow add-in usage data to be generated and collected by the Readiness Toolkit |
| German version | Dem Bereitschafts-Toolkit das Generieren und Sammeln von Add-In-Verwendungsdaten gestatten |
| Intune settings catalog | Allow add-in usage data to be generated and collected by the Readiness Toolkit (User) |
| Scope | User · HKCU |
| ADMX | office16.admx · L_OfficeReadinessToolkitEnableUsageAgent |
Group Policy path
Registry
| Value | Data |
|---|---|
HKCU\Software\policies\microsoft\office\readinesstoolkit | |
| enableusageagent | Enabled = 1 · Disabled = 0 |
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\readinesstoolkit"
foreach ($name in @('enableusageagent')) {
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\readinesstoolkit"
if (-not (Test-Path $key)) { New-Item -Path $key -Force -ErrorAction Stop | Out-Null }
New-ItemProperty -Path $key -Name 'enableusageagent' -PropertyType DWord -Value 1 -Force -ErrorAction Stop | Out-Null # Enabled
'Done.'
}
catch { Write-Error "Failed: $($_.Exception.Message)" }Disable
# --- Settings ---
$root = 'HKCU:' # other signed-in user (elevated): 'Registry::HKEY_USERS\<SID>'
try {
$key = "$root\Software\policies\microsoft\office\readinesstoolkit"
if (-not (Test-Path $key)) { New-Item -Path $key -Force -ErrorAction Stop | Out-Null }
New-ItemProperty -Path $key -Name 'enableusageagent' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null # Disabled
'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\readinesstoolkit" Remove-ItemProperty -Path $key -Name 'enableusageagent' -ErrorAction SilentlyContinue 'Policy values removed (Not configured).'
Intune (settings catalog)
Allow add-in usage data to be generated and collected by the Readiness Toolkit (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/office16v2~Policy~L_MicrosoftOfficeSystem~L_ReadinessToolkit/L_OfficeReadinessToolkitEnableUsageAgent |
| Data type | String |
| Value | <enabled/> · <disabled/> |
Cloud Policy
Cloud Policy (config.office.com → Customization → Policy Management) offers many user policies of the Microsoft 365 Apps – search for Allow add-in usage data to be generated and collected by the Readiness Toolkit. It also applies to unmanaged devices and wins over GPO and Intune for the same setting.
Microsoft explanation
This policy setting allows you to configure whether the Readiness Toolkit for Office generates and collects add-in usage data. The data generated and collected includes when the add-in is loaded and used, and if the add-in crashes. This information is available in reports provided by the Readiness Toolkit.
If you enable this policy setting, the Readiness Toolkit generates and collects add-in usage data.
If you disable or don't configure this policy setting, the Readiness Toolkit doesn't generate or collect add-in usage data.
Same category: Microsoft Office 2016 › Readiness Toolkit
All policies in this category · All 945 policies of office16.admx