Configure the new OneDrive sync client on macOS

This article is for IT administrators managing OneDrive for Business settings in work or school environments. If you're not an IT administrator, read Get started with the OneDrive for Business Next Generation Sync Client on Mac OS X.

Manage OneDrive settings on macOS using property list (Plist) files

Use the following keys to preconfigure or change settings for your users. The keys are the same whether you run the store edition or the standalone edition of the sync client, but the property list file name and domain name will be different. When you apply the settings, make sure to target the appropriate domain depending on the edition of the sync client.

Standalone

Mac App Store

PList Location

~/Library/Preferences/com.microsoft.OneDrive.plist

~/Library/Containers/com.microsoft.OneDrive-mac/Data/Library/Preferences/com.microsoft.OneDrive-mac.plist

Domain

com.microsoft.OneDrive

com.microsoft.OneDrive-mac

Deploy the sync client settings

Deploy the settings on macOS in the typical way:

  1. Quit the OneDrive application.

  2. Define the settings you want to change by creating a Plist with the values, or use a script to set the default values.

  3. Deploy the settings onto the local computer.

  4. Refresh the preferences cache.

    On the next start of OneDrive, the new settings will be picked up.

Overview of settings

The following table lists all the settings that are currently exposed for the OneDrive sync client. You need to configure the parameters in parentheses.

Setting

Description

Parameters

Example Plist Entry

Disable personal accounts

Blocks users from signing in and syncing files in personal OneDrive accounts. If this key is set after a user has set up sync with a personal account, the user will be signed out.

DisablePersonalSync (Bool): When set to true, this parameter prevents users from adding or syncing personal accounts.

<key>DisablePersonalSync</key>
<(Bool)/>

Default folder location

Specifies the default location of the OneDrive folder for each tenant

TenantID (String): TenantID determines which accounts the default folder location setting should apply to. Find your Office 365 tenant ID

DefaultFolderPath (String): DefaultFolder specifies the default folder location.

For the App Store edition, the path must already exist when users set up the sync client. For the Standalone edition, the path will be created on users’ computers if it doesn’t already exist.

<Key>Tenants</key>
<dict>
     <key>(TenantID)</key>
     <dict>
          <key>DefaultFolder</key>
          <string>(DefaultFolderPath)</string>
     </dict>
</dict>

Automatic upload bandwidth percentage

Enables the sync client to automatically set the amount of bandwidth used based on available bandwidth for uploading files

Bandwidth (int): This parameter determines the percentage of local upload bandwidth that the sync client can use. Accepted values are from 1 through 99.

<key>AutomaticUploadBandwidthPercentage</key>
<Int>(Bandwidth)</int>

Dock icon

Specifies whether a dock icon for OneDrive is shown

HideDockIcon (Bool): When set to true, this parameter hides the OneDrive dock icon even when the application is running.

<key>HideDockIcon</key>
<(Bool)/>

You can also configure the OneDrive Standalone sync client to receive delayed updates.

PList Location

~/Library/Preferences/com.microsoft.OneDriveUpdater.plist

Domain

com.microsoft.OneDriveUpdater

Setting

Description

Parameters

Example Plist Entry

Tier

Defines the update ring for the computer

UpdateRing (String): This parameter has two different values.

Production – The default update ring for OneDrive updates.

Enterprise – This update ring receives the same updates as production, several weeks after each update is fully distributed in the production ring.

<key>Tier</key>
<string>(UpdateRing)</string>
 
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!

×