Prompt users to move Windows known folders to OneDrive
Explanation
This setting displays the "Your IT department wants you to protect your important folders" window that prompts users to move their Documents, Pictures, and Desktop folders to OneDrive. This feature is not enabled for on-premises SharePoint.
If you enable this setting and provide your tenant ID, users who are syncing their OneDrive will see the "Your IT department wants you to protect your important folders" window when they're signed in. If they close the window, a reminder notification will appear in the activity center until they move all three known folders. If a user has already redirected their known folders to a different OneDrive account, they will be prompted to direct the folders to the account for your organization (leaving existing files behind).
If you disable or do not configure this setting, the "Your IT department wants you to protect your important folders" window won't appear automatically.
Use cases
Shows users a dialog inviting them to protect their Desktop, Documents and Pictures folders in OneDrive; if dismissed, a reminder appears in the activity center until the move or an error occurs. Less intrusive than a silent move, it leaves the timing to the user.
For large rollouts Microsoft limits the pace (5,000 devices per day and 20,000 per week for existing devices).
Microsoft source: Redirect and move Windows known folders to OneDrive
Registry
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\OneDrive- 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: OneDrive/KFMOptInWithWizard
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\OneDrive'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Tenant ID
Set-ItemProperty -Path $k -Name 'KFMOptInWithWizard' -Value '<value>' -Type StringDisable
# Disable: OneDrive/KFMOptInWithWizard
# No value is written in the "Disabled" state (nothing defined in the ADMX)Revert to "Not configured"
# Revert to "Not configured": OneDrive/KFMOptInWithWizard
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\OneDrive'
Remove-ItemProperty -Path $k -Name 'KFMOptInWithWizard' -ErrorAction SilentlyContinueOptions (1)
| Label | Control | Registry value | REG type | Constraints / details |
|---|---|---|---|---|
| Tenant ID:KFMOptInWithWizard_TextBox | Text boxtext | KFMOptInWithWizard | REG_SZ | Required · Max length: 2000 |
Application
Microsoft OneDrive (Microsoft) — October 2026 templates
October 2026 templates from pl4nty/web-admx-tool.