Deploy the new OneDrive sync client in an enterprise environment

This article is for IT administrators planning to deploy the new OneDrive sync client to their OneDrive for Business users in work or school environments. To install the new OneDrive sync client for yourself, download it and read the Get started article.

In this article:

Software requirements

The new OneDrive sync client (OneDrive.exe) is supported on:

The new OneDrive sync client doesn't yet support on-premises instances of OneDrive for Business (when your organization doesn't subscribe to Office 365) or IRM content. For more information about the restrictions and limitations of the new OneDrive sync client, see Restrictions and limitations when you sync files and folders using the new OneDrive sync client.

Planning

When users set up new OneDrive sync client, it downloads everything in their OneDrive. Large numbers of file transfers can adversely impact your network performance. We recommend using a phased rollout to avoid performances issues when deploying to a large number of users.

Some additional things you might want to consider are:

  • Identify potential bottlenecks early – Consider making special considerations for groups of users who have a large number of large files. For example, video department users may have a large number of large video files that they will need to sync to OneDrive. You might consider asking them to sync their files at a time when network traffic is low.

  • Monitor performance – If you're doing a phased rollout, monitor network performance levels with your first rollout. You can use that information to help adjust the next set of rollouts accordingly.

  • Communicate the rollout to users – Make sure that your users clearly understand what is expected of them to keep your deployment plan on schedule. Before the rollout begins, you might want to communicate to them what is required when they see OneDrive Setup and how to get help if they encounter a problem.

Overview of the deployment process

There are three steps in the process:

  1. Install OneDrive.exe on your users' computers.

  2. Start OneDrive processes and optionally prompt users to sign in with their work or school account.

  3. Set your update ring (optional).

Important: If your users are currently using the OneDrive for Business sync client (Groove.exe), and you want to move them to the new OneDrive sync client, see Transition from the previous OneDrive for Business sync client before proceeding.

Step 1: Install OneDrive.exe

For the most part, you can deploy the new OneDrive for Business sync client like you would traditionally install applications on devices in your organization. If you're deploying to a large number of users, having familiarity with enterprise deployment tools such as System Center Configuration Manager (SCCM) to deploy .exe files and modify local system registries will be helpful.

Check if users already have the new OneDrive sync client

If the computers in your organization are running Windows 10, they already have the new sync client installed. If the computers have Office 2016 or Office 2013 (Home & Student, Home & Business, Professional, Personal, Home, or University) installed, they might also have the new sync client. Office is installed per machine, whereas OneDrive needs to be installed per user. If you plan on deploying Office to your organization, you will need to deploy OneDrive.exe separately for additional users on individual machines.

Deploy any administrative settings

To set registry keys on computers in your domain, you can use the OneDrive.admx and OneDrive.adml Group Policy files in the OneDrive Deployment Package. For more info, see Administrative settings for the new OneDrive sync client

Use System Center Configuration Manager to deploy the new OneDrive sync client

To deploy through System Center Configuration Manager, you can save the OneDriveSetup.exe installer for Windows to a local network share. Download the OneDriveSetup.exe installer for Windows

Tip: Try the sample SCCM package. Just update the OneDrive.exe path and the application owner.

To install the new OneDrive sync client on Windows, run the following command using System Center Configuration Manager:

Execute <pathToExecutable>\OneDriveSetup.exe /silent

(where pathToExecutable is a location on the local computer or an accessible network share).

Notes: 

  • This command must be run at user logon and using Administrator permissions. It must be run for each user on a machine.

  • If you run the command with no command line parameter, users will see the installation status. After installation, OneDriveSetup.exe will automatically execute OneDrive.exe and display OneDrive Setup to users. If you run the command with the /silent parameter, OneDrive.exe will be installed transparently and OneDrive Setup won't appear. You'll need to run OneDrive.exe with an additional command. If you want to control the launch of OneDrive across your organization, we recommend using the /silent parameter.

The installer will install the OneDrive executable file under %localappdata%\Microsoft\OneDrive.

Step 2: Help users sign in

OneDrive doesn't support single sign in using existing Office or Windows credentials, but you can help users sign in to the sync client in these other ways:

  • Use the following URL to start OneDrive Setup on users' computers. When users click to begin Setup, a sign-in window will appear for users can enter email address.

    odopen://

  • Use the following URL with each user's email address to start Setup and prepopulate user email addresses in the sign-in window.

    ddopen://sync?useremail=youruseremail@organization.com

  • Run the following command using System Center Configuration Manager (SCCM) script: %localappdata%\Microsoft\OneDrive\OneDrive.exe

    It starts the OneDrive process. If users haven't set up any accounts, it displays OneDrive Setup. To display OneDrive Setup specifically to users who haven't set up an account for your tenant, use the command line parameter /configure_business:<tenantId>

Notes: 

  • When you use System Center Configuration Manager, make sure you run OneDrive.exe with User permissions (not as an Administrator).

  • For help finding your tenant ID, see Find your Office 365 tenant ID.

Step 3: Set your update ring (Optional)

For large enterprises, you may find you would like to delay updates to the OneDrive.exe client. Administrators have the ability to set the update ring of their organizations to Enterprise Tier. Machines on the Enterprise Tier are delayed updates to the OneDrive.exe client until updates have been fully rolled out and validated against Production (1-2 weeks).

You can set your update ring by configuring the Delay updating OneDrive.exe until the second release wave policy in the OneDrive.admx template file included in the OneDrive Deployment Package. For more information, see Administrative settings for the OneDrive for Business Next Generation Sync Client.

Additional resources

For additional resources about the new OneDrive sync client:

Title

Description

Get started with the new OneDrive sync client in Windows

Learn how Windows users can configure the new OneDrive sync client for their work or school accounts.

Get started with the new OneDrive sync client on Mac OS X

Learn how Mac users can configure the new OneDrive sync client for their work or school accounts.

Configure the new OneDrive sync client on macOS

Learn how administrators can use options for configuring the new OneDrive sync client on Mac computers.

Transition from the previous OneDrive for Business sync client

Learn how Windows users can transition from the previous OneDrive for Business sync client to the Next Generation Sync Client.

Administrative settings for the new OneDrive sync client

Learn how administrators can control and manage the new OneDrive sync client for their users through Group Policy.

Which OneDrive sync client am I using?

Learn how to easily tell which OneDrive sync client you are using.

Restrictions and limitations when you sync files and folders using the new OneDrive sync client

Knowledge base article with release notes, limits, and restrictions (such as invalid characters in file names).

Share Facebook Facebook Twitter Twitter Email Email

Was this information helpful?

Great! Any other feedback?

How can we improve it?

Thank you for your feedback!

×