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 |
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)/> |
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> |
独立版Standalone | Mac 应用商店Mac App Store | |
---|---|---|
PList 位置PList Location | ~/Library/Preferences/com.microsoft.OneDrive.plist~/Library/Preferences/com.microsoft.OneDrive.plist | ~/Library/Containers/com.microsoft.OneDrive-mac/Data/Library/Preferences/com.microsoft.OneDrive-mac.plist~/Library/Containers/com.microsoft.OneDrive-mac/Data/Library/Preferences/com.microsoft.OneDrive-mac.plist |
域Domain | com.microsoft.OneDrivecom.microsoft.OneDrive | com.microsoft.OneDrive-maccom.microsoft.OneDrive-mac |
设置Setting | 说明Description | 参数Parameters | 示例 Plist 项Example Plist Entry |
---|---|---|---|
禁用个人帐户Disable personal accounts | 阻止用户在个人 OneDrive 帐户中登录和同步文件。如果此键是在用户使用个人帐户设置同步后设置的,用户将被注销。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):在设置为 true 时,此参数将阻止用户添加或同步个人帐户。DisablePersonalSync (Bool): When set to true, this parameter prevents users from adding or syncing personal accounts. | <key>DisablePersonalSync</key><key>DisablePersonalSync</key> <(Bool)/><(Bool)/> |
默认文件夹位置Default folder location | 指定每个组织的 OneDrive 文件夹的默认位置Specifies the default location of the OneDrive folder for each organization | TenantID (String):TenantID 确定应该应用默认文件夹位置设置的帐户。查找 Office 365 租户 IDTenantID (String): TenantID determines which accounts the default folder location setting should apply to. Find your Office 365 tenant ID DefaultFolderPath (String):DefaultFolder 指定默认文件夹位置。DefaultFolderPath (String): DefaultFolder specifies the default folder location. Mac 应用商店: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><key>Tenants</key> <dict><dict> <key>(TenantID)</key><key>(TenantID)</key> <dict><dict> <key>DefaultFolder</key><key>DefaultFolder</key> <string>(DefaultFolderPath)</string><string>(DefaultFolderPath)</string> </dict></dict> </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):此参数确定同步应用程序可使用的本地上载带宽的百分比。AutomaticUploadBandwidthPercentage (int): This parameter determines the percentage of local upload bandwidth that the sync app can use.接受的值为1到99。Accepted values are from 1 through 99. | <key>AutomaticUploadBandwidthPercentage</key><key>AutomaticUploadBandwidthPercentage</key> <int>(Bandwidth)</int><int>(Bandwidth)</int> |
设置最大上传吞吐量Set maximum upload throughput | 为运行 OneDrive 同步应用的计算机设置最大上载吞吐量速率(以千字节(KB)/秒为单位)Sets the maximum upload throughput rate in kilobytes (KB)/sec for computers running the OneDrive sync app | UploadBandwidthLimited (int):此参数确定同步应用程序可以使用的上载吞吐量,以 KB/秒为单位。UploadBandwidthLimited (int): This parameter determines the upload throughput in KB/sec that the sync app can use.最小速率为 50 KB/秒,最大速率为 100000 KB/秒。The minimum rate is 50 KB/sec and the maximum rate is 100,000 KB/sec. | <key>UploadBandwidthLimited</key><key>UploadBandwidthLimited</key> <int>(Upload Throughput Rate in KB/sec)</int><int>(Upload Throughput Rate in KB/sec)</int> |
设置最大下载吞吐量Set maximum download throughput | 为运行 OneDrive 同步应用程序的计算机设置最大下载吞吐量速率(以千字节(KB)/秒为单位)Sets the maximum download throughput rate in kilobytes (KB)/sec for computers running the OneDrive sync app | DownloadBandwidthLimited (int):此参数确定同步应用程序可以使用的下载吞吐量,以 KB/秒为单位。DownloadBandwidthLimited (int): This parameter determines the download throughput in KB/sec that the sync app can use.最小速率为 50 KB/秒,最大速率为 100000 KB/秒。The minimum rate is 50 KB/sec and the maximum rate is 100,000 KB/sec. | <key>DownloadBandwidthLimited</key><key>DownloadBandwidthLimited</key> <int>(Download Throughput Rate in KB/sec)</int><int>(Download Throughput Rate in KB/sec)</int> |
Dock 图标Dock icon | 指定是否显示 OneDrive 的 dock 图标Specifies whether a dock icon for OneDrive is shown | HideDockIcon (Bool):在设置为 true 时,此参数将隐藏 OneDrive dock 图标,即使应用程序正在运行也是如此。HideDockIcon (Bool): When set to true, this parameter hides the OneDrive dock icon even when the application is running. | <key>HideDockIcon</key><key>HideDockIcon</key> <(Bool)/><(Bool)/> |
在登录时打开Open at login | 指定 OneDrive 在用户登录时是否自动启动Specifies whether OneDrive starts automatically when the user logs in | OpenAtLogin (Bool):如果设置为 true,那么用户在 Mac 上登录时,OneDrive 将自动启动。OpenAtLogin (Bool): When set to true, OneDrive will start automatically when the user logs in on the Mac. | <key>OpenAtLogin</key><key>OpenAtLogin</key> <(Bool)/><(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 (布尔值):如果设置为 true,则默认情况下,设置同步应用程序的新用户将下载仅联机文件。FilesOnDemandEnabled (Bool): When set to true, new users who set up the sync app will download online-only files by default.如果设置为 false,则将禁用按需打开文件,并且用户无法将其打开。When set to false, Files On-Demand will be disabled and users won't be able to turn it on. | <key>FilesOnDemandEnabled</key><key>FilesOnDemandEnabled</key> <(Bool)/><(Bool)/> |
禁用下载 ToastDisable download toasts | 在应用程序导致下载文件内容时防止出现 ToastPrevents toasts from appearing when applications cause file contents to be downloaded | DisableHydrationToast (Bool):如果设置为 true,toast 不会在应用触发文件内容下载时显示。DisableHydrationToast (Bool): When set to true, toasts will not appear when applications trigger the download of file contents. | <key>DisableHydrationToast</key><key>DisableHydrationToast</key> <(Bool)/><(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):以下格式的 JsonHydrationDisallowedApps (String): Json in the following format[{'ApplicationId':'appId','MaxBundleVersion':'1.1','MaxBuildVersion':'1.0'}] “AppID”可以是 BSD 进程名称或捆绑包显示名称。MaxBuildVersion 表示将被阻止的应用程序的最大内部版本。MaxBundleVersion 表示将被阻止的应用程序的最大捆绑包版本'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><key>HydrationDisallowedApps </key> <string> [{'ApplicationId':'appId','MaxBundleVersion':'1.1','MaxBuildVersion':'1.0'}, {'ApplicationId':'appId2','MaxBundleVersion':'3.2','MaxBuildVersion':'2.0'}] </string><string> [{'ApplicationId':'appId','MaxBundleVersion':'1.1','MaxBuildVersion':'1.0'}, {'ApplicationId':'appId2','MaxBundleVersion':'3.2','MaxBuildVersion':'2.0'}] </string><(Bool)/><(Bool)/> |
SharePoint Server Front Door URLSharePoint Server Front Door URL | 指定 OneDrive 同步应用程序应尝试对其进行身份验证和同步的 SharePoint Server 2019 本地 URLSpecifies the SharePoint Server 2019 on-premises URL that the OneDrive sync app should try to authenticate and sync against | SharePointOnPremFrontDoorUrl (string):本地 SharePoint Server 的 URL。SharePointOnPremFrontDoorUrl (string): The URL of the on-premises SharePoint Server. | <key>SharePointOnPremFrontDoorUrl</key><key>SharePointOnPremFrontDoorUrl</key> <string>https://Contoso.SharePoint.com</string><string>https://Contoso.SharePoint.com</string> |
SharePoint Server 租户名称SharePoint Server Tenant Name | 指定为同步 Front Door URL 中指定的 SharePoint Server 2019 文件而创建的文件夹的名称。Specifies the name of the folder created for syncing the SharePoint Server 2019 files specified in the Front Door URL. | SharePointOnPremTenantName (string):创建用于同步本地 SharePoint Server 文件的文件夹时将使用的名称。如果指定,文件夹名称将采用以下形式: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 – TenantNameOneDrive – TenantName TenantNameTenantName 如果未指定,文件夹名称将使用 FrontDoorURL 的第一段作为租户名称。If not specified, the folder names will use the first segment of the FrontDoorURL as the Tenant Name. 示例 - https://Contoso.SharePoint.com 将使用 Contoso 作为租户名称Example - https://Contoso.SharePoint.com will use Contoso as the Tenant Name | <key>SharePointOnPremTenantName</key><key>SharePointOnPremTenantName</key> <string>Contoso</string><string>Contoso</string> |
SharePoint OnPrem 优先顺序SharePoint OnPrem Prioritization | 对于本地 SharePoint Server 和 SharePoint Online 的电子邮件相同的混合情况,请确定客户端是否应在首次运行期间首先为 SharePoint Server 或 SharePoint Online 设置同步。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):此参数用于确定在设置同步时对哪些服务进行身份验证。SharePointOnPremPrioritizationPolicy (int): This parameter determines which service to attempt to authenticate against for setting up sync. 1 表示 OneDrive 应首先设置本地 SharePoint Server,然后设置 SharePoint Online。1 indicates OneDrive should setup SharePoint Server on-premises first, followed by SharePoint Online. | <key>SharePointOnPremPrioritizationPolicy</key><key>SharePointOnPremPrioritizationPolicy</key> <int>(0 or 1)</int><int>(0 or 1)</int> |
BlockExternalSyncBlockExternalSync | 阻止同步应用同步从其他组织共享的库和文件夹。Prevents the sync app from syncing libraries and folders shared from other organizations. | BlockExternalSync (布尔值):设置为 true 以阻止从除用户自己的组织之外的其他组织中同步 OneDrive for business 和 SharePoint 库和文件夹。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.设置为 false 或不包含允许的设置。Set to false or do not include the setting to allow. 了解 ONEDRIVE B2B 同步。Learn about OneDrive B2B Sync. | <关键>BlockExternalSync</key><key>BlockExternalSync</key> <(Bool)/><(Bool)/> |
PList 位置PList Location | ~/Library/Preferences/com.microsoft.OneDriveUpdater.plist~/Library/Preferences/com.microsoft.OneDriveUpdater.plist |
域Domain | com.microsoft.OneDriveUpdatercom.microsoft.OneDriveUpdater |
设置Setting | 说明Description | 参数Parameters | 示例 Plist 项Example Plist Entry |
---|---|---|---|
层Tier | 定义计算机的更新通道Defines the update ring for the computer | UpdateRing (String):此参数具有两个不同的值。UpdateRing (String): This parameter has two different values. 生产 - OneDrive 更新的默认更新通道。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.有关更新响铃的详细信息以及同步应用程序如何检查更新的详细信息,请参阅OneDrive 同步应用程序更新过程。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><key>Tier</key> <string>(UpdateRing)</string><string>(UpdateRing)</string> |