Transition from the previous OneDrive for Business sync client

Transition from the previous OneDrive for Business sync client

Last updated: December 2017

This article is for Office 365 admins whose users are running the previous OneDrive for Business sync client (Groove.exe) on Windows computers and who want to upgrade to the new OneDrive sync client (OneDrive.exe) to sync files in OneDrive for Business and SharePoint Online.

If you're not an IT admin, see Get started with the new OneDrive sync client in Windows to learn how to begin syncing files using the new OneDrive sync client.

Important: 

  • If your organization never used the previous OneDrive for Business sync client, or had fewer than 250 licensed Office 365 users in June 2016, your users must use the new OneDrive sync client to sync OneDrive for Business and SharePoint Online files.

  • The new OneDrive sync client supports Windows 10, Windows 8.1, Windows 8, and Windows 7. It doesn't yet support syncing on-premises instances of OneDrive for Business or SharePoint Server (when your organization doesn't subscribe to an Office 365 business plan).

If you're ready now, download the latest version of the new OneDrive sync client that's fully released to production. To learn about other versions that are rolling out to different rings, see New OneDrive sync client release notes.

Installation and setup guides for users are available for syncing OneDrive in Windows, OneDrive on Mac OS X, and SharePoint files on Windows and Mac.

Overview

When users who are syncing files with the previous OneDrive for Business sync client (Groove.exe) sign in to the new OneDrive sync client (OneDrive.exe), the following things happen:

  • If the new OneDrive sync client can take over syncing a library, the previous sync client stops syncing it and the new OneDrive sync client takes over syncing it without re-downloading the content. If the new OneDrive sync client can't sync the library, the previous sync client continues to sync it. If a library requires checkout or has required columns or metadata, it will be synced read-only.

  • The previous sync client stops running and removes itself from automatic startup, unless it’s still syncing libraries that the new OneDrive sync client can't sync.

When SharePoint Online libraries begin syncing with the new OneDrive sync client, the folder hierarchy that appears in File Explorer may be simplified.

The following library types are not yet supported by the new OneDrive sync client, and will not transition from the previous sync client:

  • On-premises instances of OneDrive for Business and SharePoint Server (when your organization doesn't subscribe to an Office 365 business plan).

  • SharePoint Online libraries with Information Rights Management enabled on them. For info about previewing this functionality, see enable users to sync IRM-protected files.

  • SharePoint Online libraries that people from other organizations shared that your users are syncing with the previous sync client.

Prerequisites

  1. Make sure users have the following versions of Office or higher installed. For info about deploying Office, see Choose how to deploy Office 365 ProPlus. Make sure you don't install the previous OneDrive for Business sync client. For info, see Changes to the previous OneDrive sync client (Groove.exe) in Office 2016 Click-to-Run.

    Office version

    Minimum version

    Office 365 ProPlus

    16.0.7167.2*

    Office 2016 MSI

    16.0.4432.1*

    Office 2013 MSI/C2R

    15.0.4859.1*

    Note: If Office 2010 is installed on a computer, the SharePoint Workspace component must be removed. Before starting OneDrive Setup, either uninstall Office 2010 or remove the SharePoint Workspace component of Office 2010.

  2. Make sure users have version 17.3.6743.1212 or higher of the new OneDrive sync client installed. For info about deploying the OneDrive sync client, see Deploy the new OneDrive sync client in an enterprise environment.

Configure takeover

  1. In the SharePoint admin center, set SharePoint to sync with the new sync client. If the options aren't available, the new OneDrive sync client is already set up to sync OneDrive for Business and SharePoint Online files.

  2. If you're running Windows 10, you can use silent account configuration to sign in users. For info, see (Preview) Silently configure OneDrive using Windows 10 or domain credentials.

Run the takeover command

If you don't run the takeover command, users transition to the new sync client by:

  • Launching OneDrive Setup (first-time users of the new OneDrive sync client).

  • Setting up additional libraries (existing users of the new OneDrive sync client).

To automatically transition file syncing without the need for user interaction, you can run the takeover command. Use a tool such as System Center Configuration Manager (SCCM) and run the following command for each user on a PC:

%localappdata%\Microsoft\OneDrive\OneDrive.exe /takeover

Tips: 

  • Make sure to run the command in a user context, rather than as admin, or the user will see a "OneDrive.exe cannot be run with Admin privileges" error.

  • To affect all users on computer, configure the command to run on every user account. This will ensure that it's executed for any user who signs in. For an example of how to deploy an .exe on every user account, see How to deploy the OneDrive sync client with SCCM.

Block the previous sync client from syncing

To prevent users from using the previous OneDrive for Business to sync their OneDrive for Business and SharePoint Online files, run the following command in Microsoft PowerShell:

Set-SPOTenantSyncClientRestriction [-GrooveBlockOption <String> “OptOut”|”HardOptIn”|”SoftOptIn”] 

For more information, see Get-SPOTenantSyncClientRestriction. For information about using PowerShell, see Introduction to the SharePoint Online Management Shell.

Additional resources

See the following article for more info about the new OneDrive sync client.

Title

Description

Deploy the new OneDrive sync client in an enterprise environment

Deploy the OneDrive sync client to Windows users in your organization.

Get started with the new OneDrive sync client in Windows

How Windows users can set up the OneDrive sync client.

Get started syncing SharePoint sites with the new OneDrive sync client

Use the OneDrive sync client to sync SharePoint Online files.

Use Group Policy to control OneDrive sync client settings

Configure the OneDrive sync client using Group Policy.

Restrictions and limitations when you use the new OneDrive sync client to sync OneDrive for Business libraries

Knowledge base article with info about file size limits and file name restrictions.

For admins and IT pros

The short icon for LinkedIn Learning. New to Office 365?
Discover free video courses for Office 365 admins and IT pros, brought to you by LinkedIn Learning.

Connect with an expert
Contact us
Expand your skills
Explore training

Was this information helpful?

Thank you for your feedback!

Thank you for your feedback! It sounds like it might be helpful to connect you to one of our Office support agents.

×