Plan to deploy the new OneDrive sync client in an enterprise environment

The new OneDrive sync client lets you connect and sync files from your OneDrive for Business. You can add a work or school account to the new OneDrive sync client and sync all your files to your computer.

This article will help IT-Administrators with information they need to address key considerations when planning to deploy the new OneDrive sync client for their business users in an enterprise environment. This includes information about:

  • How to get the new OneDrive for Business sync client

  • An overview of deployment steps

  • Deciding what deployment method is best for you and your enterprise

  • How to update the new OneDrive for Business sync client

  • Links to additional resources about the new OneDrive for Business sync client

We highly recommend reading this article before you attempt to deploy the new OneDrive for Business sync client in your enterprise environment. When you are ready to deploy, see Deploying the OneDrive for Business Next Generation Sync Client in an enterprise environment for detailed information.

In this article:

What are the software requirements to run the OneDrive for Business Next Generation sync client?

The new OneDrive for Business sync client is only supported in:

  • Windows 10

  • Windows 8.1

  • Windows 8

  • Windows 7

The OneDrive for Business sync client also supports editing documents at the same time with other people and sharing documents from Office apps when you're using Office 2016 (C2R version 16.0.6741.2027 and higher). Integration with the Office 2016 MSI version is coming at a later date. For more information about installing Office 365, see Install Office on your PC or Mac.

The new OneDrive for Business sync client also doesn't yet support syncing site libraries or on-premises instances of OneDrive for Business (when your organization doesn't subscribe to Office 365). For more information about restrictions and limitation, see Restrictions and limitations when you sync OneDrive for Business libraries through OneDrive for Business.

Overview of the deployment process

The goal of the IT administrator in deploying the new OneDrive for Business sync client to their enterprise users is to install OneDrive.exe to each user’s machine and assist users in signing in to OneDrive using their Office 365 business accounts. This will enable them to use the new OneDrive for Business sync client.

There are three steps in this process that an IT administrator needs to understand:

Steps

Description

1

Deploy OneDrive.exe to your users

Use the OneDriveSetup installer to deploy the sync client to your users machines

2

Launch OneDrive.exe

Start OneDrive on your users machines. This allows your user to enter OneDrive Setup, depending on the parameters you select.

3 (optional)

Set your update cadence

This optional step allows an administrator to set when their users receives updates to their sync clients.

These steps are described in detail in Deploying the OneDrive for Business Next Generation Sync Client in an enterprise environment.

Important: If your users are currently using the OneDrive for Business Sync Client (Groove.exe) for their work and business files, and you want to move them to the new OneDrive for Business sync client, see Transition from the previous OneDrive for Business sync client. You will need to make some additional considerations to ensure that the transition is successful.

Does my organization already have the new OneDrive for Business sync client?

You can download the OneDrive for Business Next Generation Sync Client and read the Get started article if you want to install and the use the new sync client right now.

However, you should first verify if you users already have the new OneDrive for Business sync client. If any of the following conditions apply to your organization, you already have the new OneDrive for Business sync client installed.

  • Your organization is using Windows 10.

  • Your organization is running any version of Office 2016.

  • Your organization is running the following versions of Office 2013: Home & Student, Home & Business, Professional, Personal, Home, or University.

What's the right deployment method for me?

There are three deployment scenarios IT administrators will need to consider when planning to deploy the OneDrive.exe client to their enterprise users:

  • I just want to install the OneDrive.exe client on users’ machines

  • I want to install the OneDrive.exe client on users’ machines, and have them configure their business accounts

  • I want to display OneDrive Setup only to users who still need to set up their business accounts

I just want to install the OneDrive.exe client on user’s machines

Maybe all you’re interested in is getting the new OneDrive sync client onto your users’ machines. If all you want to do is install OneDrive.exe on a machine you can use either SCCM or a Group Policy script to execute the following:

Execute <pathToSomeAccessibleNetworkShare>\OneDriveSetup.exe /silent

Result: OneDrive.exe is installed transparently on your users’ machines, but it is not automatically launched. Users can launch OneDrive.exe by opening their OneDrive folder in File Explorer, or by launching OneDrive from the start menu. Or IT administrators at any time later can run %localappdata%\Microsoft\OneDrive\OneDrive.exe through SCCM or Group Policy script to automatically open OneDrive.exe on the users machine.

I want to install the OneDrive.exe client on users’ machines, and have them connect their business accounts

In what is likely the most common scenario, you’d like to install OneDrive.exe onto your users’ machines and have them sign in to OneDrive.exe with their business accounts as soon as possible. You can use either SCCM or Group Policy script to execute the following steps:

  1. Execute <pathToSomeAccessibleNetworkShare>\OneDriveSetup.exe /silent

  2. Execute %localappdata%\Microsoft\OneDrive\OneDrive.exe /configure_business:<tenantId>

Result: OneDrive.exe is installed transparently on your users’ machines, and the ones who have not yet signed in to OneDrive with the desired tenant are displayed the OneDrive Setup to configure their business accounts.

Note: These commands do not automatically sign the user into OneDrive to configure their business account, but only prompts them to do so by displaying OneDrive Setup. The user must still sign into OneDrive in order to configure their business account.

I want to display OneDrive Setup only to user who still need to set up their business accounts

In this scenario, some time has passed since you installed the OneDrive.exe client on your users machines and you’re not sure whether your all your users have connected their business accounts. To be sure, you want to relaunch OneDrive Setup, but only to those users who haven’t yet set up a business account. You can use either SCCM or Group Policy script to execute the following:

Execute %localappdata%\Microsoft\OneDrive\OneDrive.exe /configure_business:<tenantId>

Result: Again, in this case, the /configure_business:<tenantId> parameter allows IT administrators to target the displaying of OneDrive Setup only to users who still have not yet set up a business account with the desired tenant.

How is OneDrive.exe updated?

OneDrive.exe checks for updates daily and automatically applies any updates on behalf of the user. This ensures that your machines come equipped with the latest features and always have the highest quality builds.

Use enterprise deployment tools with the OneDrive Deployment Package

For the most part, you can deploy the new OneDrive for Business sync client like you would traditionally install applications on devices in your environment. If you are deploying to a large number of users, having familiarity with enterprise deployment tools such as System Center Configuration Manager 2012 (SCCM) or Group Policy to deploy .exe files and modify local system registries will be helpful in getting the most out of this article. For more guidance about using Microsoft System Center 2012 Configuration Manager, see the Configuration Manager TechNet content set.

The OneDrive Deployment Package contains OneDrive.admx and OneDrive.adml Group Policy files that you can use to set registry keys on computers in your domain, which the OneDrive sync client (OneDrive.exe) recognizes.

The OneDrive Deployment Package contains:

  • ADMX and ADML templates

  • URL files pointing to deployment and administration documentation

For information about using the OneDrive.admx file to set OneDrive.exe settings on computers in your domain through Group Policy, see Administrative settings for the OneDrive for Business Next Generation Sync Client.

Plan for performance issues

IT administrators need to plan for performance issues that might happen when deploying the new OneDrive sync client to users in their enterprise. After receiving the new OneDrive sync client and configuring their business accounts for file sync, a large number of users all syncing a large number of files across your networks might adversely impact network performance.

One of the most effective ways to address performance issue when deploying to a large number of users is using a phased rollout. Limiting the number of users who might be syncing their files over the same time period will help to throttle the amount of traffic on your network.

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 user 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 during time when network traffic is low.

  • Monitor performance – If you are 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.

  • Communication is key – 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 who to talk to if they encounter a problem.

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 Next Generation Sync Client.

Get started with the OneDrive for Business Next Generation Sync Client on Mac OS X

Learn how Mac users can configure the Next Generation Sync Client.

Deploying the OneDrive Next Generation Sync Client on OS X and configuring work or school accounts

Learn how administrators can use options for configuring the OneDrive Next Generation Sync Client on Mac OS X 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 OneDrive for Business Next Generation Sync Client

Learn how administrators can control and manage the Next Generation 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 OneDrive for Business libraries through OneDrive for Business

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!

×