Microsoft Previews odsync OneDrive Sync CLI for Admin Diagnostics and JSON Automation

Anyone who has spent a Friday afternoon on a remote session, digging through a user's OneDrive settings to find out why their Desktop isn't backing up, will want to hear this. Microsoft is working on a command-line tool for the OneDrive sync client, and it is meant for admins rather than end users.

Neowin reported that during the OneDrive + Copilot event today, the company showcased a new OneDrive Sync Client Command Line Interface (CLI), which gives admins a way to manage OneDrive sync deployments through the command line. The tool is still in preview, and Microsoft hasn't given a release date. Even so, it targets a real problem in managing OneDrive across a fleet of PCs.

What Microsoft showed​

The demo used a command named odsync. According to Neowin, the preview shown during the event uses the odsync command, and shows that the CLI is still in preview. A Microsoft screenshot from the event also labels the interface as a preview build.

Based on the demo, the preview can report on:

• Configured OneDrive accounts. It can handle devices with several configured accounts, and admins can filter the results down to one account.
• Version information for both the OneDrive sync client and the CLI.
• Folder backup configuration. It can show which accounts are signed in and which folders are being automatically backed up.
• Applied policies. Admins can also inspect the Group Policies configured on a device to check whether it's compliant.
• Client state. Microsoft's demo also showed the CLI reporting whether the OneDrive client is running and how it was installed.
• Overall status at the client, account and folder-backup level.

Neowin also reports that the tool can turn on verbose diagnostics and output results as JSON. For anyone building automation, the JSON option is probably the most important part. Text formatted for people tends to break scripts. Structured output can be parsed reliably.

In short: odsync is a read-only diagnostic tool in what Microsoft has shown so far. It reports on accounts, versions, folder backup, policies and client state, with JSON output for scripts.

The problem it's meant to solve​

Microsoft's explanation is straightforward. Per Neowin, while admins can already see which devices are healthy or out of compliance, actually troubleshooting those devices is still largely a manual process. The new OneDrive Sync CLI is meant to tackle that by providing real-time information and making those processes easier to script and automate.

That fills a gap in Microsoft's existing tools. Microsoft's own OneDrive sync release notes say the OneDrive Sync health dashboard lets administrators monitor sync health and spot problems. In November 2025, that dashboard was extended to GCC, GCC High and DoD environments. The dashboard shows you which device has a problem. It doesn't help much with the next step, which is finding out what is actually configured on that machine. A local CLI that returns policy state, signed-in accounts and folder backup status in a parseable format would cover exactly that step.

Where it fits in a OneDrive management setup​

Microsoft Learn's sync planning guidance lists the current ways to deploy the OneDrive sync app: manually, with scripts, through Windows Autopilot, through an MDM solution such as Intune, or with Microsoft Endpoint Configuration Manager. On Windows, settings are managed through Group Policy, which requires Active Directory domain join, or through Intune administrative templates. Macs use .plist files instead.

That is why the policy check in odsync matters. Known Folder Move, for example, is controlled by policies Microsoft documents as KFMSilentOptIn, KFMOptInWithWizard, KFMBlockOptOut and KFMBlockOptIn. Tenant restrictions use AllowTenantList and BlockTenantList. If one command can show which policies actually reached a device, admins can answer "did the GPO apply?" without searching the registry by hand.

Microsoft has added command-line controls to the sync client before, though on a smaller scale. The macOS release notes describe a feature that lets administrators register or unregister the OneDrive login item with command-line arguments, so auto-start can be controlled programmatically on managed Macs. That was a single switch. odsync looks like a much broader reporting tool.

Community tools have filled this gap for years. ODSyncUtil, an open-source utility, reports the real-time sync status of the OneDrive client (Personal, Business, and SharePoint sync roots) by using the modern IStorageProviderStatusUISource COM API available in Windows 11 (and recent builds of Windows 10) to obtain the same status information Windows Explorer shows in the OneDrive flyout. Tools like that read the same sync status Explorer shows. A first-party CLI that also reports policies, install type and folder backup configuration could replace some of those scripts, if Microsoft supports it properly.

In short: the dashboard flags the problem device, Group Policy and Intune push the settings, and odsync would let admins confirm what actually ended up on the device.

What we don't know yet​

The demo was promising, but plenty is still undocumented. Based on what Microsoft has made public so far, none of the following is known:

• Syntax. Microsoft hasn't published a command reference. The only confirmed detail is the odsync command name. Don't build scripts around commands you saw in a demo screenshot.
• Platforms. It's not clear whether the preview runs only on Windows or also on macOS.
• Permissions. Nobody has said whether it needs elevation, or whether it can query other users' sessions on a shared machine.
• JSON stability. Preview output formats often change. A schema that shifts between builds will break anything that parses it.
• Remote and central use. The demo showed a tool that runs on one device. Nothing shows remote execution, central reporting, alerting, or direct integration with Intune.
• Repair. Everything shown is inspection and diagnostics. There's no evidence the tool can fix sync problems or change configuration.

There's also a prerequisite that applies regardless. Microsoft Learn's release notes say the OneDrive sync app requires Windows 10 22H2 or Windows 11 to receive updates. Since August 15, 2026, devices on older Windows 10 versions stay on whatever build they have. Microsoft hasn't listed system requirements for the CLI, but if it ships with or depends on newer sync client builds, machines stuck on old Windows 10 releases may never get it. That's an assumption, not a confirmed requirement, but it's worth checking your inventory now.

Neowin also suggested that, although Microsoft never mentioned AI agents running the CLI, structured JSON output makes agent-driven monitoring easy to imagine. That's a fair guess, but it's Neowin's speculation, not a Microsoft plan.

Availability​

Neowin reports that the OneDrive Sync CLI is coming soon, with no specific date set by Microsoft yet. Interested organizations can already sign up for early access. The event registration page on Microsoft's Tech Community confirms the OneDrive and Copilot focus of the event. It doesn't document the CLI, and no eligibility details for early access have been published.

The CLI was one of several announcements at the event. Neowin's coverage also mentions Hero Link sharing, higher file sync limits, better HTML and Markdown support, and a new Photos app. Those are separate features and don't tell us anything about how the CLI works.

What admins can do now​

You can't run odsync yet, but you can get ready:

• Sign up for early access if OneDrive troubleshooting takes up a noticeable share of your helpdesk time.
• Audit your Windows versions. Find devices below Windows 10 22H2 that have stopped receiving sync client updates.
• List the policies you care about, such as Known Folder Move, tenant allow and block lists, and the update ring, so you know what a compliance check should verify once the tool arrives.
• Note where you rely on community scripts for OneDrive status today. Plan to compare them with Microsoft's tool rather than replacing them on day one.
• Wait for the documentation before building anything for production. Whatever the demo showed can still change.

Analysis​

Microsoft has the right idea here. OneDrive has become the default home for Windows users' Desktop, Documents and Pictures folders, so the sync client is now critical infrastructure, and troubleshooting it shouldn't depend on screenshots and guesswork. Scriptable access to a device's account, policy and backup state, with JSON output, is what admins have wanted for years.

It's still only a preview, demonstrated at an event, with no date and no documentation. Until Microsoft publishes syntax, platform support and a stable output format, odsync is a promising preview, not a tool you can plan production work around.

Correction (October 20, 2026): the OneDrive sync health dashboard's GCC, GCC High and DoD support dates to November 2025 (release 25.199.1012.0002), not "earlier this year."