Deploying the new OneDrive sync client on OS X and configuring work or school accounts

The OneDrive for Business Next Generation 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 for Business sync client and sync all your files to your computer.

This article is for IT Administrators. If you're not an IT Administrator, read Get started with the OneDrive for Business Next Generation Sync Client on Mac OS X or download the Sync Client from the Mac app store.

The OneDrive for Business Next Generation Sync Client is supported on OS X version 10.9 and above. It is available only through the Mac app store.

Configuring settings for how OneDrive should behave when syncing work or school accounts

The OneDrive Next Generation Sync Client provides a number of options to IT administrators that enable them to configure how OneDrive for Business behaves when syncing files.

To configure the available settings in the new sync client, you need to use defaults in Mac OS X to set or change the new sync client's behavior for syncing work and school accounts. When changing an existing setting or applying a new one, you'll need to follow these basic steps:

  1. Shut down the new sync client if it is running (all instances, if you have multiple running).

  2. Make your changes to the new sync client settings.

  3. Restart the defaults cache (use the command “killall cfprefsd”).

  4. Launch the new sync client.

Whenever it is launched, the new sync client will check the various key/value pairs defined in its defaults domain/plist, and adjusts its behavior accordingly.

Overview of settings

The following settings are available for using work or school accounts with the new sync client:

  • Disabling sync of personal/consumer OneDrive accounts

  • Setting the default location for the "OneDrive - {tenant name}" folder created locally

Block configuring and syncing of personal/consumer OneDrive accounts

This setting blocks users from syncing files from their consumer (Microsoft account-based) OneDrive accounts. Users are prevented from setting up a sync relationship with their personal accounts, and existing sync relationships with consumer accounts will no longer work. No synced files are deleted from the computer. No other sync relationship is affected.

To enable this setting, run the following command:

defaults write DisablePersonalSync -bool True

Set the default location for the local "OneDrive - {tenant name}" folder

This setting allows you to set a specific path as the default location of the OneDrive folder when users configure their work or school account. If you do not enable this setting, the local "OneDrive - {tenant}" folder location will default to the user's home directory.

Because this setting is tenant-specific, you need your tenant ID. This setting is configured using a nested dictionary in the preferences plist for The outer dictionary ("Tenants") contains key/value pairs of tenant IDs (the key), and a dictionary of specific settings for that tenant (the value):

Tenants = {
	"{tenant ID/GUID}" = {
		{tenant-specific preferences}

To assist with configuring this nested dictionary of settings, the following example demonstrates how to do this using the PlistBuddy command line utility.

Execute this command (where <TenantID> is substituted with your tenant ID):

/usr/libexec/PlistBuddy -c "Add :Tenants:<TenantID>:DefaultFolder string '<PathToFolder>'" ~/Library/Containers/

Validating that your settings changes have been recorded

You can always check what settings you have configured by running the following command:

defaults read

Installing the new sync client on users' computers

To install the OneDrive Next Generation Sync Client on users' computers, users need to go to the App Store app on the local machine, and install the application from there. Like any other application installed from the Mac App Store, they will get future updates to the application via the app store.

Once the application is launched, users will be taken through the Welcome to OneDrive wizard and, depending on how you've configured the new sync client using the options in this article, will be prompted to configure either a work or school account, or a personal OneDrive account.

See Also

Deploy the new OneDrive Sync Client (OneDrive.exe) in an enteprise environment

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

OneDrive client in the Mac App Store

OneDrive for Business Next Generation Sync Client download package for Mac

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!