This article is for IT administrators managing OneDrive settings in work or school environments. If you're not an IT administrator, read Get started with the new OneDrive sync app on Mac OS X.
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 app, 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 app.
Nov 13, 2015 The feature I am talking about is OneDrive Sync. The idea is that you sync the whole SharePoint Document library to your computer, make changes on your desktop and all the changes automatically sync back to SharePoint when you have Internet Connection. How to Sync SharePoint Document Library with OneDrive. However, there is a way to sync your SharePoint site with your Mac without using OneDrive which will allow you to upload, edit, and save all your changes without ever having to login to SharePoint. On your Mac, in the upper right-hand corner click the Spotlight. Type Microsoft Document Connection and click Microsoft Document Connection. Microsoft Document Connection application will open, click Add Location. From the drop-down click Connect to a SharePoint Site 5. This article shows you how you can synchronise a SharePoint library with your local PC in a few simple steps. You may also want to check out the following articles as well: How to Setup the OneDrive Sync Client - You will need to have first configred the OneDrive Sync Client so that you can synchronise any SharePoint libraries. Navigate to the site library you wish to sync to your computer Click the Sync button at the top of the page When prompted, click Sync Now to start the sync app wizard After the sync is finished, you can navigate to the SharePoint folder on your computer to access your site library. We would like to show you a description here but the site won’t allow us. Deploy and configure the new OneDrive sync app for Mac. 2/27/2020; 5 minutes to read +2; In this article. This article is for IT administrators managing OneDrive settings in work or school environments. If you're not an IT administrator, read Get started with the new OneDrive sync app on Mac OS X. Upon installing it, I was immediately dismayed to learn that, unlike it's Windows counterpart, it cannot peform this simple task: synchronize a Sharepoint library to my Mac desktop. Mac users began voting on this suggestion in January, 2015 at https://onedrive.uservoice.com.
| 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 settings on macOS in the typical way:
Quit the OneDrive application.
Define the settings you want to change by creating a Plist with the values, or use a script to set the default values.
Deploy the settings onto the local computer.
Refresh the preferences cache.
On the next start of OneDrive, the new settings will be picked up.
The following table lists all the settings that are currently exposed for the OneDrive sync app. 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 organization | 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. Mac App Store: The path must already exist when users set up the sync app. Standalone: The path will be created on users' computers if it doesn't already exist. Only with the Standalone sync app can you prevent users from changing the location. | <key>Tenants</key> <dict> <key>(TenantID)</key> <dict> <key>DefaultFolder</key> <string>(DefaultFolderPath)</string> </dict> </dict> |
| Automatic upload bandwidth percentage | Enables the sync app to automatically set the amount of bandwidth used based on available bandwidth for uploading files | AutomaticUploadBandwidthPercentage (int): This parameter determines the percentage of local upload bandwidth that the sync app can use. Accepted values are from 1 through 99. | <key>AutomaticUploadBandwidthPercentage</key> <int>(Bandwidth)</int> |
| Set maximum upload throughput | Sets the maximum upload throughput rate in kilobytes (KB)/sec for computers running the OneDrive sync app | UploadBandwidthLimited (int): This parameter determines the upload throughput in KB/sec that the sync app can use. The minimum rate is 50 KB/sec and the maximum rate is 100,000 KB/sec. | <key>UploadBandwidthLimited</key> <int>(Upload Throughput Rate in KB/sec)</int> |
| Set maximum download throughput | Sets the maximum download throughput rate in kilobytes (KB)/sec for computers running the OneDrive sync app | DownloadBandwidthLimited (int): This parameter determines the download throughput in KB/sec that the sync app can use. The minimum rate is 50 KB/sec and the maximum rate is 100,000 KB/sec. | <key>DownloadBandwidthLimited</key> <int>(Download Throughput Rate in KB/sec)</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)/> |
| Open at login | Specifies whether OneDrive starts automatically when the user logs in | OpenAtLogin (Bool): When set to true, OneDrive will start automatically when the user logs in on the Mac. | <key>OpenAtLogin</key> <(Bool)/> |
| Enable Files On-Demand | Specifies whether Files On-Demand is enabled. If you don't set this setting, Files On-Demand will be enabled automatically as we roll out the feature, and users can turn the setting on or off | FilesOnDemandEnabled (Bool): When set to true, new users who set up the sync app will download online-only files by default. When set to false, Files On-Demand will be disabled and users won't be able to turn it on. | <key>FilesOnDemandEnabled</key> <(Bool)/> |
| Disable download toasts | Prevents toasts from appearing when applications cause file contents to be downloaded | DisableHydrationToast (Bool): When set to true, toasts will not appear when applications trigger the download of file contents. | <key>DisableHydrationToast</key> <(Bool)/> |
| Block apps from downloading online-only files | Prevents applications from automatically downloading online-only files. You can use this setting to lock down applications that don't work correctly with your deployment of Files On-Demand. | HydrationDisallowedApps (String): Json in the following format [{'ApplicationId':'appId','MaxBundleVersion':'1.1','MaxBuildVersion':'1.0'}]'AppID' can be either the BSD process name or the bundle display name. MaxBuildVersion denotes the maximum build version of the application that will be blocked. MaxBundleVersion denotes the maximum bundle version of the application that will be blocked | <key>HydrationDisallowedApps </key> <string> [{'ApplicationId':'appId','MaxBundleVersion':'1.1','MaxBuildVersion':'1.0'}, {'ApplicationId':'appId2','MaxBundleVersion':'3.2','MaxBuildVersion':'2.0'}]</string><(Bool)/> |
| SharePoint Server Front Door URL | Specifies the SharePoint Server 2019 on-premises URL that the OneDrive sync app should try to authenticate and sync against | SharePointOnPremFrontDoorUrl (string): The URL of the on-premises SharePoint Server. | <key>SharePointOnPremFrontDoorUrl</key> <string>https://Contoso.SharePoint.com</string> |
| SharePoint Server Tenant Name | Specifies the name of the folder created for syncing the SharePoint Server 2019 files specified in the Front Door URL. | SharePointOnPremTenantName (string): The name that will be used when creating a folder to sync the on-premises SharePoint Server files. If specified, the folder names will take the form of: OneDrive – TenantName TenantName If not specified, the folder names will use the first segment of the FrontDoorURL as the Tenant Name. Example - https://Contoso.SharePoint.com will use Contoso as the Tenant Name | <key>SharePointOnPremTenantName</key> <string>Contoso</string> |
| SharePoint OnPrem Prioritization | For hybrid scenarios where the email is the same for both SharePoint Server on-premises and SharePoint Online, determines whether or not the client should set up sync for SharePoint Server or SharePoint Online first during the first-run scenario. | SharePointOnPremPrioritizationPolicy (int): This parameter determines which service to attempt to authenticate against for setting up sync. 1 indicates OneDrive should setup SharePoint Server on-premises first, followed by SharePoint Online. | <key>SharePointOnPremPrioritizationPolicy</key> <int>(0 or 1)</int> |
| BlockExternalSync | Prevents the sync app from syncing libraries and folders shared from other organizations. | BlockExternalSync (Bool): Set to true to prevent syncing OneDrive for Business and SharePoint libraries and folders from organizations other than the user's own organization. Set to false or do not include the setting to allow. Learn about OneDrive B2B Sync. | <key>BlockExternalSync</key> <(Bool)/> |
You can also configure the OneDrive Standalone sync app 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. Insiders - This update ring receives updates that are 'pre-production' and will allow you to play with features before they are released. Note that builds from this ring may be less stable. Enterprise - This update ring receives updates after they have rolled out through the Production ring. It also lets you control the deployment of updates. For more info about the update rings and how the sync app checks for updates, see The OneDrive sync app update process. | <key>Tier</key> <string>(UpdateRing)</string> |
This article is for IT administrators in large organizations who want to enable users in their organizations to sync SharePoint team sites with the new OneDrive sync app. Smaller organizations and organizations that are new to Office 365 are already set up to sync OneDrive and SharePoint files with the new OneDrive sync app.
When you enable this feature, users will be able to sync the files in a SharePoint team site to their PCs and Macs using the OneDrive sync app (OneDrive.exe). As part of this, they will be able to:
Browse to a SharePoint site or shared folder and click Sync to sync all contents in the document library or only selected folders that are important to them.
Change the folders they sync directly from their PC or Mac.
Sync shared folders.
Sync read-only files and folders. Clear library cache mac.
Coauthor files in real time with Office 2016 (C2R build 16.0.7167.2xxx or MSI build 16.0.4432.100x)
Automatically transition from the existing OneDrive for Business sync app (Groove.exe)
To enable users in your organization to sync SharePoint team sites with the OneDrive sync app, you first need to deploy the OneDrive sync app to your organization.
See Deploy the new OneDrive sync app using Microsoft Endpoint Configuration Manager
See Deploy and configure the new OneDrive sync app for Mac
For info about the latest sync app releases, see New OneDrive sync app release notes.
Note
If you have Office 365 Germany, sign in to the Microsoft 365 admin center, then browse to the SharePoint admin center and open the Settings page.
If you have Office 365 operated by 21Vianet (China), sign in to the Microsoft 365 admin center, then browse to the SharePoint admin center and open the Settings page.
Select classic settings page.
Make sure 'OneDrive Sync Button' is set to 'Show the Sync button.'
To sync SharePoint files with the new client, you must also sync OneDrive files with the new client.
For 'Sync Client for SharePoint,' select Start the new client.
Note
If you don't see the 'Sync Client for SharePoint' setting on the Settings page, your organization is already set up to use the new OneDrive sync app. When users sign in to the OneDrive sync app (OneDrive.exe), it will automatically take over syncing the site libraries that the previous new OneDrive sync app (Groove.exe) was syncing. For information about how this works, and about the types of libraries that will continue syncing with the previous sync app, see Transition from the previous OneDrive for Business sync app.
Select OK.
These changes take several hours to propagate. To check that they've propagated, go to a SharePoint site and select Sync. In the browser dialog box that confirms the request to open a program, the 'Program' should appear as 'Microsoft OneDrive' and the 'Address' should start with 'odopen://'