微软团队
Citrix Director 中的 Microsoft Teams 控制板可查看所有用户的 Microsoft Teams 通话，以及参与者详细信息和指示通话性能的指标。该控制板提供以下功能：
- 评估微软 Teams 使用情况摘要
- 筛选并查看选定持续时间内 Microsoft Teams 通话的详细信息
- 使用性能指标来评估个人通话
先决条件
请将 微软图形 应用程序编程接口 (API) 添加到 思杰 Director 的允许列表中：
- 为了让 Director 访问通话记录，请确保在安装 Director 的所有计算机上都可进行出站互联网访问。具体来说，请确保 https://graph.microsoft.com URL 可访问
- 如果您使用代理服务器，请确保 微软图形 API : https://graph.microsoft.com 网址可访问。
开始使用
连接到 Microsoft Graph 应用程序编程接口
微软通话详细信息是从微软 Graph 应用程序编程接口获取的。为了让 Citrix Director 访问此应用程序编程接口，需要在 Microsoft Entra ID 中创建一个具有所需权限的应用程序。Graph 应用程序编程接口 URL 也需要添加到 Director 的允许列表中。
请按照以下步骤完成连接操作：
步骤 1：在 微软 Entra ID 中注册应用程序
-
在 Microsoft Entra ID 中，导航到 应用注册 -> 新注册。
- 执行应用注册所需的步骤。
- 注册后，复制应用程序的客户端 ID 和租户 ID。
步骤 2：在 微软 Entra ID 中添加 微软 Graph 权限
- 导航到 API 权限 -> 添加权限。
-
选择 Microsoft Graph，然后选择 应用程序权限。
-
请确保为 CallRecords.Read.All 和 User.Read.All 这两个重要的权限项添加必要的访问权限。
-
单击 为 MSFT 授予管理员同意。此操作需要 Entra ID 全局管理员权限。
步骤 3：创建客户端密钥
-
在 Microsoft Entra ID 中，导航到 证书和密钥 -> 客户端密钥 -> 新客户端密钥。您也可以重复使用现有密钥。
- 请为该密钥指定一个名称和过期日期。务必确保在密钥过期之前完成续订，以维持连接的正常运行。
- 复制客户端密钥以在 Director UI 中使用。
如果遇到任何问题，请参阅官方 Azure 文档。
步骤 4：在 Director 上完成连接
-
在 Director 中，导航到 设置 -> 连接实时通信应用程序。
-
单击 创建连接，然后输入从应用程序注册中复制的应用程序 ID、目录 ID 和客户端密钥。
如果提供了有效的凭据和获取呼叫详细信息的权限，则连接将成功建立。
-
您可以通过单击行末尾的省略号来编辑和删除连接。
微软团队控制板
导航到 Director UI 中的实时通信选项卡。Microsoft Teams 控制板将填充从已建立的 Microsoft Graph 连接收集的数据。呼叫结束后大约 15 分钟即可获取呼叫详细信息。
表格视图提供所有呼叫的以下详细信息。
| 列名称 | 详细说明 |
|---|---|
| 呼叫 ID | 每次呼叫的唯一标识符。 |
| 呼叫类型 | 指示呼叫是点对点呼叫还是群组呼叫。 |
| 模式 | 指示呼叫期间使用的模式，例如音频、视频或屏幕共享。 |
| 开始时间 | 呼叫开始的日期和时间。 |
| 结束时间 | 呼叫结束的日期和时间。 |
| 持续时间 (mm: ss) | 呼叫的持续时间（分钟和秒）。 |
单击表中的单个呼叫以查看每个用户的故障和性能详细信息。
在群组通话中，当用户断开连接并重新加入时，这被视为一个单独的会话。此考量有助于识别特定问题，例如连接到特定网络时延迟较高。
呼叫详细信息表中的每一行都包含以下信息：
| 列名称 | 描述信息 |
|---|---|
| 开始时间 | 呼叫或参与者会话开始的日期和时间。 |
| 往返时间（平均） | 数据包的平均往返时间。 |
| 丢包率（平均） | 通话期间丢失数据包的平均百分比。 |
| 抖动（平均） | 接收数据包延迟的平均变化。 |
| 故障阶段 | 指示呼叫失败发生的阶段，例如在设置期间或通话过程中。 |
| 结束时间 | 通话或参与者会话结束的日期和时间。 |
| 呼叫方 | 通话中参与者的姓名。 |
| 带宽估算（平均） | 通话期间使用的平均带宽估算值。 |
您可以通过两种方式筛选用户：按 Citrix 用户名或按 Microsoft Teams 用户名。您可以使用页面顶部的单选按钮在这两个选项之间切换。
- Citrix 用户名：当您开始键入用户名时，系统会建议匹配的用户。然后，您可以选择特定帐户以查看详细信息。
- Microsoft Teams 用户名：如果与 Microsoft Teams 帐户关联的电子邮件或用户主体名称 (UPN) 与 Citrix 帐户 ID 不同，请使用此选项。使用此方法时，您必须输入完整且有效的电子邮件地址。
故障排除
-
为什么载入失败并出现错误“Azure API 已阻止。要创建连接，请将 Azure API 添加到您的允许列表”？
解决方案：确保您已遵循先决条件并将 Microsoft Graph API 终结点添加到您的允许列表。
-
为什么在查看通话时会看到错误“Microsoft Graph API 已阻止”？
解决方案：请确保您已遵循先决条件，并将 Microsoft Graph API 终结点添加到您的允许列表。
-
为什么“连接”屏幕会显示“Microsoft Entra ID 中缺少所需的应用程序权限”？
缺少权限(/zh-cn/citrix-virtual-apps-desktops/2511/media/missing-required-application-permissions.png)
解决方案： 验证应用程序权限 CallRecords.Read.All 和 User.Read.All 已分配给 Entra 标识应用程序。