OneDrive Profile Update After Tenant-to-Tenant Migration Print

This KB specifically applies to tenant-to-tenant migrations in Microsoft 365. It ensures that the OneDrive sync client is reconfigured to point from the Source Tenant (previous organization) to the Target Tenant (new organization) after cloud-level migration of user data.

Scope

• End-users who have completed migration from Source Tenant (Old Company) to Target Tenant (New Company).
• Windows and macOS devices running OneDrive for Business.

Prerequisites

• Cloud migration of user data must be complete.
• User accounts must be active in the Target Tenant.
• Administrative communication should confirm migration completion before proceeding.

Procedure

Step 1: Disconnect from the Source Tenant

1. Access OneDrive Settings:
   • Right-click the blue cloud icon in the system tray (Windows) or menu bar (macOS).
   • Select Settings.
2. Unlink the Account:
   • In the Account tab, locate the Source Tenant account (e.g., user@oldcompany.com).
   • Click Unlink this PC and confirm.
3. Clear Saved Credentials:
   • Windows: Open Credential Manager → Windows Credentials → remove cached OneDrive/Office credentials tied to the Source Tenant.
   • macOS: Open Keychain Access → delete OneDrive/Office entries referencing the Source Tenant.

Step 2: Connect to the Target Tenant

1. Launch OneDrive Setup:
   • Open the OneDrive app from Start Menu (Windows) or Applications (macOS).
2. Sign In with New Account:
   • Enter the Target Tenant email (e.g., user@newcompany.com).
   • Provide the updated password.
3. Select Folder Location:
   • Accept the suggested new folder path or reuse the old folder when prompted.
4. Complete Setup:
   • Configure sync preferences (Files On-Demand recommended).

Step 3: Post-Migration Cleanup

1. Verify Sync:
   • Ensure icons show green checkmarks or blue cloud icons.
   • Status should display "Up to date."
2. Remove Old SharePoint/Teams Links:
   • Stop syncing or unlink non-working folders from the Source Tenant.
   • Re-sync libraries from the Target Tenant.

Troubleshooting Login Issues After Migration

These login issues typically occur in tenant-to-tenant migrations when cached credentials or old tenant references remain on the device. Clearing them ensures the OneDrive client correctly authenticates against the Target Tenant.

1. Repeated Credential Prompts

• Cause: Cached credentials from the Source Tenant remain.
• Resolution: Delete all old tenant credentials from Credential Manager (Windows) or Keychain Access (macOS), then restart OneDrive.

2. OneDrive Stuck on "Signing In"

• Cause: Corrupted OneDrive cache or incomplete unlinking.
• Resolution: Exit OneDrive, delete cache folder at %localappdata%\Microsoft\OneDrive (Windows), relaunch and retry login.

3. Sync Errors or "Access Denied"

• Cause: Attempting to sync with Source Tenant libraries.
• Resolution: Verify account is Target Tenant, remove old SharePoint/Teams links, re-add from Target Tenant.

4. Incorrect Folder Mapping

• Cause: User selected a new folder instead of reusing the old one.
• Resolution: Unlink account, restart setup, select "Use this folder" to reuse old path.

5. OneDrive Client Not Launching

• Cause: Outdated or corrupted OneDrive client.
• Resolution: Download and install the latest OneDrive client from Microsoft, retry login with Target Tenant credentials.

Summary

By disconnecting from the Source Tenant, clearing cached credentials, and reconnecting to the Target Tenant, OneDrive can be successfully reconfigured after migration. The troubleshooting section ensures common login issues are quickly resolved, minimizing downtime for end-users.