13-05-2021

Change Default Location For Microsoft On A Mac

-->

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.

Starting in February 2019 we rolled out a small change to the way the File Save experience works in Office 365 apps. Like Word or Excel on Windows and Mac.Now the default save location is in the cloud, though of course you can always choose a different location to save to.

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:Outlook for Mac, Outlook 2019 for Mac

As an IT admin, you may want to provide Outlook for Mac users in your organization with a standard set of preferences in either of the following ways:

Set a default preference, which users can change.
Force a particular preference, which users can’t change.

The following preferences can be used to simplify account setup for Office 365 mailboxes, help protect company data, and support a streamlined user experience.

These keys are CFPreferences-compatible, which means that it can be set by using enterprise management software for Mac, such as Jamf Pro.

Mailbox settings

Automatically configure Office 365 mailbox on first launch

The email address used for Office activation will be added on first launch.

Domain	com.microsoft.office
Key	OfficeAutoSignIn
Data Type	Boolean
Possible values	false (default) true
Availability	16.17
Comments	This key also suppresses first run dialogs for other Office apps, including Word, Excel, PowerPoint, and OneNote.

Specify Office 365 mailbox to be added on first launch

Set the domain or full email address of Office 365 mailbox to be added on first launch.

Domain	com.microsoft.Outlook
Key	DefaultEmailAddressOrDomain
Data Type	String
Possible values	various (example: 'contoso.com')
Availability	16.18
Comments	The full email address or domain specified will be added in Outlook instead of the Office activation email address.

Allow only corporate mailboxes to be added

Specify one or more domains users are allowed to add in Outlook.

Domain	com.microsoft.Outlook
Key	AllowedEmailDomains
Data Type	Array of Strings
Possible values	Various (example: 'contoso.com$')
Availability	16.18
Comments	Format strings as regular expressions. Does not remove or disconnect accounts already added in Outlook.

Hide text about adding non-corporate mailboxes

Hide the “Did you know? Outlook supports…” text in the Set Up Your Email success dialog box.

Domain	com.microsoft.Outlook
Key	HideCanAddOtherAccountTypesTipText
Data Type	Boolean
Possible values	false (default) true
Availability	16.18
Comments	Only hides text. Does not impact ability to add non-corporate mailboxes.

Import/export settings

Disable import

Prevent users from being able to import archive files (.olm and .pst) and Outlook 2011 for Mac data.

Domain	com.microsoft.Outlook
Key	DisableImport
Data Type	Boolean
Possible values	false (default) true
Availability	16.18
Comments	Key must be set to true and forced.

Disable export

Prevent users from being able to export archive files (.olm).

Domain	com.microsoft.Outlook
Key	DisableExport
Data Type	Boolean
Possible values	false (default) true
Availability	16.18
Comments	Key must be set to true and forced.