部署和配置适用于 Mac 的 OneDrive 同步 应用

重要

部署和配置文件夹备份设置需要独立OneDrive 同步应用。 目前不支持在文件夹备份方面使用 Mac App Store OneDrive 同步 应用。

管理员可通过两种基本方式将 OneDrive 同步 应用部署到组织中的 Mac 用户:

  • 按照 macOS 上的 OneDrive 同步文件中的说明安装和设置 OneDrive 同步 应用。 若要安装适用于 Mac 的 OneDrive 同步 应用,用户必须是 Mac 上的管理员。

  • 将安装程序包文件下载到本地网络,然后使用软件分发工具将应用部署到用户。 通过使用软件分发工具,可以更好地控制部署,包括哪些用户获取同步应用以及何时获取同步应用。 适用于 Mac 的 OneDrive 同步 应用使用 Apple Installer 技术进行安装,使你能够使用通常用于将软件部署到 Mac 用户的软件分发工具。 可以使用 Microsoft Intune。 其他常用工具包括 Jamf ProMunkiAutoPkg。 还可以使用 Apple 远程桌面AppleScript

使用属性列表 (.plist) 文件管理 macOS 上的 OneDrive 设置

安装适用于 Mac 的 OneDrive 同步 应用后,用户可以配置应用的设置。 这些设置称为首选项。 作为管理员,你可能希望为组织中的用户提供一组标准首选项。 适用于 Mac 的 OneDrive 同步 应用的首选项存储在属性列表 (.plist) 文件中。

独立 Mac App Store
.plist 位置 /Library/Preferences/com.microsoft.OneDrive.plist /Library/Containers/com.microsoft.OneDrive-mac/Data/Library/Preferences/com.microsoft.OneDrive-mac.plist
com.microsoft.OneDrive com.microsoft.OneDrive-mac

配置同步应用设置

在 macOS 上配置设置,如下所示:

  1. 通过创建具有所需值的 .plist 文件来定义要更改的设置。 可以使用脚本来设置值。

  2. 退出 OneDrive 应用。

  3. 将设置部署到本地计算机。

  4. 刷新偏好设置缓存。

在下次启动 OneDrive 时,将选取新设置。

后台服务

重要

macOS 13 (Ventura) 包含新的隐私增强功能。 从此版本开始,默认情况下,未经明确同意,应用程序无法在后台运行。 OneDrive 必须在后台运行其守护程序进程。 此配置文件向 OneDrive 授予后台服务权限。 如果以前通过 Microsoft Intune 配置了 OneDrive,建议使用此配置文件更新部署。

需要创建 OneDrive 需要在登录时打开并在后台可靠运行的系统配置文件。 下面是一个示例:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1">
<dict>
<key>PayloadUUID</key>
<string>9FE052B5-E7B6-4BF9-94EB-DB611E0E323E</string>
<key>PayloadType</key>
<string>Configuration</string>
<key>PayloadOrganization</key>
<string>Microsoft Corporation</string>
<key>PayloadIdentifier</key>
<string>9FE052B5-E7B6-4BF9-94EB-DB611E0E323E</string>
<key>PayloadDisplayName</key>
<string>OneDrive - Background Services</string>
<key>PayloadDescription</key>
<string/>
<key>PayloadVersion</key>
<integer>1</integer>
<key>PayloadEnabled</key>
<true/>
<key>PayloadRemovalDisallowed</key>
<true/>
<key>PayloadScope</key>
<string>System</string>
<key>PayloadContent</key>
<array>
<dict>
<key>PayloadDescription</key>
<string>Background Service Management for OneDrive</string>
<key>PayloadIdentifier</key>
<string>4C3F2438-464E-43F5-8961-D4672D4A9F5D.privacy.C7B71805-73F2-43F6-A5AA-29C9CAD728B4</string>
<key>PayloadUUID</key>
<string>F9EE3920-EAD8-4472-AF2F-52D2B57FDB31</string>
<key>Rules</key>
<array>
<dict>
<key>RuleType</key>
<string>LabelPrefix</string>
<key>RuleValue</key>
<string>com.microsoft.OneDrive</string><!--This would be com.microsoft.OneDrive-mac for the Store app-->
</dict>
<dict>
<key>RuleType</key>
<string>BundleIdentifierPrefix</string>
<key>RuleValue</key>
<string>com.microsoft.OneDriveLauncher</string>
</dict>
</array>
<key>PayloadType</key>
<string>com.apple.servicemanagement</string>
<key>PayloadDisplayName</key>
<string>Background Service Management for OneDrive</string>
</dict>
</array>
</dict>
</plist>

设置概述

使用以下密钥为用户预配置或更改设置。 无论是运行独立版还是 Mac App Store版同步应用,密钥都是相同的。 但是,.plist 文件名和域名不同。 应用设置时,请确保根据同步应用的版本以适当的域为目标。

设置列表

AddedFolderHardDeleteOnUnmount

检测到已添加文件夹的卸载时,此设置将控制文件夹的内容。

将设置的值设置为 True,以在收到已添加文件夹的卸载时硬删除文件夹的所有内容。 将值设置为 False ,或者默认不启用将卸载文件夹的内容移动到回收站的设置。

.plist 文件中此设置的示例为:

<key>AddedFolderHardDeleteOnUnmount</key>
<(Bool)/>

AddedFolderUnmountOnPermissionsLoss

当同步客户端检测到用户失去对已添加文件夹的权限时,此设置将控制文件夹和文件夹本身的内容。

将设置的值设置为 True,以在同步客户端检测到用户失去对已添加文件夹的权限时硬删除文件夹和文件夹本身的所有内容。 将值设置为 False ,或者不启用设置以将文件夹标记为错误并提示用户将其删除。 当用户确认删除操作时,文件夹的内容将移至回收站。

.plist 文件中此设置的示例为:

<key>AddedFolderUnmountOnPermissionsLoss</key>
<(Bool)/>

AllowTenantList

此设置通过指定允许的租户 ID 列表来阻止用户将文件上传到其他组织。 如果启用此设置,如果用户尝试从允许的租户列表中的组织添加帐户,则会收到错误。 如果用户已添加帐户,则文件将停止同步。 此设置优先于 BlockTenantList 设置。 请勿同时启用这两个设置。

AllowTenantList 密钥的参数是 TenantID,其值为字符串,用于确定“允许租户”设置适用的租户。 若要完成设置,此参数还需要为其设置一个布尔值。 如果布尔值设置为 True,则允许租户同步。

.plist 文件中此设置的示例为:

<key>AllowTenantList</key>
<dict>
<key>TenantId1</key>
<true/>
<key>TenantId2</key>
<true/>
</dict>

AutomaticUploadBandwidthPercentage

此设置使同步应用能够根据可用带宽自动设置可用于上传文件的带宽量。

若要启用此设置,必须定义一个介于 1 到 99 之间的数字,以确定同步应用可以使用的总可用带宽的百分比。

.plist 文件中此设置的示例为:

<key>AutomaticUploadBandwidthPercentage</key>
<integer>(Bandwidth)</integer>

BlockExternalSync

此设置可防止同步应用同步从其他组织共享的库和文件夹。

将设置的值设置为 True,以防止用户与用户自己的组织以外的组织同步 OneDrive、SharePoint 库和文件夹。 将值设置为 False ,或者不启用设置以允许 OneDrive 和 SharePoint 文件也与其他组织同步。

.plist 文件中此设置的示例为:

<key>BlockExternalSync</key>
<(Bool)/>

BlockTenantList

此设置可防止用户将文件上传到 阻止的租户 ID 列表中包含的组织。

如果启用此设置,如果用户尝试从被阻止的组织添加帐户,则会收到错误。 如果已为被阻止的组织添加了一个帐户,则文件将停止同步。 如果已启用 AllowTenantList 设置,此设置将不起作用请勿同时启用这两个设置。

通过为 TenantID 参数定义 ID 来启用此设置,该参数确定 阻止租户 设置适用的租户。 此外,对于要阻止与 OneDrive 和 SharePoint 文件和文件夹同步的每个租户的 ID,请将布尔值设置为 True

注意

在列表中,仅包含租户 ID 是不够的。 对于要阻止的每个租户的 ID,必须将布尔值设置为 True

.plist 文件中此设置的示例为:

<key>BlockTenantList</key>
<dict>
<key>TenantId1</key>
<true/>
<key>TenantId2</key>
<true/>
</dict>

DefaultFolderLocation

此设置指定每个组织的 OneDrive 文件夹的默认位置。

参数为 TenantIDDefaultFolderPathTenantID 值是一个字符串,用于确定默认文件夹位置设置适用的租户。 DefaultFolderPath 值是指定文件夹的默认位置的字符串。 如果要强制将位置设置为用户的主目录 (即默认位置) ,可以将路径指定为 ~/。 字符串如下所示:

<string>~/</string>

下面是控制默认文件夹位置的条件:-Mac App Store:当用户设置同步应用时,路径必须已经存在。 - 独立:在用户设置同步应用后,如果路径尚不存在, (将创建) 。 只有使用独立同步应用,才能阻止用户更改位置。

.plist 文件中此设置的示例为:

<key>DefaultFolder</key>
<dict>
<key>Path</key>
<string>(DefaultFolderPath)</string>
<key>TenantId</key>
<string>(TenantID)</string>
</dict>

DisableAutoConfig

此设置确定同步应用是否可以自动登录。

如果将此设置的值设置为 1,则会阻止同步应用使用可用于Microsoft应用程序的现有Microsoft Entra凭据自动签名。

.plist 文件中此设置的示例为:

<key>DisableAutoConfig</key>
<integer>1</integer>

DisableFirstDeleteDialog

当用户从同步位置删除本地文件时,将显示一条警告消息,指出文件在用户的所有设备和 Web 上不再可用。 此设置允许隐藏警告消息。

如果将设置的值设置为 1,则当用户在本地删除文件时,不会在任何地方看到已删除的文件提醒。 (当用户从已同步的团队网站中删除文件时,此提醒称为"删除的文件给所有人"。)

.plist 文件中此设置的示例为:

<key>DisableFirstDeleteDialog</key>
<integer>1</integer>

DisableFREAnimation

如果将设置的值设置为 1,则当用户在本地删除文件时,不会在任何地方看到已删除的文件提醒。 (当用户从已同步团队网站中删除文件时,此提醒称为“为每个人删除已删除的文件”。) 此设置可阻止动画在 OneDrive 设置期间显示。

如果将设置的值设置为 1,则 OneDrive 设置期间不会显示动画。

.plist 文件中此设置的示例为:

<key>DisableFREAnimation</key>
<integer>1</integer

DisableOfflineMode

此设置可防止用户在 Web 上的 OneDrive 中启用脱机模式。

此设置的首选项存储在以下 .plist 文件中。

脱机模式首选项位置 OneDrive 组首选项
.plist 位置 ~/Library/Preferences/com.microsoft.SharePoint-mac.plist ~/Library/Group Containers/UBF8T346G9。OneDriveStandaloneSuite/Library/Preferences/UBF8T346G9。OneDriveStandaloneSuite.plist

默认情况下,在 Web 上为 OneDrive 的用户启用脱机模式。

若要防止组织中的用户在 OneDrive 网页版中启用脱机模式,请使用以下示例:

<key>DisableOfflineMode</key>
<integer>1</integer>

若要在 OneDrive 网页版中为用户重新启用脱机模式,请使用以下示例:

<key>DisableOfflineMode</key>
<integer>0</integer>

DisableOfflineModeForExternalLibraries

此设置可防止用户在 Web 上的 OneDrive 中为从其他组织共享的库和文件夹启用脱机模式。

此设置的首选项存储在以下 .plist 文件中:

脱机模式首选项位置 OneDrive 组首选项
.plist 位置 ~/Library/Preferences/com.microsoft.SharePoint-mac.plist ~/Library/Group Containers/UBF8T346G9。OneDriveStandaloneSuite/Library/Preferences/UBF8T346G9。OneDriveStandaloneSuite.plist

若要防止组织中的用户在 Web 上的 OneDrive 中为从其他组织共享的库和文件夹启用脱机模式,请使用以下示例:

<key>DisableOfflineModeForExternalLibraries</key>
<integer>1</integer>

若要在 Web 上的 OneDrive 中为从其他组织共享的库和文件夹重新启用脱机模式,请使用以下示例:

<key>DisableOfflineModeForExternalLibraries </key>
<integer>0</integer>

DisablePersonalSync

此设置阻止用户在个人 OneDrive 帐户中登录和同步文件。 如果用户在设置与个人帐户的同步后配置此设置,则用户将注销。

如果将设置的值设置为 True,则会阻止用户添加或同步个人帐户。

.plist 文件中此设置的示例为:

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

DisableTutorial

此设置可防止用户在设置 OneDrive 后向用户显示教程。

如果将此设置的值设置为 True,则会在用户设置OneDrive 同步应用后阻止向用户显示本教程。

.plist 文件中此设置的示例为:

<key>DisableTutorial</key>
<(Bool)/>

DownloadBandwidthLimited

此设置设置运行 OneDrive 同步 应用的计算机的最大下载吞吐量速率 (KB) /秒。

将此设置的值设置为 50 到 100000 之间的整数,以指定同步应用可以使用的下载吞吐量(以 KB/秒为单位)。

.plist 文件中此设置的示例为:

<key>DownloadBandwidthLimited</key>
<integer>(Download Throughput Rate in KB/sec)</integer>

EnableODIgnore

此设置允许输入关键字,以防止OneDrive 同步应用将某些文件上传到 OneDrive 或 SharePoint。 可以输入完整名称(如“setup.exe”),或使用星号 () 作为通配符来表示一系列字符,例如.pst。 关键字不区分大小写。

如果启用此设置,同步应用不会上传匹配指定关键字的新文件。 跳过的文件不会显示错误,且文件仍保留在本地 OneDrive 文件夹中。 在 Finder 中,文件以“已从同步中排除”图标显示。

用户在 OneDrive 活动中心看到一条消息,其中解释了文件未同步的原因。

.plist 文件中此设置的示例为:

<key>EnableODIgnore</key>
<array>
<string>(Keyword such as *.PST)</string>
</array>

EnableSyncAdminReports

此设置允许OneDrive 同步应用报告要包含在同步管理报告中的设备和运行状况数据。 必须在要从中获取报表的设备上启用此设置。 有关这些报表的详细信息,请参阅应用管理员中心中的OneDrive 同步报表

如果禁用或未配置此设置,OneDrive 同步应用设备和运行状况数据不会出现在同步管理员报告中。

以下示例显示了此设置在 .plist 文件中的外观:

<key>EnableSyncAdminReports</key>
<integer>1</integer>

注意

建议保留文件按需启用。 查看有关配置同步应用的所有建议

HideDockIcon

此设置指定是否显示 OneDrive 的停靠图标。

如果将此设置的值设置为 True,则即使应用正在运行,OneDrive 扩展坞图标也会隐藏。

.plist 文件中此设置的示例为:

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

HydrationDisallowedApps

此设置可防止应用自动下载仅联机文件。 可以使用此设置锁定无法与文件随选部署正常工作的应用。

若要启用此设置,必须定义 JSON 格式的字符串:

[{"ApplicationId":"appId","MaxBundleVersion":"1.1","MaxBuildVersion":"1.0"}]

“appID”可以是 BSD 进程名称或捆绑包显示名称。 “MaxBuildVersion”表示可阻止的应用的最大内部版本。 “MaxBundleVersion”表示可阻止的应用的最大捆绑包版本。

.plist 文件中此设置的示例为:

<key>HydrationDisallowedApps</key>
<string>[{"ApplicationId":"appId","MaxBundleVersion":"1.1","MaxBuildVersion":"1.0"}, {"ApplicationId":"appId2","MaxBundleVersion":"3.2","MaxBuildVersion":"2.0"}]</string>
<(Bool)/>

KFMBlockOptIn

此设置可防止用户将其文档和桌面文件夹移动到任何 OneDrive 帐户。

如果启用 KFMBlockOptIn,则不会提示用户保护其桌面和文档文件夹,并且 将禁用“管理备份” 命令。 如果用户之前移动了其“桌面”和“文档”文件夹,则这些文件夹中的文件将保留在 OneDrive 中。 如果启用了 KFMOptInWithWizard“或 KFMSilentOptIn,此设置不会生效。

如果将此设置的值设置为 1,则会阻止文件夹备份。 如果将该值设置为 2,则会将以前用于文件夹备份的任何文件夹重定向回用户的设备,并停止进一步运行设置。

.plist 文件中此设置的示例为:

<key>KFMBlockOptIn</key>
<integer>(1 or 2)</integer>

KFMBlockOptOut

此设置强制用户保留其文档和桌面文件夹定向到 OneDrive。

如果启用此设置,则会禁用“管理文件夹备份”窗口中的“停止备份”按钮,如果用户尝试停止同步其桌面或文档文件夹,则会收到错误。

.plist 文件中此设置的示例为:

<key>KFMBlockOptOut</key>
<(Bool)/>

KFMOptInWithWizard

此设置显示一个向导,提示用户将其文档和桌面文件夹移动到 OneDrive。

如果启用此设置并提供租户 ID,则同步 OneDrive 的用户在登录后将看到“文件夹备份”向导窗口。 如果他们关闭窗口,同步活动中心会显示一条提醒通知,直到他们移动其桌面和文档文件夹。

.plist 文件中此设置的示例为:

<key>KFMOptInWithWizard</key>
<string>(TenantID)</string>

KFMSilentOptIn

使用此设置可将用户的文档和/或桌面文件夹重定向和移动到 OneDrive,而无需进行任何用户交互。

可以同时移动这两个文件夹,也可以选择要移动的文件夹。 移动文件夹后,此设置不会再次影响该文件夹。

.plist 文件中此设置的示例为:

<key>KFMSilentOptIn</key>
<string>(TenantID)</string>

如果启用此设置并提供租户 ID,则可以选择是否在重定向用户的文件夹后向用户显示通知:

<key>KFMSilentOptInWithNotification</key>
<(Bool)/>

如果未设置以下任何设置,则默认设置会将这两个文件夹移动到 OneDrive 中。 如果要指定要移动的文件夹,应设置以下设置的任意组合:

<key>KFMSilentOptInDesktop</key>
<(Bool)/>
<key>KFMSilentOptInDocuments</key>
<(Bool)/>

LocalMassDeleteFileDeleteThreshold

此设置指定在通知用户文件也将从云中删除之前,用户可以从本地 OneDrive 文件夹中删除的文件数的阈值。

注意

此策略设置了用户可以从本地 OneDrive 文件夹中删除的文件数阈值,超过此阈值就会通知用户这些文件还会从云中删除。 如果启用此策略,如果用户从本地计算机上的 OneDrive 中删除的文件数超过指定数量,则会看到通知。 用户可以选择继续删除云文件或还原本地文件。

若要启用此设置,请设置一个介于 0 和 100000 之间的值,如果用户从本地计算机上的 OneDrive 删除的文件数超过指定数目,则会看到通知。 用户可以选择继续删除云文件或还原本地文件。

如果未设置此设置,当用户在短时间内删除超过 200 个文件时,将看到通知。

.plist 文件中此设置的示例为:

<key>LocalMassDeleteFileDeleteThreshold</key>
<integer>(Number of items deleted)</integer>

MinDiskSpaceLimitInMB

通过此设置,可以指定最小可用磁盘空间量,并阻止OneDrive 同步应用在用户拥有的磁盘空间少于此量时下载文件。系统会提示用户提供帮助释放空间的选项。

若要启用此设置,请设置一个介于 0 和 10240000 之间的值。

.plist 文件中此设置的示例为:

<key>MinDiskSpaceLimitInMB</key>
<integer>(Available disk space)</integer>

OpenAtLogin

重要

将弃用同步应用 24.113 的 OpenAtLogin 设置。 请参阅 后台服务 ,配置相应的配置文件,使 OneDrive 能够在用户登录时自动启动。

此设置指定 OneDrive 在用户登录时是否自动启动。

如果将此设置的值设置为 True,OneDrive 会在用户登录到其 Mac 时自动启动。

.plist 文件中此设置的示例为:

<key>OpenAtLogin</key>
<(Bool)/>

SharePointOnPremFrontDoorUrl

此设置指定OneDrive 同步应用必须尝试对其进行身份验证和同步的SharePoint Server 2019本地 URL。

若要启用此设置,必须定义一个包含本地 SharePoint Server URL 的字符串。

.plist 文件中此设置的示例为:

<key>SharePointOnPremFrontDoorUrl</key>
<string>https://Contoso.SharePoint.com</string>

有关为SharePoint Server 2019配置OneDrive 同步应用的详细信息

SharePointOnPremPrioritizationPolicy

此设置确定同步应用程序是否应在首次运行方案中为本地 SharePoint Server 或 Microsoft 365 中的 SharePoint Server 设置同步,前提是该帐户在混合方案中的 sharePoint Server 和 sharePoint 在 Microsoft 365 中相同。

如果将此设置的值设置为 1,OneDrive 同步应用首先设置 SharePoint Server,然后是 Microsoft 365 中的 SharePoint。

.plist 文件中此设置的示例为:

<key>SharePointOnPremPrioritizationPolicy</key>
<integer>(0 or 1)</integer>

SharePointOnPremTenantName

通过此设置,可以指定为同步 Front Door URL 中指定的SharePoint Server 2019文件而创建的文件夹的名称。

如果启用此设置,则可以指定 TenantName,该名称是文件夹在以下约定中使用的名称:OneDrive – TenantName (由你指定的) TenantName (由你)

如果未指定任何 TenantName,该文件夹将使用 FrontDoorURL 的第一个段作为其名称。 例如,https:// Contoso.SharePoint.com 在以下约定中使用 Contoso 作为租户名称:OneDrive – Contoso

.plist 文件中此设置的示例为:

<key>SharePointOnPremTenantName</key>
<string>Contoso</string>

有关为SharePoint Server 2019配置OneDrive 同步应用的详细信息

此设置允许你为组织中的用户指定同步应用更新通道。 OneDrive 同步应用通过三个通道向公众更新:先是预览体验成员,然后是生产版,最后是延期。 启用此设置并选择某个通道后,用户无法对其进行更改。

我们建议选择 IT 部门中的若干人员作为早期采用者,以加入预览体验通道,并尽早接收功能。 我们还建议将组织中的其他人留在默认生产圈中,以确保他们及时收到 bug 修复和新功能。 请参阅有关配置同步应用的所有建议

预览体验成员:预览体验成员圈用户会收到预览 OneDrive 新功能的版本。

生产:生产圈用户可在其可用时获取最新功能。 此圈是默认的。

企业 (也称为“延迟”) :企业圈用户最后获得新功能、bug 修复和性能改进。 借助此通道,可从内部网络位置部署更新并控制部署时间(限于 60 天内)。

有关每个环中当前可用的版本的详细信息,请参阅 OneDrive 发行说明。 有关更新通道以及同步应用如何检查更新的详细信息,请参阅 OneDrive 同步 应用更新过程

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

.plist 文件中此设置的示例为:

<key>Tier</key>
<string>(UpdateRing)</string>

注意

如果要隐藏“获取预发布Microsoft内部更新以显示”选项,则需要选择加入延期更新通道。 例如,defaults write com.microsoft.OneDrive Tier -string "Deferred"

UploadBandwidthLimited

此设置定义运行 OneDrive 同步 应用的计算机的最大上传吞吐量速率。

若要启用此设置,请设置一个介于 50 到 100000 之间的值,即同步应用可以使用的上传吞吐量速率(以 KB/秒为单位)。

.plist 文件中此设置的示例为:

<key>UploadBandwidthLimited</key>
<integer>(Upload Throughput Rate in KB/sec)</integer>

WarningMinDiskSpaceLimitInMB

此设置允许指定最小可用磁盘空间量,并在OneDrive 同步应用下载导致其可用磁盘空间小于此量的文件时警告用户。 系统会提示用户选择相应的选项以帮助释放空间。

若要启用此设置,请设置一个介于 0 和 10240000 之间的值。

.plist 文件中此设置的示例为:

<key>WarningMinDiskSpaceLimitInMB</key>
<integer>(available disk space)</integer>

查找 Microsoft 365 租户 ID

在应用管理员中心 (EnableSyncAdminReports) OneDrive 同步报表