Sync Settings

Monitor OneDrive sync client status across managed devices. Identify users with sync issues, pending uploads, or outdated clients that may impact data protection. Configure sync policies to control which devices can sync and what content is synced.

Note: OneDrive storage is included with Microsoft 365 licenses. Default allocation is 1 TB per user, expandable to 5 TB for organizations with 5 or more licenses.

Sync Status Overview

Monitor sync health across all managed tenants:

Status	Count	Description
Syncing	142	Files up to date
Uploading	8	Pending uploads in progress
Paused	4	User or system paused
Error	2	Requires attention

Sync Client Settings

Setting	Description
Block sync on unmanaged devices	Only allow sync from domain-joined or compliant devices
Block specific file types	Prevent syncing of certain file extensions
Limit upload bandwidth	Throttle upload speed during business hours
Limit download bandwidth	Throttle download speed during business hours

Common Sync Issues

Issue Type	Count	Description	Resolution
Sync Conflict	23	Same file modified in multiple locations	User must resolve by keeping one version
File Name Issue	8	Invalid characters or path too long	Rename file or shorten path
Storage Full	3	OneDrive quota exceeded	Delete files or increase quota
Authentication Error	2	Sign-in required or token expired	User must re-authenticate

Known Folder Move

Redirect Windows Desktop, Documents, and Pictures folders to OneDrive for automatic backup:

Silently redirect — Move folders without user prompt (recommended for managed devices)
Prompt users — Ask users to move their known folders to OneDrive
Block redirect — Prevent users from stopping Known Folder Move once enabled

Device Restrictions

Control which devices can sync OneDrive content:

Restrict sync to specific Active Directory domains
Require device compliance for sync access (via Intune)
Block sync on macOS, Windows, or specific OS versions
Limit sync to managed devices only

Sync Status Monitoring

Track sync health metrics for proactive issue resolution:

Health Indicators

Green (Syncing) — Files up to date, client connected and healthy
Blue (Uploading) — Pending uploads in progress, monitor for stuck uploads
Amber (Paused) — User or system paused sync, may need investigation
Red (Error) — Sync error requiring attention, check error details

Monitoring Recommendations

Alert on sync errors persisting more than 24 hours
Track upload queue size for bandwidth planning
Monitor client version distribution across devices
Identify users with outdated sync clients

Best Practices

Sync Configuration

Enable Known Folder Move with silent redirect for all managed devices
Block sync on unmanaged and non-compliant devices
Set bandwidth limits during business hours to avoid network saturation
Block file types that should not be synced (e.g., .pst, .ost, database files)

Monitoring and Compliance

Monitor sync status for backup coverage gaps
Review sync errors weekly to identify systemic issues
Track client versions and push updates for outdated clients
Set alerts for users with prolonged sync failures
Document sync policies for compliance audits

API Reference


# Get OneDrive usage report including sync data
GET /reports/getOneDriveUsageAccountDetail(period='D30')


# Get user's OneDrive storage and sync status
GET /users/{user-id}/drive?$select=quota


# OpsPilot365 API - Cross-tenant sync status
GET /api/reports/onedrive/sync-status
{
  "tenantIds": ["tenant-1", "tenant-2"],
  "includeErrors": true
}

GET /api/onedrive/sync — Get sync settings
PUT /api/onedrive/sync — Update sync settings
GET /api/onedrive/sync/status — Get sync status across devices