Office Admin Explorer

Admin-Controlled Migration to New Outlook

Classic Outlook only. The new Outlook for Windows ignores most of these Office policies – it is configured through Exchange Online (OWA mailbox policy) instead.

Registry value
donewoutlookautomigration
Group PolicyAdmin-Controlled Migration to New Outlook
German versionVom Administrator kontrollierte Migration zum neuen Outlook
Intune settings catalogAdmin-Controlled Migration to New Outlook (User)
ScopeUser · HKCU
ADMXoutlk16.admx · L_DoNewOutlookAutoMigration
Open in the interactive explorer+ Add to my collection

Group Policy path

User Configuration\Policies\Administrative Templates\Microsoft Outlook 2016\Outlook Options\Other
Benutzerkonfiguration\Richtlinien\Administrative Vorlagen\Microsoft Outlook 2016\Outlook-Optionen\Weitere

Registry

ValueData
HKCU\Software\policies\microsoft\office\16.0\outlook\options\general
donewoutlookautomigrationEnabled = 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\16.0\outlook\options\general"
foreach ($name in @('donewoutlookautomigration')) {
    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\outlook\options\general"
    if (-not (Test-Path $key)) { New-Item -Path $key -Force -ErrorAction Stop | Out-Null }
    New-ItemProperty -Path $key -Name 'donewoutlookautomigration' -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\16.0\outlook\options\general"
    if (-not (Test-Path $key)) { New-Item -Path $key -Force -ErrorAction Stop | Out-Null }
    New-ItemProperty -Path $key -Name 'donewoutlookautomigration' -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\16.0\outlook\options\general"
Remove-ItemProperty -Path $key -Name 'donewoutlookautomigration' -ErrorAction SilentlyContinue
'Policy values removed (Not configured).'

Intune (settings catalog)

Admin-Controlled Migration to New Outlook (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/outlk16v14~Policy~L_MicrosoftOfficeOutlook~L_OutlookOptions~L_Other/L_DoNewOutlookAutoMigration
Data typeString
Value<enabled/> · <disabled/>

Cloud Policy

Cloud Policy (config.office.com → Customization → Policy Management) offers many user policies of the Microsoft 365 Apps – search for Admin-Controlled Migration to New Outlook. It also applies to unmanaged devices and wins over GPO and Intune for the same setting.

Microsoft explanation

This policy controls the ability of IT admins to initiate the migration of users from classic Outlook to new Outlook.

If you enable this policy setting, IT admins will start the process to switch users from classic Outlook to new Outlook.

If you disable this policy setting, the migration process to new Outlook will be stopped, keeping users on their current version of Outlook without transitioning to new Outlook.

If you do not set this policy setting, the migration process to new Outlook will not start, and users that have not migrated will remain on classic Outlook.

Note: IT admins can also define intervals for re-initiating the migration process for users who revert to classic Outlook from new Outlook. This is managed through the NewOutlookAutoMigrationRetryIntervals policy, offering a tailored strategy for transitioning users based on organizational requirements and user feedback.

Same category: Microsoft Outlook 2016 › Outlook Options › Other

All policies in this category · All 406 policies of outlk16.admx