OneDrive for Business Known Folder Move fails before setup completes for Windows 11 rollouts: Fix Guide
🔍 WiseChecker

OneDrive for Business Known Folder Move fails before setup completes for Windows 11 rollouts: Fix Guide

When deploying Windows 11 across your organization, you might see Known Folder Move fail before the setup completes. This problem stops Desktop, Documents, and Pictures folders from redirecting to OneDrive during new device rollouts. The failure often occurs because of conflicting group policies, stale registry entries from a previous OneDrive configuration, or missing prerequisites like the Windows 11 22H2 update. This guide explains the specific causes of this setup failure and provides tested steps to fix Known Folder Move so it runs successfully during Windows 11 provisioning.

Key Takeaways: Fixing Known Folder Move Failures on Windows 11

  • Group Policy Object (GPO) settings for OneDrive: Conflicting policies like “Prevent the usage of OneDrive for file storage” block KFM before it starts — check and remove conflicting policies in the GPMC editor.
  • Registry key cleanup for stale OneDrive state: Residual keys under HKCU\Software\Microsoft\OneDrive\Accounts\Business1 can prevent a fresh KFM attempt — delete the Business1 key before the rollout.
  • Windows 11 version requirement: KFM requires Windows 11 version 22H2 or later — verify the build number (WinVer) and apply the Feature Update if needed.

ADVERTISEMENT

Why Known Folder Move Fails During Windows 11 Setup

Known Folder Move fails during Windows 11 rollouts because the OneDrive sync engine cannot claim the target folders at the moment it tries to redirect them. The root cause is almost always one of three conditions: a group policy that blocks OneDrive sync entirely, leftover registry data from a previous OneDrive account that conflicts with the new setup, or the Windows 11 build being older than 22H2 where KFM is not fully supported.

When a GPO sets “Prevent the usage of OneDrive for file storage” to Enabled, the OneDrive client will not show the Known Folder Move prompt during setup. Instead, it silently skips the redirection step. Similarly, if a user profile already contains registry entries from a prior OneDrive session — for example, during a test deployment or a failed pilot — the client reads those stale keys and tries to reuse a broken account state, causing KFM to fail before it completes.

The Windows 11 build number matters because Microsoft added critical KFM reliability improvements in version 22H2. On builds earlier than 22H2, the OneDrive client may crash or hang when attempting the folder move. Always confirm that the target devices run Windows 11 22H2 or later before starting the KFM deployment.

Steps to Fix Known Folder Move Failure on Windows 11

Follow these steps in order. Each step assumes you have administrative rights on the Windows 11 device and access to Group Policy Management Console if you are in a domain environment.

  1. Check the Windows 11 build number
    Press Windows key + R, type winver, and press Enter. Look for “Version 22H2” or later. If the build is older, install the Feature Update to Windows 11 22H2 from Windows Update or your deployment tool.
  2. Review and remove conflicting group policies
    Open Group Policy Management Console (GPMC) as an administrator. Navigate to Computer Configuration > Administrative Templates > Windows Components > OneDrive. Double-click “Prevent the usage of OneDrive for file storage.” Set it to Not Configured or Disabled. Run gpupdate /force on the target device.
  3. Clear stale OneDrive registry entries
    Open Registry Editor (regedit) as an administrator. Navigate to HKEY_CURRENT_USER\Software\Microsoft\OneDrive\Accounts\Business1. Right-click the Business1 key and select Delete. Close Registry Editor.
  4. Reset the OneDrive client
    Press Windows key + R, type %localappdata%\Microsoft\OneDrive\onedrive.exe /reset, and press Enter. Wait 30 seconds. If OneDrive does not restart automatically, launch it from the Start menu.
  5. Run Known Folder Move through the OneDrive Settings
    Right-click the OneDrive cloud icon in the notification area and select Settings. Go to the Sync and backup tab. Click Manage backup. Select the folders you want to redirect (Desktop, Documents, Pictures). Click Start backup. Wait for the green checkmarks to appear.
  6. Verify the folder redirection
    Open File Explorer and navigate to your user folder. Confirm that Desktop, Documents, and Pictures now show the OneDrive icon in the address bar. Open each folder and verify that the files are syncing.

ADVERTISEMENT

If Known Folder Move Still Has Issues After the Main Fix

OneDrive shows “This folder can’t be moved” error

This error appears when a file or subfolder in Desktop, Documents, or Pictures has a path longer than 260 characters. Open the affected folder, locate files with long paths using PowerShell command Get-ChildItem -Path "C:\Users\%USERNAME%\Documents" -Recurse | Where-Object { $_.FullName.Length -gt 260 }, and shorten the folder names or move the files to a shorter path. Then retry KFM.

OneDrive sync app is not installed during Windows 11 setup

Windows 11 includes OneDrive by default, but some enterprise images remove it. Verify the installation by searching for “OneDrive” in the Start menu. If missing, download the OneDrive sync app from https://go.microsoft.com/fwlink/?linkid=844652 and install it. Then repeat the KFM steps above.

KFM fails with error code 0x80040c97

Error 0x80040c97 indicates that the OneDrive account is not licensed for KFM. Go to the Microsoft 365 admin center, select Users > Active users, click the affected user, and verify that they have a license that includes OneDrive (Business Basic, Business Standard, Business Premium, or E3/E5). Assign the correct license if needed. Wait 15 minutes for the license to propagate, then retry KFM.

Known Folder Move via GPO vs Manual Setup: Key Differences

Item GPO-based KFM Deployment Manual KFM Setup
Description Administrators configure KFM through Group Policy and deploy it silently during user logon Each user enables KFM through the OneDrive Settings > Sync and backup > Manage backup
Prerequisites Windows 11 22H2, OneDrive build 22.222 or later, domain-joined device, GPO linked to the OU Windows 11 22H2, OneDrive sync app installed, user logged in with work or school account
User interaction None — KFM runs in the background after the user signs in User must manually click Start backup and wait for the sync to complete
Error handling Errors are logged in Event Viewer under Applications and Services Logs > Microsoft > Windows > OneDrive Errors appear as a red X in the sync status or a popup message
Best for Large-scale rollouts where IT wants consistent folder redirection without user prompts Small teams, pilot users, or individual devices where IT does not manage the device centrally

Known Folder Move can complete successfully on Windows 11 when you address the three main blockers: outdated build, conflicting group policies, and stale registry entries. After applying the fixes above, run KFM through the OneDrive settings or a GPO deployment to redirect Desktop, Documents, and Pictures. For ongoing management, monitor the KFM status using the OneDrive admin center Reports > Usage reports > OneDrive for Business activity. An advanced tip: use the Set-SPOTenantSyncClientRestriction PowerShell cmdlet to block sync on unmanaged devices while allowing KFM to proceed on compliant Windows 11 devices.

ADVERTISEMENT