OneDrive Preprocessing Keeps Falling in a Pending State
Troubleshoot provisioning and permission issues causing preprocessing failures.
The Issue
Preprocessing Stuck
The preprocessing task remains in a pending state and never completes. This prevents the migration from proceeding to the data transfer phase.
What Preprocessing Does
- • Provisions OneDrive accounts for target users
- • Sets Site Collection Admin permissions for the migration account
- • Validates connectivity to target OneDrive locations
Preprocessing Flow
Root Causes
Provisioning Failures
The platform sends asynchronous requests to Microsoft to provision OneDrive accounts (200 users at a time). Sometimes, the request doesn't get processed by Microsoft and the provisioning fails.
Permission Setting Issues
The migration account needs Site Collection Admin permissions on target OneDrives. Incorrect AppId/AppSecret credentials in your connector typically cause these failures.
Troubleshooting Steps
Step-by-Step Resolution
Verify Target Addresses
Ensure target email addresses match those in SharePoint's User Profiles section. Check for typos or domain mismatches.
Confirm User Licensing
Verify users have OneDrive-enabled licenses in the Office 365 admin center. Not all licenses include OneDrive for Business.
Check Connector Credentials
Validate your AppId and AppSecret in the OneDrive connector settings. Regenerate credentials if necessary.
Manual Provisioning (if needed)
If automated provisioning keeps failing, use Microsoft's PowerShell scripts to pre-provision OneDrive accounts.
Set Permissions Manually
If permission setting fails, manually add the migration account as Site Collection Admin on target OneDrives.
Microsoft Documentation
Common License Issues
These license types do NOT include OneDrive for Business:
- ✗ Google Vault standalone license
- ✗ Exchange Online Kiosk
- ✗ Some Office 365 F1/F3 plans (check documentation)