Create your best work with the latest versions of Word, Excel and all the other Office apps. Plus, get 1 TB of cloud storage, document sharing, ransomware recovery, and more with OneDrive. Manually install and configure OneDrive on a macOS device. For information about installing the OneDrive app on a computer running macOS or adding a work account to an existing installation, see Sync files with the OneDrive sync app on Mac OS X. Install OneDrive. Dec 12, 2011 Do more wherever you go with Microsoft OneDrive. Get to and share your documents, photos, and other files from your iOS device, computer (PC or Mac), and any other devices you use. Use the Office mobile apps to stay productive and work together, no matter where you are. The OneDrive app for.
-->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.
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 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.
| 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 app settings
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.
Overview of settings
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> |
Applies to:Office for Mac
This article is for IT administrators and discusses frequently asked questions about the availability of Office from the Mac App Store, and the differences between downloading and distributing Office apps directly from Microsoft.
Starting in January 2019, the following Office applications are available for download from the Mac App Store:
- Microsoft Word
- Microsoft Excel
- Microsoft PowerPoint
- Microsoft Outlook
- Microsoft OneNote*
- Microsoft OneDrive*
* These apps were also available from the Mac App Store in previous years.
What version of Office is available from the Mac App Store?
The Office apps available from the Mac App Store provide the very latest production version of Office on the Mac. Word, Excel, PowerPoint, and Outlook require an Office 365 subscription to activate. OneNote and OneDrive do not require an Office 365 subscription, but some premium features may require an Office 365 subscription. All apps are compatible with Office 365 subscription plans, such as Office 365 A3, Office 365 A5, Office 365 Enterprise E3, Office 365 Enterprise E5, and Office 365 ProPlus.
Note
Some Office 365 subscriptions don't include access to downloadable Office apps. For example, the Office 365 A1, Office 365 Enterprise E1, and Office 365 F1 plans. For more information, see Office 365 plans.
Can I use apps from the Mac App Store with my Volume License?
No. Perpetual licenses, including Office 2019 and Office 2016, are not supported with Office apps available from the Mac App Store. The Volume License (VL) Serializer is not compatible with these apps. Attempts to use a perpetual license with Mac App Store apps will cause the apps to enter reduced functionality mode.
How do I deploy Office apps from the Mac App Store to computers in my organization?
You need an enterprise mobility management (EMM) tool that supports either Apple's Volume Purchase Program (VPP), Apple Business Manager, or Apple School Manager. For example, Jamf Pro is compatible with these programs and can be used to deploy Office apps. Office supports managed distribution, which allows your Mobile Device Management (MDM) server to install Office even when the user does not have an Apple ID. Office apps cannot be distributed through redeemable codes.
While a consumer may acquire Office through the Mac App Store as a bundle with a single-click download, IT admins will need to deploy the individual apps.
When deployed through the Mac App Store, does Office behave differently, or provide less functionality?
Word, Excel, PowerPoint, Outlook, and OneNote provide the same end-user functionality regardless of how it is deployed. IT admins have traditionally deployed Office from Microsoft's Content Delivery Network (CDN), but now have the option of deploying from the Mac App Store.
The OneDrive app, when acquired from Microsoft's CDN, offers IT admins more deployment flexibility such as pre-enabling icon overlays and system access. When acquired from the Mac App Store, users will see additional prompts to enable this functionality.
The Office builds available from the Mac App Store are production builds and are usually updated on a monthly basis. The Office Insider program is not supported through the Mac App Store. If you wish to use the Insider Slow or Fast channels, you should continue to install Office apps from the Microsoft CDN.
Microsoft Teams and Skype for Business are not available through the Mac App Store and must be deployed from the Microsoft CDN.
How do Office updates occur?
When Office apps are deployed through the Mac App Store, it is the sole responsibility of the App Store to keep those apps up-to-date. Conversely, apps deployed from Microsoft's CDN are updated through the Microsoft AutoUpdate (MAU) tool. Content caching services in macOS can be used (and is highly recommended) to optimize both the installation and update process of Office apps acquired through the Mac App Store.
The download size of monthly update packages is the same, regardless of whether the CDN or Mac App Store is used for deployment.
Can I convert an existing CDN-based Office installation to Mac App Store?
If a user launches the App Store app on their Mac, they may see that Office apps are available for download even though Office is already installed from Microsoft's CDN. Depending upon the currently installed Office build, and the build available in the Mac App Store, the existing app may or may not get overwritten. For example, if the build of Office currently installed is newer than what is available from the Mac App Store (such as an Insider build), it will not be overwritten if the user chooses to download the Mac App Store build.
There is no automated process for performing a CDN to Mac App Store conversion. Depending on your EMM's capabilities, you may be able to orchestrate the process through a script. The high-level steps for each Mac are as follows:
- Close all Office apps
- Remove the Office apps from the /Applications folder
- Remove the Office entries from the keychain
- Remove the Office package registrations (
pkgutil --forget) - Trigger the MDM server to install the Office apps (such as
jamf recon)
While CDN-based installations of Office can utilize the bandwidth-optimized suite installer, which is approximately 1.8 GB in size, the total size of the same apps when deployed through the Mac App Store is approximately 4 GB.
Microsoft Onedrive Mac Installer Windows 7
How can I tell if an Office app was downloaded from the Mac App Store?
- Open Finder, and navigate to the Applications folder
- Locate the Office app (such as Microsoft Outlook.app), control-click, and choose Show Package Contents
- Navigate into the Contents folder
- If a folder named
_MASReceiptis present, the app was downloaded from the Mac App Store
How do I manage Office policies and preferences with apps downloaded from the Mac App Store?
Word, Excel, PowerPoint, Outlook, and OneNote offer the same policies and preferences as their CDN-based counterparts. IT admins do not need to alter existing Configuration Profiles as the bundle ID for each app is unchanged.
Note
Onedrive Mac Installer
OneNote does use a different bundle ID, and different management controls are available depending on how you obtain the app. For more information, see Deploy and configure the new OneDrive sync client for Mac.
Microsoft Onedrive For Mac Download
It is highly recommended that IT admins set the OfficeAutoSignIn value to TRUE in the com.microsoft.office preferences domain. For new installations from the Mac App Store, this preference will bypass the first run dialogs that ask users if they wish to purchase a new Office 365 subscription. This will mitigate calls to the help desk in commercial environments as users can only activate an existing subscription.