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

项目
03/05/2024

使用 Microsoft 365 应用管理员中心中的OneDrive 同步运行状况仪表板获取 OneDrive 发生的所有操作的执行摘要，以便你可以以管理员身份快速解决常见问题并专注于其他战略任务。

主动保持 OneDrive 正常运行有助于确保组织的信息受到保护。仪表板提供同步运行状况报告，用于跟踪相关运行状况问题和公告、检查各个设备的同步状态和应用版本，以及监视已知文件夹移动的推出。

本文介绍如何设置和导航同步运行状况仪表板以更好地管理 OneDrive 用户并提高 OneDrive 采用率。

要求

在开始之前，请确保熟悉访问仪表板所需的要求：

OneDrive 同步适用于 Windows 和 macOS 的应用版本 22.232 或更高版本。
OneDrive 同步预览体验成员、生产或延期圈上的应用。设置同步应用更新通道。
需要全局管理员、Office 应用管理员或 Microsoft 365 管理员角色访问权限才能为组织启用和设置仪表板。这些功能由其中一个角色启用后，还可以使用全局读者、全局管理员、安全管理员、Office 应用管理员或报表读取者访问权限查看仪表板。若要详细了解 Microsoft 365 中的管理员角色和权限，请访问关于管理员角色。
组织中的设备应允许连接到 https://clients.config.office.net。

注意

具有以下计划的客户无法使用此功能：Office 365由世纪互联运营、Office 365 GCC 或 Office 365 GCC High 和 DoD 运营。

设置OneDrive 同步运行状况仪表板

在本部分中，你将了解如何在 Windows 和 macOS 设备上设置同步报表。

Windows
macOS

此选项卡提供在 Windows 设备上启用同步报表的操作方法步骤。

注意

前面的组策略 HKLM\SOFTWARE\Policies\Microsoft\OneDrive\SyncAdminReports 不再受支持，并且使用该密钥的计算机将不再出现在同步运行状况仪表板中。管理员需要切换到当前支持的密钥， (以下) 的其他信息：HKLM\SOFTWARE\Policies\Microsoft\OneDrive\EnableSyncAdminReports。

确保具有上一部分中列出的所需角色和应用版本。
转到Microsoft 365 应用版管理中心，以全局管理员或 Office 应用管理员身份登录。
在左侧导航菜单中，选择“ 运行状况>OneDrive 同步”。
在左侧导航菜单中，选择“ 设置”。
验证文本字段中是否存在 租户关联密钥 。如果字段为空，请选择“ 生成新密钥”。

注意

首次生成新密钥时，最长可能需要 30 秒才能显示它。
启用 OneDrive EnableSyncAdminReports 组策略 Object (GPO) 。

重要

必须在要从中获取报告的设备上启用此设置。 此设置不会影响用户。我们建议逐步推出，从每天几个测试设备开始，然后每天最多 100 台设备，然后逐渐增加到每天 10,000 台设备，直到完成。

可以通过多种方式启用此设置：
- 编辑注册表
  
  a. 转到 HKLM\SOFTWARE\Policies\Microsoft\OneDrive
  
  b. 右键单击“新建>DWORD (32 位) 值”>
  
  c. 名称：EnableSyncAdminReports
  
  d. 类型：REG_DWORD
  
  e. 数据：1
- 以管理员身份运行命令提示符，然后运行以下命令：
```
 reg.exe add HKLM\Software\Policies\Microsoft\OneDrive /v EnableSyncAdminReports /t REG_DWORD /d 1
```
- 使用组策略。
若要在单台电脑上应用设置，请执行以下步骤：
- 打开组策略编辑器 (gpedit.msc) 。
- 转到“计算机配置\管理模板\OneDrive”。
- 选择 “为 OneDrive 启用同步运行状况报告”。
- 选择 “已启用” ，然后按 “确定”。

重要

在设备上启用 EnableSyncAdminReports 设置时，最长可能需要三天才能使报表可用。在此时间之后，设备将显示在报表中。不支持强制特定设备报告数据。

注意

还可以使用 Intune 中的管理模板启用OneDrive 同步运行状况报告。有关详细信息，请参阅在 Intune 中使用管理模板。

此选项卡提供在 macOS 设备上启用同步报表的操作方法步骤。

确保具有上一部分中列出的所需角色和应用版本。
转到Microsoft 365 应用版管理中心，以全局管理员或 Office 应用管理员身份登录。
在左侧导航菜单中，选择“ 运行状况>OneDrive 同步”。
在左侧导航菜单中，选择“ 设置”。
确认已在文本字段中生成 租户关联密钥 。
在继续操作之前，请确保 OneDrive 应用程序已退出。
使用 键 EnableSyncAdminReports 创建 .plist 文件。还可以使用脚本来设置密钥。无论你是运行独立版还是 Mac App Store 版同步应用，密钥都是相同的。但是，.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

使用终端应用将 EnableSyncAdminReports 设置部署到本地计算机上。

输入以下首选项键以启用设置：
<key>EnableSyncAdminReports</key>
<integer>1</integer>
刷新偏好设置缓存。
在下一次启动 OneDrive 时，将选取新设置。

重要

在设备上启用 EnableSyncAdminReports 设置后，报表最多需要三天才能可用。

导航 OneDrive 同步运行状况仪表板

在本部分中，你将了解如何成功导航 OneDrive 同步运行状况仪表板。了解可用的报告见解，以及它们如何帮助你主动管理组织的 OneDrive。

跳转到：

概述
Devices
Issues

注意

按照上一部分所述设置仪表板后，全局读者管理员角色就足以访问和查看报表。

概述

“ 概述 ”选项卡 (默认视图) 显示至少有一个同步问题的设备的摘要、组织中使用已知文件夹移动的设备百分比，以及当前版本的 OneDrive 上运行的设备数。

卡片名称	说明
同步错误	显示有多少设备是否出现同步错误。对错误进行排序可以帮助你主动接触教育人员，同时解决常见问题并改善用户体验。用户可能不会立即向你报告 OneDrive 问题。在处理重要任务时，未报告的问题可能会导致不必要的问题。如果同步错误卡，则无需等待用户通知即可采取措施。
已知文件夹	显示当前正在使用的已知文件夹数的快照。已知文件夹移动允许用户通过将桌面、文档和图片文件夹同步到云与 OneDrive 来保护这些文件夹。如果要为组织推出已知文件夹移动，已知文件夹卡是监视进度的好方法。
同步应用版本	显示当前版本的 OneDrive 上运行的设备数。运行当前版本的 OneDrive 可帮助用户随时了解 Microsoft 提供的所有最新和最出色的修补程序和功能。将鼠标悬停在同步应用版本卡，以获取当前版本上操作系统的筛选视图。注意：本部分排除了 Mac App Store 设备，并将在计数中显示为“已排除的设备”。

设备

“设备”选项卡显示所有用户、其当前运行状况状态、当前在 OneDrive 中移动的已知文件夹、当前应用版本和操作系统版本、上次应用完全更新的时间戳，以及同步应用上次向仪表板报告运行状况数据时的时间戳。报告的最后一个状态时间戳 (UTC) 每隔大约 36 小时更新一次，或者在客户端启动后大约 1 小时更新一次。 “错误”列中的图标和状态指示每个设备的状态。

下表汇总了 “设备 ”选项卡的每一列中的信息：

列名称	说明
用户	用户的名称
用户电子邮件	用户的电子邮件地址
设备名称	设备名称
错误	设备的运行状况
已知文件夹	移动到 OneDrive 的文件夹的名称
应用版本	设备上运行的 OneDrive 的当前版本
操作系统	设备上运行的操作系统的当前版本
上次同步时间戳 (UTC)	上次同步应用与云完全保持最新状态的时间
报告的上次状态时间戳 (UTC)	同步应用上次向仪表板报告运行状况数据的时间

使用命令栏中的筛选器选项自定义显示在仪表板上的设备视图。标准筛选器包括“所有设备”，你可以在其中查看每个设备，以及“有错误的设备”，其中你只会看到有错误的设备。

可以使用自己的条件轻松创建自定义筛选器。在命令栏中，选择“ 筛选>新筛选器 ”，打开 “自定义筛选器 ”面板。命名筛选器并选择所需的条件。如果要按应用版本进行筛选，请确保输入完整的同步应用版本号（包括时间段）。之后，选择“ 创建 ”以使用新筛选器。

当组织中的某人报告将文件同步到 OneDrive 时，你可以快速调查，而无需通过 Microsoft Teams 聊天或 Outlook 电子邮件询问错误消息的其他详细信息。选择用户可查看其设备和同步状态的详细信息。此详细视图可让你查看用户的基本 OneDrive 信息，包括他们可能遇到的任何错误。

问题

“ 问题 ”选项卡显示运行状况报告中的 OneDrive 错误消息列表，以及组织中受这些消息影响的设备数。使用此视图可查看用户之间是否存在任何常见模式以及整个组织内存在的错误。

可以通过从列表中选择错误消息来了解有关错误和设备的详细信息。 “ 问题 ”面板将显示，其中包含受影响设备的摘要，以及用户及其当前应用版本和操作系统的列表。与用户合作解决常见的OneDrive 同步问题。

若要了解有关 OneDrive 错误消息的详细信息，请参阅 OneDrive 错误代码意味着什么？。

OneDrive 同步运行状况仪表板的数据

同步报告使用OneDrive 同步应用发送给 Microsoft 的运行状况数据。在谈到所使用的技术和共享的数据时，你可以做出选择。使用 EnableSyncAdminReports 设置来管理发送数据的设备。

若要详细了解可用的控件，请参阅Microsoft 365 应用版的隐私控件概述。若要了解有关所需服务数据的详细信息，请参阅 Office 所需的服务数据。

已知限制和注意事项

本部分介绍同步报告中的已知限制和注意事项。

限制

设备记录： 默认情况下，设备记录在清单中保留 30 天，之后这些记录将从报表中过期。

OneDrive 中的文件夹： 在 OneDrive 中包含文件夹的设备将在报表中显示为具有 0-3 个已知文件夹的设备。如果设备未在 OneDrive 中启用文件夹，它将在报表中显示为“概述”选项卡的“已知文件夹”部分中不符合条件的设备。在“设备”选项卡中， (“-”) 的连字符将显示在“已知文件夹”表的单元格值中，这些设备不适用于设备。此行为在意料之中。

同步应用版本：Mac App Store版本：对于使用 Mac App Store 版本的同步应用的设备，每个设备上安装的版本将显示在“设备”选项卡中。仪表板当前不会跟踪 Mac App Store 版本是否是 Mac App Store中可用的同步应用的最新版本。如果任何设备使用此版本，它们将从“概述”选项卡的“同步应用版本”部分排除，并显示排除的设备数。这是预期的结果。

设备符合资格的最短打开时间： 设备至少需要打开 5 小时才能获得报告。即使设置了组策略，仪表板中也可能会缺少频繁关闭和未打开该时间的设备。

用户登录： 如果用户注销，客户端不会向报表报告状态。

考虑：

在设备上启用同步报告设置后，对网络的影响可以忽略不计。
Microsoft 继续承诺满足和超过欧盟数据保护法的要求。所有数据存储都符合欧盟数据边界。
没有可用于同步报表的 Power BI 模板。
管理员将看到基于用户的客户端语言（而不是管理员配置的语言）的错误。

疑难解答

如果三天后未显示OneDrive 同步报告，请使用此部分进行故障排除。

重要

如果在不符合要求的设备上启用 EnableSyncAdminReports 设置，则不起作用。应用不会发送报告。

确认 EnableSyncAdminReports 设置已应用于设备。以管理员身份运行命令提示符，然后运行以下命令：

reg.exe query HKLM\Software\Policies\Microsoft\OneDrive /v EnableSyncAdminReports

输出应如下所示：

预期命令提示符输出的屏幕截图。

如果未应用 EnableSyncAdminReports 设置，请返回并按照设置OneDrive 同步运行状况仪表板下的步骤进行操作。

如果正确应用了设置，请等待 36 小时，设备处于打开状态并登录到 OneDrive。如果设备仍未显示在仪表板上，请向 Microsoft 开具支持票证。有关详细信息，请参阅下一部分报告问题。

报告问题

如果在查看仪表板报表时遇到问题，请先验证是否已完成故障排除部分中的步骤。

如果在故障排除后问题仍然存在，请向 Microsoft 开具支持票证。确保在此期间设备未关闭，以便同步应用仍可运行并发送运行状况报告。

为了快速调查，请确保具有启用 EnableSyncAdminReports 设置的日期和时间，并且问题报告中提供了用户的电子邮件或 OneDrive 设备 ID。

若要获取 OneDrive 设备 ID，请在通知区域中>选择“帮助 & 设置>设置>关于”中的OneDrive 同步应用。

发送反馈

我们重视你的反馈。若要提交功能建议和报告问题，可以使用仪表板页面右上角的“反馈”按钮。

“反馈”窗体的屏幕截图。