VDI 2.0 故障排除

对 Microsoft Teams 的新基于 Slimcore 的优化进行故障排除时,需要知道用户是否已使用旧版 WebRTC 堆栈进行优化。 它们也可能最终处于回退模式“SlimCore Media Not Connected” (或服务器端呈现) 。

  • 未使用 SlimCore 进行优化,而是会看到:
    “Azure 虚拟桌面媒体优化”
    “Citrix HDX 优化”

    • 错误代码 2000 (“无插件”) 和 2001 (“虚拟通道不可用”) 是最有可能的原因。
    1. 请确保“虚拟通道允许列表”已正确配置为允许 MSTEAMS、MSTEAM1、MSTEAM2。
    2. 确保终结点具有 插件,并且具有进程资源管理器的 VDI 客户端加载该插件:
    • 运行 进程资源管理器
    • 启用底部窗格并切换到 DLL 选项卡。
    • 在 Azure 虚拟桌面上,查找 msrdc.exe 过程并确保加载 MsTeamsPluginAvd.dll。
    • 在 Citrix 上,查找 wfica32.exe 进程并确保加载 MsTeamsPluginCitrix.dll。
    1. 重启新的 Teams 应用。 首次检测到插件时,需要重启两次才能从 WebRTC 转换到 SlimCore。
    2. 如果问题仍然存在,检查 事件查看器虚拟机 (VM) Microsoft与 Teams VDI 相关的错误 (新的 Teams 24123.X.X.X 或更高版本) 。
  • 未使用 SlimCore 进行优化,而是会看到:“Azure 虚拟桌面 SlimCore 媒体未连接”或“Citrix SlimCore 媒体未连接”。

VDI 的新 Teams 日志

在 VM 上运行 Teams 时,可以通过选择 Ctrl+Alt+Shift+1 收集 Teams 日志。 此作在“下载”文件夹中生成 ZIP 文件夹。 在 PROD-WebLogs-*.zip 文件中,查找 Core 文件夹。

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 显示当前活动调用堆栈。
    • connectedStackremote 指示 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 安装。

可以在用户设备上的详细事件日志中找到诊断信息。

  1. 转到 Windows Microsoft本地) > 应用程序和服务日志>事件查看器 (>。

  2. 检查以下类别下的可用日志:

    • AppxPackagingOM > Microsoft-Windows-AppxPackaging/Operational
    • >AppXDeployment-Server Microsoft-Windows-AppXDeploymentServer/Operational
  3. 查看 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