部署和配置适用于 Mac 的 OneDrive 同步 应用
重要
部署和配置文件夹备份设置需要独立OneDrive 同步应用。 目前不支持在文件夹备份方面使用 Mac App Store OneDrive 同步 应用。
管理员可通过两种基本方式将 OneDrive 同步 应用部署到组织中的 Mac 用户：
按照 macOS 上的 OneDrive 同步文件中的说明安装和设置 OneDrive 同步 应用。 若要安装适用于 Mac 的 OneDrive 同步 应用，用户必须是 Mac 上的管理员。
将安装程序包文件下载到本地网络，然后使用软件分发工具将应用部署到用户。 通过使用软件分发工具，可以更好地控制部署，包括哪些用户获取同步应用以及何时获取同步应用。 适用于 Mac 的 OneDrive 同步 应用使用 Apple Installer 技术进行安装，使你能够使用通常用于将软件部署到 Mac 用户的软件分发工具。 可以使用 Microsoft Intune。 其他常用工具包括 Jamf Pro、 Munki 和 AutoPkg。 还可以使用 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 上配置设置，如下所示：
通过创建具有所需值的 .plist 文件来定义要更改的设置。 可以使用脚本来设置值。
退出 OneDrive 应用。
将设置部署到本地计算机。
刷新偏好设置缓存。
在下次启动 OneDrive 时，将选取新设置。
设置概述
使用以下密钥为用户预配置或更改设置。 无论是运行独立版还是 Mac App Store版同步应用，密钥都是相同的。 但是，.plist 文件名和域名将不同。 应用设置时，请确保根据同步应用的版本以适当的域为目标。
设置列表
- AllowTenantList
- AutomaticUploadBandwidthPercentage
- BlockExternalSync
- BlockTenantList
- DefaultFolderLocation
- DisableAutoConfig
- DisableHydrationToast
- DisableOfflineMode
- DisableOfflineModeForExternalLibraries
- DisablePersonalSync
- DisableTutorial
- DownloadBandwidthLimited
- EnableAllOcsiClients
- EnableODIgnore
- EnableSyncAdminReports
- FilesOnDemandEnabled
- HideDockIcon
- HydrationDisallowedApps
- KFMBlockOptIn
- KFMBlockOptOut
- KFMOptInWithWizard
- KFMSilentOptIn
- OpenAtLogin
- SharePointOnPremFrontDoorUrl
- SharePointOnPremPrioritizationPolicy
- SharePointOnPremTenantName
- 层
- UploadBandwidthLimited
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
参数为 TenantID 和 DefaultFolderPath。 TenantID 值是一个字符串，用于确定默认文件夹位置设置适用的租户。 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>
DisableHydrationToast
此设置可防止应用程序导致下载文件内容时显示 toast。
如果将设置的值设置为 True，则应用程序触发文件内容下载时不会显示 toast。
.plist 文件中此设置的示例为：
<key>DisableHydrationToast</key>
<(Bool)/>
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>
EnableAllOcsiClients
此设置让多个用户可以使用 Microsoft 365 企业应用版、Office 2019 或 Office 2016 桌面应用来同时编辑 OneDrive 中存储的 Office 文件。 它还可以让用户通过 Office 桌面应用共享文件。
重要
建议保持启用此设置，以加快同步速度并减少网络带宽使用量。 请参阅有关配置同步应用的所有建议。
如果将此设置设置为 True 或未设置此设置，则“Office”选项卡将显示在OneDrive 同步首选项中，默认情况下，“使用 Office 应用程序同步我打开的 Office 文件”处于选中状态。
如果将此设置设置为 False，则 “Office ”选项卡在同步应用中处于隐藏状态，并且将禁用 Office 文件的共同创作和应用内共享。 用户可以选择如何在冲突设置中处理 Office 文件，当发生文件冲突时，将保留文件的两个副本。 有关同步应用中的设置的详细信息，请参阅 使用 Office 应用程序同步我打开的 Office 文件。
.plist 文件中此设置的示例为：
<key>EnableAllOcsiClients</key>
<(Bool)/>
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>
FilesOnDemandEnabled
此设置指定是否启用文件按需。
注意
从 macOS Monterey 12.1 开始，文件按需将永久启用，此设置将不再有任何影响。
Monterey 12.1 之前的 macOS 版本
如果将此设置设置为 True，则会启用 FilesOnDemand ，并且默认情况下，设置同步应用的用户可以查看仅联机文件。
如果将此设置设置为 False， 则 FilesOnDemand 将被禁用，用户将无法将其打开。
.plist 文件中此设置的示例为：
<key>FilesOnDemandEnabled</key>
<(Bool)/>
注意
建议保留文件按需启用。 查看有关配置同步应用的所有建议
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)/>
OpenAtLogin
此设置指定 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 帐户相同时，同步应用是否应首先为本地 SharePoint Server 或 Microsoft 365 中的 SharePoint 设置同步。
如果将此设置的值设置为 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>
相关文章
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈