Designed for Enterprise IT Support & Corporate Environments

O365

OneDrive Known Folder Move (KFM) Issues

Troubleshoot KFM prompts, partial Desktop/Documents sync, and blocked moves on managed devices without overriding enterprise OneDrive policies. This troubleshooting guide is mirrored from the Support Portal knowledge base for quick access in Corporate Tech Fixes.

Severity: MediumAdmin Required
Estimated Fix Time

10-20 min

Access Level

Admin Required

Total Steps

9

Author & Verification

Tamem J

IT Solutions Engineer

Last verified: March 3, 2026

Runbooks and troubleshooting guides are reviewed for enterprise-safe usage and avoid security bypass patterns.

Tested on Windows 11 23H2Tested on Windows 10 22H2

Trust Signals

No ratings yet

0 total helpfulness votes

  • Enterprise Microsoft 365 Administration
  • Endpoint Management (Intune, Jamf, Kandji)
  • Identity & Access (Entra ID, Okta)
#onedrive#known-folder-move#kfm#desktop#documents#windows#microsoft#support-kb

Note: “Download as PDF” opens the browser print dialog. Choose “Save as PDF” for a printable runbook copy.

Step-by-Step Resolution

Expand each section as needed

  1. 1

    Symptoms

    Info

    Recommended validation or troubleshooting step

    - Desktop/Documents/Pictures do not complete backup to OneDrive. - KFM prompt repeats or fails with policy-related messages. - Users see missing or duplicated folders after partial move.

  2. 2

    Likely Causes

    Info

    Recommended validation or troubleshooting step

    - KFM policy mismatch or tenant restrictions. - Unsupported existing folder redirection or permissions on user profile folders. - Low disk/network reliability during initial sync.

  3. 3

    Confirm scope, user impact, and reproduction

    Info

    Recommended validation or troubleshooting step

    Document whether the issue affects one user, multiple users, or multiple devices. Confirm exact error messages, recent changes (password reset, update, network change), and whether the same issue reproduces in web vs desktop workflows where applicable.

  4. 4

    Validate prerequisites and application/session state

    Info

    Recommended validation or troubleshooting step

    Confirm the user is signed in with the correct corporate account, system time is accurate, network/VPN connectivity is stable, and the application is not running in offline or limited mode.

  5. 5

    Run safe diagnostics from the Commands section

    Info

    Recommended validation or troubleshooting step

    Use the command snippets below to collect non-destructive diagnostics. Capture output in the ticket when escalation may be required. Avoid deleting profiles, cached credentials, or managed app data unless the runbook or admin approval explicitly allows it.

  6. 6

    Apply safe remediation steps

    Info

    Recommended validation or troubleshooting step

    - Confirm the device is using the correct work tenant and KFM is approved/enforced by policy. - Identify whether existing redirected folders or legacy backup agents are present. - Stabilize sync first, then retry KFM under desktop support guidance. - Do not manually move protected profile folders outside approved migration steps.

  7. 7

    Escalate when access, policy, or security controls are involved

    Warning

    Review carefully before proceeding

    - KFM policy conflicts with GPO/Intune settings or legacy folder redirection. - User profile permission issues or migration tooling is involved. - The device is at risk of data loss during folder redirection changes.

    Admin review or admin rights may be required for this step.

  8. 8

    Windows process/service quick check

    Command

    Includes a copyable command block

    Command
    Get-Process | Where-Object { $_.ProcessName -match "OneDrive" } | Select-Object ProcessName, Id, CPU
  9. 9

    When to Escalate to IT / Security

    Warning

    Review carefully before proceeding

    - KFM policy conflicts with GPO/Intune settings or legacy folder redirection. - User profile permission issues or migration tooling is involved. - The device is at risk of data loss during folder redirection changes.

Related Fixes by Exact Query

High-intent troubleshooting phrases mapped to related internal guides.