Silently move Windows known folders to OneDrive
Explanation
This setting lets you redirect known folders to OneDrive without any user interaction. In sync app builds below 18.171.0823.0001, this setting only redirects empty known folders to OneDrive (or known folders already redirected to a different OneDrive account). In later builds, it redirects known folders that contain content and moves the content to OneDrive. We recommend using this setting together with "Prompt users to move Windows known folders to OneDrive." If moving the known folders silently does not succeed, users will be prompted to correct the error and continue.
If you enable this setting and provide your tenant ID, you can choose whether to display a notification to users after their folders have been redirected.
You can move all folders at once or select the folders you want to move. After a folder is moved, this policy will not affect that folder again, even if you clear the check box for the folder.
If you disable or do not configure this setting, your users' known folders will not be silently redirected and/or moved to OneDrive.
Use cases
Silently moves Desktop, Documents and Pictures to OneDrive with no user interaction, with an optional notification afterwards. It is the most direct way to back up user folders to OneDrive; once a folder has been moved, the policy does not touch it again, even if the selection changes.
Microsoft recommends pairing it with the prompt policy so users can fix an error, and pacing the rollout (limits of 1,000 devices per day and 4,000 per week for existing devices). It does not work if Documents, Pictures or Desktop are already redirected by Folder Redirection GPO to a location other than OneDrive.
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/KFMOptInNoWizard
$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 'KFMSilentOptIn' -Value '<value>' -Type String
# Show notification to users after folders have been redirected
# Possible options:
# No = 0
# Yes = 1
Set-ItemProperty -Path $k -Name 'KFMSilentOptInWithNotification' -Value 0 -Type DWord
# Desktop
# unchecked: 0
Set-ItemProperty -Path $k -Name 'KFMSilentOptInDesktop' -Value 1 -Type DWord
# Documents
# unchecked: 0
Set-ItemProperty -Path $k -Name 'KFMSilentOptInDocuments' -Value 1 -Type DWord
# Pictures
# unchecked: 0
Set-ItemProperty -Path $k -Name 'KFMSilentOptInPictures' -Value 1 -Type DWordDisable
# Disable: OneDrive/KFMOptInNoWizard
# No value is written in the "Disabled" state (nothing defined in the ADMX)Revert to "Not configured"
# Revert to "Not configured": OneDrive/KFMOptInNoWizard
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\OneDrive'
Remove-ItemProperty -Path $k -Name 'KFMSilentOptIn' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'KFMSilentOptInWithNotification' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'KFMSilentOptInDesktop' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'KFMSilentOptInDocuments' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'KFMSilentOptInPictures' -ErrorAction SilentlyContinueOptions (5)
| Label | Control | Registry value | REG type | Constraints / details | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Tenant ID:KFMOptInNoWizard_TextBox | Text boxtext | KFMSilentOptIn | REG_SZ | Required · Max length: 2000 | ||||||
| Show notification to users after folders have been redirected:KFMOptInNoWizard_Dropdown | Drop-down listenum | KFMSilentOptInWithNotification | REG_DWORD | Default choice (UI): #0
| ||||||
| DesktopKFMOptInNoWizard_Desktop_Checkbox | Check boxboolean | KFMSilentOptInDesktop | REG_DWORD | Default (UI): true Checked: REG_DWORD = 1Unchecked: REG_DWORD = 0 | ||||||
| DocumentsKFMOptInNoWizard_Documents_Checkbox | Check boxboolean | KFMSilentOptInDocuments | REG_DWORD | Default (UI): true Checked: REG_DWORD = 1Unchecked: REG_DWORD = 0 | ||||||
| PicturesKFMOptInNoWizard_Pictures_Checkbox | Check boxboolean | KFMSilentOptInPictures | REG_DWORD | Default (UI): true Checked: REG_DWORD = 1Unchecked: REG_DWORD = 0 |
Application
Microsoft OneDrive (Microsoft) — October 2026 templates
October 2026 templates from pl4nty/web-admx-tool.