对 Microsoft Teams 的新基于 Slimcore 的优化进行故障排除时,需要知道用户是否已使用旧版 WebRTC 堆栈进行优化。 它们也可能最终处于回退模式“SlimCore Media Not Connected” (或服务器端呈现) 。
未使用 SlimCore 进行优化,而是会看到:
“Azure 虚拟桌面媒体优化”
“Citrix HDX 优化”- 错误代码 2000 (“无插件”) 和 2001 (“虚拟通道不可用”) 是最有可能的原因。
- 请确保“虚拟通道允许列表”已正确配置为允许 MSTEAMS、MSTEAM1、MSTEAM2。
- 确保终结点具有 插件,并且具有进程资源管理器的 VDI 客户端加载该插件:
- 运行 进程资源管理器。
- 启用底部窗格并切换到 DLL 选项卡。
- 在 Azure 虚拟桌面上,查找 msrdc.exe 过程并确保加载 MsTeamsPluginAvd.dll。
- 在 Citrix 上,查找 wfica32.exe 进程并确保加载 MsTeamsPluginCitrix.dll。
- 重启新的 Teams 应用。 首次检测到插件时,需要重启两次才能从 WebRTC 转换到 SlimCore。
- 如果问题仍然存在,检查 事件查看器虚拟机 (VM) Microsoft与 Teams VDI 相关的错误 (新的 Teams 24123.X.X.X 或更高版本) 。
未使用 SlimCore 进行优化,而是会看到:“Azure 虚拟桌面 SlimCore 媒体未连接”或“Citrix SlimCore 媒体未连接”。
- 查看 排查 SlimCoreVdi MSIX 部署错误 部分。 与 MSIX 或 AppX 相关的错误是此错误的最可能原因。
VDI 的新 Teams 日志
在 VM 上运行 Teams 时,可以通过选择 Ctrl+Alt+Shift+1 收集 Teams 日志。 此作在“下载”文件夹中生成 ZIP 文件夹。 在 PROD-WebLogs-*.zip 文件中,查找 Core 文件夹。
Vdi_debug.txt (main VDI 相关信息) 文件
Azure 虚拟桌面/W365 | Citrix |
---|---|
“vdiConnectedState”: {“connectedStack”: “remote”}, “vdiVersionInfo”: {“bridgeVersion”: “2024.18.1.11”, “remoteSlimcoreVersion”: “2024.18.01.11”, “nodeId”: “1051a908af6b160e”, “clientOsVersion”: “10.0.22631”, “rdClientVersion”: “1.2.5405.0”, “rdClientProductName”: “Microsoft®远程桌面”, “pluginVersion”: “2024.14.01.1”, “screenShareFallback”: true} | “vdiConnectedState”: {“connectedStack”: “remote”}, “vdiVersionInfo”: {“bridgeVersion”: “2024.18.1.14”, “remoteSlimcoreVersion”: “2024.18.01.14”, “nodeId”: “ffffffffffffff93eaee6a”, “clientOsVersion”: “10.0.22631”, “rdClientVersion”: “24.3.0.64”, “rdClientProductName”: “Citrix Workspace”, “pluginVersion”: “2024.15.01.3”, “screenShareFallback”: true} |
-
vdiConnectedState 显示当前活动调用堆栈。
- connectedStack: remote 指示 Teams 通过虚拟通道成功连接到远程终结点。 这并不一定意味着调用堆栈已成功初始化,因此用户仍可能会遇到与调用相关的故障,例如无法启动调用。
- connectedStack: 本地 表示虚拟通道连接失败。 用户现在处于回退模式。
-
vdiVersionInfo 为 Teams 客户端和终结点提供了有用的信息。
- bridgeVersion 与 VM 上运行的 Teams 桌面客户端版本相关联。
- remoteSlimcroreVersion 是终结点上可用的 SlimCore VDI 版本。
- nodeId 是绑定到终结点的唯一 ID。
- clientOsVersion 是终结点的 OS 版本。
- rdClientVersion 是在终结点上运行的远程桌面客户端版本,用于连接到 VM。
- rdClientProductName 是在终结点上运行的远程桌面客户端的名称。
- pluginVersion 是集成到远程桌面客户端中的插件的版本。
Diagnostics-logs.txt 可能位于 weblogs\user ( 上。)
为了进一步调查 VDI 连接相关问题,使用 关键字 (keyword) vdiBRidgeEventsHandler 提供 vdiBridge 连接和断开连接事件处理中的日志,如以下成功连接与新优化堆栈) 示例中 (连接事件处理) 所示:
7432 2024-03-01T17:51:22.032Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - onConnected: end, currentStack=remote 7435 2024-03-01T17:51:22.032Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - new calling stack type set: currentStack=remote 7436 2024-03-01T17:51:22.032Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - deviceManagerService reloaded 7445 2024-03-01T17:51:22.031Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - calling stack reinit complete with nextStack=remote 7464 2024-03-01T17:51:21.785Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - starting calling stack reinit with nextStack=remote 7465 2024-03-01T17:51:21.785Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - SlimCore replacement complete, remote is now available 7467 2024-03-01T17:51:21.783Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - setVDIOptimizationModeOverride: from SlimCore to SlimCore 7468 2024-03-01T17:51:21.782Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - onConnected: isVersionMismatch=false, forceVersion=undefined, bridgeVersion=2024.5.1.11 7469 2024-03-01T17:51:21.782Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - cached local SlimCore for future (fallback), currentStack=local 7470 2024-03-01T17:51:21.782Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - onConnected: start, vendorType=1, remoteSlimcoreVersion=2024.05.01.11, platform=win-x86, loadErrc=1, deployErrc=24002, nodeId=ffffffffbd7d5e77 7471 2024-03-01T17:51:21.782Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - enqueueBridgeCallback: adding onConnected to queue, 0 bridge callbacks in queue, isBridgeCallbacksQueueProcessing=false
连接错误
如果存在连接错误,可以从包含“loadErrc”和“deployErrc”的日志行中找到错误代码。 部署错误 (也称为install_error) 是插件尝试从Microsoft的内容分发网络下载 SlimCore MSIX 包时发生的错误。 然后,该插件尝试使用适用于 AppX 的应用就绪服务将包暂存或预配到终结点。 加载错误是插件尝试启动 MsTeamsVdi.exe 并建立远程过程调用 (RPC) 时发生的错误。
此处记录的代码需要使用此表进行映射:
loadErrc | deployErrc | 定义 | 注释 |
---|---|---|---|
0 | 0 | 还行 | 不是错误。 “SlimCore Connected”成功 |
5 | 43 | ERROR_ACCESS_DENIED | MsTeamsVdi.exe 进程在启动时失败。 启用 BlockNonAdminUserInstall 可能会导致此错误。 或者终结点可能在用户登录后忙于注册多个 MSIX 包,并且未完成 SlimCoreVdi 的注册。 |
404 | 3235 | HTTP_STATUS_NOT_FOUND | 发布问题:在内容分发网络上找不到 SlimCore MSIX 包。 |
1260 | 10083 | ERROR_ACCESS_DISABLED_BY_POLICY | 此错误通常意味着Windows 程序包管理器无法安装 SlimCore MSIX 包。 事件查看器可以在0x800704EC显示十六进制错误代码。 AppLocker 策略可能会导致此错误代码。 可以禁用 AppLocker,也可以在本地安全策略 - 应用程序控制>策略 -> AppLocker 中添加 SlimCoreVdi 包的例外。 查看“使用 Teams 的新 VDI 解决方案进行优化”下 的步骤 3 。 |
1460 | 11683 | ERROR_time输出 | MsTeamsVdi.exe 进程在启动 (60 秒超时) 失败。 |
1722 | RPC_S_SERVER_UNAVAILABLE | “RPC 服务器不可用”MsTeamsVdi.exe 相关错误。 | |
2000 | 16002 | 无插件 | 终结点没有 MsTeamsPlugin,或者如果具有 MsTeamsPlugin,则不会使用进程资源管理器) 加载 (检查。 |
2001 | 虚拟通道不可用 | Citrix VDA (虚拟传递代理) WFAPI 时出错。 | |
2003 | 16026 | 由于 Citrix Studio 策略,自定义虚拟通道 (MSTEAMS、MSTEAM1和MSTEAM2) 被阻止 | 查看 VDI 2.0 一文的 Citrix 虚拟通道允许列表 部分。 |
2005 | 16043 | Teams 作为已发布的应用 (Citrix) 或 RemoteApp (AVD/Windows 365) | 当前不支持此模式 - 在这种情况下,Teams 不会加载 SlimCore,并且用户始终使用 WebRTC 进行优化。 |
3000 | 24002 | 不需要 SlimCore 部署 | 此代码实际上不是错误。 这是一个很好的指标,表明用户使用的是 SlimCore 的新优化体系结构。 |
3001 | 24010 | SlimCore 已加载 | 此代码实际上不是错误。 这是一个很好的指标,表明用户使用的是 SlimCore 的新优化体系结构。 |
3004 | 24035 | 插件不响应 | 尝试重启 RDP (远程桌面协议) 或 ICA (独立的计算体系结构) 会话。 |
3005 | 24043 | 下载时插件超时 | 未能在 2 分钟内下载 MSIX。 |
3007 | 24058 | 加载超时 | SlimCore 下载或安装超时, (Internet 速度缓慢或应用就绪服务正忙于) 。 |
4000 | ERROR_WINS_INTERNAL | WINS 在处理命令时遇到错误。 | |
15615 | 1951 | ERROR_INSTALL_POLICY_FAILURE | SlimCore MSIX 相关错误。 若要安装此应用,需要 Windows 开发人员许可证或启用旁加载的系统。 AllowAllTrustedApps regkey 可能设置为 0? |
15616 | ERROR_PACKAGE_UPDATING | 与 SlimCore MSIX 相关的错误“无法启动应用程序,因为它当前正在更新”。 | |
15700 | APPMODEL_ERROR_NO_PACKAGE | 进程没有包标识。 %LOCALAPPDATA%\Microsoft\WindowsApps 中没有 MsTeamsVdi 的别名。 重现错误时需要反馈中心日志 (请确保选择“开发人员平台”作为类别,并选择“应用部署”作为子类别) | |
16389 | 包管理器报告的E_FAIL | 通常与加载错误代码 5 (ERROR_ACCESS_DENIED) 相同。 如果用户不是管理员,很可能是由 BlockNonAdminUserInstall 策略引起的。有关更多详细信息,请查看此链接。 |
在 VM 上使用事件查看器进行故障排除
每个连接/断开连接事件都记录在虚拟机上运行的事件查看器中。 事件查看器还可以显示与客户端相关的错误。 按源 (筛选Microsoft Windows Logs\Application 下的 Teams VDI) 和事件 ID (0) 。 可以在 VDI 的新 Teams 日志 部分找到错误代码。
注意
为了能够按源进行筛选,需要从提升的 PowerShell 窗口运行此命令:
PS C:\Windows\system32> New-EventLog -LogName Application -Source “Microsoft Teams VDI”
排查插件部署错误
可以在用户设备上的详细事件日志中找到诊断信息。 安装后,MsTeamsPluginCitrix.dll 将写入 CWA (Citrix 工作区应用) 文件夹中。 仅对于 Citrix 平台,才会在终结点上创建以下密钥 (而不是 VM) :
密钥 | 密钥类型 | 密钥名称 | 键值 |
---|---|---|---|
HKLM\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ICA 3.0 | String | VirtualDriverEx | MicrosoftTeamsVDI |
HKLM\SOFTWARE\WOW6432Node\Citrix\ICAClient\Engine\Configuration\Advanced\Modules\MicrosoftTeamsVDI | String | DriverNameWin32 | MsTeamsPluginCitrix.dll |
若要调试安装,可以启用安装程序日志记录,但随后必须手动使用 msiexec 并传递正确的标志。 例如,如果当前未安装插件,则可以使用如下所示的日志进行安装:msiexec.exe /i MsTeamsPluginCitrix.msi /l*vx installer.log.txt。
SlimCoreVdi MSIX 部署错误疑难解答
请确保查看 终结点上的 SlimCore MSIX 暂存和注册 部分,因为某些 GPO (组策略) 可能会阻止 MSIX 安装。
可以在用户设备上的详细事件日志中找到诊断信息。
转到 Windows Microsoft本地) > 应用程序和服务日志>事件查看器 (>。
检查以下类别下的可用日志:
- AppxPackagingOM > Microsoft-Windows-AppxPackaging/Operational
- >AppXDeployment-Server Microsoft-Windows-AppXDeploymentServer/Operational
查看 AppXDeployment-Server 下的日志。
错误 15615
错误 15615 通常意味着Windows 程序包管理器无法使用 SlimCoreVdi 安装 MSIX 包。
- 确保终结点信任该 MSIX 的数字签名, (转到 MSIX > 属性 > 数字签名 > 详细信息) 。 这是一个有效的商店友好Microsoft签名,但客户可能配置了一些特殊内容。
- 尝试启用 AllowAllTrustedApps 策略。
- 尝试允许从受信任的非存储源旁加载应用。
- 在 Windows 10 上,此设置默认处于启用状态,因此,如果发现此设置已禁用,请在此处对其进行修改:面向开发人员>的设置>更新和安全>旁加载应用。
- 在Windows 11上,此设置默认启用:“设置>”“应用>高级应用设置>”选择在任意位置获取应用>的位置。
日志收集
日志记录可在以下位置找到:
- 在客户端上:
AppData\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\skylib
AppData\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\media-stack
- 在服务器上:
AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs\skylib