适用于 Teams 的新 VDI 解决方案

适用于: Microsoft Teams

适用于 Teams 的新 VDI 解决方案是一种用于优化虚拟桌面中多媒体工作负载交付的新体系结构。

系统要求

要求	最低版本
Teams	适用于 Azure 虚拟桌面/Windows 365) 的 -24193.1805.3040.8975 (适用于 Citrix) 的 -24295.605.3225.8804 (适用于 Amazon) 的 -25198.1109.3837.4725 ( -MAC 终结点需要 26072.521.4595.7966 或更高版本适用于 Omnissa) 的 26072.521.4595.7966 (
Azure 虚拟桌面/Windows 365	-适用于 Windows 的 Windows 应用：2.0.352.0 -适用于 Windows 的远程桌面客户端：不再受支持。升级到最新的 Windows 应用。 -Windows 应用 for MAC：11.3.4 非 App Store 版本。用户必须使用可自动更新的独立.pkg文件。不支持 Microsoft Store 版本。 - 最新 MAU 客户端的常青链接： https://aka.ms/RDMacMAU
Citrix	-Virtual Desktop Agent (VDA) ：2203 LTSR (长期服务版本) CU) 3 或 2305 (累积更新 (CR) 的当前版本 -适用于 Windows 的 CWA) (Citrix Workspace 应用程序：2203 LTSR (任何累积更新) 、2402 LTSR 或 2302 CR。 -MsTeamsPluginCitrix：适用于 Windows) 的 2024.41.1.1 (-适用于 MAC 的 Citrix Workspace 应用程序：2508.10 -MsTeamsPluginCitrix：2025.49.x.x 适用于 MAC 的 () aka.ms/macplugin -仅支持未处于生命周期结束时的 CWA 版本
Amazon WorkSpaces	客户端 5.31.0.5733。 WSP (Server Agent) 2.1.0.1840
Omnissa Horizon	用于 Windows 8.17 或更高版本的客户端
Endpoint	-Windows 10 1809 (Windows 企业长期服务频道) - SlimCore 最低要求支持 Windows 10 2019/2021 或 Windows 11 2024 上的瘦客户端 - GPO 不得阻止 MSIX 安装， (请参阅步骤 3：终结点上的 SlimCore MSIX 暂存和注册) -最低 CPU：Intel Celeron (或同等) @ 1.10 GHz，四核，最小 RAM：4 GB-macOS 14、15 或 26 (需要 CWA 2511)

组件

组件	角色	更新	大小	注释
Teams vdiBridge	服务器端虚拟通道模块。	每个 Teams 版本的新版本。		与 Teams 捆绑。
自定义虚拟通道 (VC)	由 Microsoft Teams 拥有的自定义 VC。	稳定 API - 预计不会有更新。		检查 Citrix Studio 策略虚拟频道允许列表。
插件	客户端 VC DLL。还负责 SlimCore 的下载和清理。	不频繁 (最好不更新) 。	大约 600 KB。	捆绑 Windows 远程桌面客户端 1.2.5405.0、Windows 1.3.252 的 Windows 应用和 MAC 的 Windows 应用 11.3.4 MAU 客户端或更高版本。适用于 Windows 或更高版本的 Citrix CWA 2402 可以获取并安装插件。 CWA 2508.10 for MAC 捆绑了适用于 Windows 的 Amazon WorkSpaces 客户端 5.31.0.5733 或更高版本。与适用于 Windows 的 Omnissa Horizon Client 8.17 (2512) 捆绑在一起
SlimCore	媒体引擎 (特定于操作系统，而不是特定于 VDI 供应商的) 。	随每个新 Teams 版本自动更新到新版本。	大约 50 MB。	Microsoft 公共内容分发网络上托管的 MSIX 包。

使用适用于 Teams 的新 VDI 解决方案进行优化

步骤 1：确认先决条件

确保对于 Azure 虚拟桌面/Windows 365) 装有新的 Microsoft Teams 版本 24193.1805.3040.8975 或更高版本 (，对于 Citrix 装有 24295.605.3225.8804 或更高版本，或装有 26032.206.4355.6508 装配 Omnissa。
如有必要，为特定用户组启用 Teams 策略 (默认情况下，该策略处于全局组织范围级别启用) 。
对于 Citrix，必须配置 虚拟频道允许列表 ，如本文的 Citrix 虚拟频道允许列表部分所述。
对于 Amazon WorkSpaces，请确保适用于 Windows 的 WorkSpace 客户端为 5.31.0.5733 或更高版本。
对于 Omnissa Horizon，优化现已正式发布 - 请确保适用于 Windows 的 Horizon Client 是 8.17 (2512) 或更高版本。

步骤 2：在终结点上安装插件

对于 Azure 虚拟桌面和 Windows 365，MsTeamsPluginAvd.dll 捆绑有用于 Windows 1.2.5405.0 的远程桌面客户端、用于 Windows 1.3.252 或更高版本的 Windows 应用 Store 应用，以及用于 MAC 的 Windows 应用非存储版本 11.3.4
- 该插件位于安装远程桌面客户端的同一文件夹位置。你可以在 AppData\Local\Apps\远程桌面或 C：\Program Files (x86) 找到插件，具体取决于它的安装模式。
- 基于 MSIX 的 Windows 应用 Store 应用位于 C：\Program Files\WindowsApps 中。对此文件夹的访问受到限制。
对于 Amazon WorkSpaces，MsTeamsPluginAmazon.dll 与适用于 Windows 5.28.0.5487 或更高版本的 WorkSpaces 客户端捆绑在一起。
- 该插件位于安装 WorkSpaces 客户端的同一文件夹位置。
对于 Omnissa Horizon，MsTeamsPluginOmnissa.dll 与 Windows 8.17 (2512) 或更高版本的 Horizon Client 捆绑在一起。
- 该插件位于安装 Horizon Client 的同一文件夹位置 (C：\Program Files\Omnissa\Omnissa Horizon Client) 。
对于适用于 Windows 2402 或更高版本的 Citrix Workspace 应用程序，可以安装 MsTeamsPluginCitrix.dll：
- 安装 Citrix Workspace 应用程序时使用用户界面：
  
  在 “加载项 () ”页上，选中“ 安装 Microsoft Teams VDI 插件 ”复选框，然后选择 “安装”。
  
  同意弹出的用户协议并继续安装 Citrix Workspace 应用程序。
  
  注意
  
  适用于 Windows 2402 的 Citrix Workspace 应用程序仅在全新安装时显示插件安装 UI。
  若要使就地升级也显示此选项，需要适用于 Windows 2405 或 Mac 2603 更高版本的 Citrix Workspace 应用程序。
  CWA for Windows 2508 中引入了 CWA 自动更新时自动安装插件的功能。
  从适用于 Windows 的 Citrix Workspace 应用程序 2603 开始，CWA 可以自动将插件更新到最新版本，甚至在 CWA 自动更新到较新版本之前也是如此。
  有关更多信息，请检查此 Citrix 文章
- 通过命令行或脚本，针对托管 Windows 设备使用 C：>CitrixWorkspaceApp.exe /installMSTeamsPlugin

管理员还可以在任何现有受支持的 Citrix Workspace 应用程序之上手动安装插件， (查看系统要求) 使用SCCM (使用 Windows 应用程序包部署类型) 或Intune (使用业务线应用程序) 等工具。

管理员可以将 msiexec 与适当的标志一起使用，如 msiexec 中所述。
重要
- Citrix 客户的 Windows 插件 MSI 下载链接：
  - 适用于 32 位 Workspace 应用 aka.ms/plugin。
  - 对于 64 位 Workspace 应用 (新的) aka.ms/plugin_x64。
  - 对于基于 ARM 的 Workspace 应用程序 https://aka.ms/plugin_arm64。
  - Citrix Workspace 应用程序 (wfica 进程) 只能从同一架构加载插件 (换句话说，32 位 CWA 加载 64 位 DLL 将无法优化)
- Citrix 客户的 Mac 插件下载链接 aka.ms/macplugin
插件 MSI 会自动检测 CWA 安装文件夹并将 MsTeamsPluginCitrix.dll 放置在该位置。
插件只能在没有活动的虚拟桌面会话时升级。
插件不能降级，只能升级或重新安装 (修复) 。
不支持按用户安装 CWA。
如果在端点上未找到CWA，则停止安装。

用户类型	安装文件夹	安装类型
Administrator	64 位：C：\Program Files (x86) \Citrix\ICA 客户端 32 位：C：\Program Files\Citrix\ICA 客户端	按系统安装

发行说明版本	详细信息
2026.29.1.4	2026 年 7 月 - 修复了瘦客户端或展台设备的 MSIX 预配和注册问题，这些问题阻止新用户使用新体系结构进行优化。 - 从此插件版本开始，仅支持拆分的 MSIX 包。 - 安全增强
2026.15.1.1	2026 年 4 月 - 改进了客户端监视器可靠性，以减少错误断开连接并确保从暂时性网络中断中更稳定地恢复。 - 支持将 Teams 作为已发布的应用程序 (Citrix 虚拟应用程序)
2025.43.1.1	2025 年 11 月 - 虚拟通道处理和传输的改进。 - 改进了 MSIX 安装过程 (当临时) 不可用时，下载位置更新为 localappdata。增强了 BITS 下载程序的可靠性。 -日志记录和遥测修复，以改进诊断
2025.29.1.2	2025 年 8 月 - 其他日志记录和遥测功能
2025.24.1.3	2025 年 7 月 - 如果 TEMP/TMP 环境 (系统) 变量指向 RAM 磁盘，则使用带有 RAM 覆盖的统一写入筛选器的精简客户端可能会遇到 SlimCore MSIX 安装错误。此插件可解决此问题。有关更多详细信息，检查本文后面 (UWF) 部分的统一写入筛选器。它还通过在虚拟机中创建注册表项来支持禁用 HID (请参阅“VDI 中的外围设备”部分 )
2025.14.1.8	2025 年 5 月 - Citrix 插件现在可以下载 64 位的 SlimCore 软件包，从而提高性能并改善屏幕共享体验。当 Teams 为 25094.x.x.x 或更高版本时，此版本还支持 SlimCore 拆分 MSIX 包，从而简化了用户对相机和麦克风权限的提示。请参阅步骤 3 中的“新建拆分 MSIX 包”：终结点上的 SlimCore MSIX 暂存和注册。
2024.41.1.1	2024 年 10 月 - 在多显示器设置中使用 SlimCore 时，Citrix 用户无法共享整个屏幕或单个显示器。 - 如果在建立虚拟通道后 SlimCoreVdi MSIX 包注册失败，则尝试 Reset-AppxPackage 。
2024.32.X.X	2024 年 8 月 - 如果 AppExecution 别名缺失，插件现在会尝试 Reset-AppxPackage SlimCoreVdi MSIX 包。

步骤 3：终结点上的 SlimCore MSIX 暂存和注册

插件以静默方式执行此步骤，无需用户或管理员干预。暂存和注册依赖于终结点上的 App Readiness Service (ARS) 。组策略或第三方工具设置的注册表项可能会阻止 MSIX 包安装。有关适用注册表项的完整列表，请参阅“组策略如何与打包应用配合使用 - MSIX）。

重要

新的拆分 MSIX 包 提供了一个新的 64 位 Slimcore 安装程序，它将媒体引擎安装拆分为两个不同的 MSIX 包，称为主机和框架。如果在用户设备上配置了此更改，则会直接影响 AppLocker/WDAC/组策略对象 (GPO) ：

(~100 KB) [Microsoft.Teams.SlimCoreVdiHost.win-x64_8wekyb3d8bbwe] 的主机包负责在单个包系列名称 (PFN) 下将 SlimCore 注册为 Windows 操作系统中的应用程序 - 这在“设置”/“应用”/“已安装的应用”下显示为“Microsoft Teams VDI 优化器”。用户向此应用授予相机/麦克风/位置权限后，将不会再次收到提示。这解决了以前的 SlimCore MSIX 安装程序的限制，该安装程序具有不同的 PFN，因此每次在 VM 中升级 Teams 时，它都会重新触发外围设备访问的用户提示。 MsTeamsVdi.exe 从主机包加载，它仍然是负责所有网络通信的进程。
框架包 (~60 MB) [Microsoft.Teams.SlimCoreVdiFwk.win-x64.<version>_8wekyb3d8bbwe] 仅包含实时媒体库。这些程序包具有不同的 PFN 和版本控制。它们在“应用”/“已安装的应用”下不可见。多个框架包可以共存于同一终结点中。 MsTeamsVdi.exe 将在虚拟机上自动加载与 Teams 版本匹配的框架包。
最低系统要求：
具有 Teams 25153.x.x.x 和远程桌面客户端 1.2.6278/Windows 应用 2.0.550.0 的 AVD/W365 环境。
使用 Teams 25094.x.x.x 和插件 2025.14.1.8 的 Citrix 环境

以下注册表项可能会阻止新媒体引擎 MSIX 包安装：

BlockNonAdminUserInstall
AllowAllTrustedApps
AllowDevelopmentWithoutDevLicense

重要

启用了 BlockNonAdminUserInstall 的托管终结点/瘦客户端仍允许安装 SlimCore 包。应用 KB5052094 (Windows 11 23H2 和 22H2) 、KB5052093 (Windows 11 24H2) 、KB5055612 (Windows 10 22H2) 或任何后续 KB。此安装在本地组策略编辑器中引入了一个名为“允许非管理员用户安装的包系列名称”的新组策略：

组策略编辑器 ->计算机配置 -> 管理模板 -> Windows 组件 -> 应用包部署 -> 然后，管理员可以通过允许使用完整的包系列名称 (（例如 Microsoft.Teams.SlimCoreVdi.win-x64.2024.43_8wekyb3d8bbwe) ）或使用正则表达式 (（例如 Microsoft.Teams.SlimCoreVdi.*_8wekyb3d8bbwe) ）来将 SlimCore 包加入允许列表。

对于新的拆分 MSIX 包体系结构，必须将两个新包添加到允许列表 (Microsoft.Teams.SlimCoreVdiHost.win-x64_8wekyb3d8bbwe 和 Microsoft.Teams.SlimCoreVdiFwk.*_8wekyb3d8bbwe) 。
这也可以使用正则表达式来实现：Microsoft.Teams.SlimCoreVdi*.*_8wekyb3d8bbwe

重要

如果禁用 AllowAllTrustedApps，MSIX) 安装的新媒体引擎 (失败。此问题已在以下 Windows 累积更新中修复：

这三个注册表项可以在用户设备上的以下任一位置找到：

HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock
HKLM\SOFTWARE\Policies\Microsoft\Windows\Appx

某些策略可能会更改这些注册表项，并阻止组织中的应用安装，因为管理员设置了限制性策略。一些可能阻止安装的已知 GPO 策略包括：

防止非管理员用户安装打包的 Windows 应用。
允许所有受信任的应用安装 (禁用) 。

注意

AppLocker 或 Windows Defender 应用程序控制也可能阻止安装 MSIX 包。 AppLocker 是一项深层防御安全功能，不被视为可防御的 Windows 安全功能。如果目标是针对威胁提供可靠的保护，并且不希望安全功能实现此目标，因此没有设计限制，请使用 Windows Defender 应用程序控制。

重要

确保没有阻止配置或策略，或在“本地安全策略 - 应用程序控制策略 ->> AppLocker”中为 SlimCore MSIX 包添加异常。与 Windows Defender 应用程序控制不同，AppLocker 无法处理尾随通配符。由于旧的 SlimCoreVdi 包或新的框架包包含特定于版本的 PackageFamilyName (，例如 Microsoft.Teams.SlimCoreVdi.win-x64.2024.36_8wekyb3d8bbwe 或 Microsoft.Teams.SlimCoreVdiFwk.win-x64.2025.14_2025.14.1.4_x64__8wekyb3d8bbwe) ，因此客户可以改为依赖 PublisherID 8wekyb3d8bbwe 来添加 AppX 或 MSIX 排除项。新的主机包是单个包系列名称 (Microsoft.Teams.SlimCoreVdiHost.win-x64_8wekyb3d8bbwe) 。

管理员使用更精细的按应用程序“ AllAppList” 来定义允许运行的应用程序列表时，需要以这种方式添加例外， (因为 SlimCore 遵循 UWP 模型) ：

<应用 AppUserModelId=“Microsoft.Teams.SlimCoreVdi.<平台>架构>。<<release_version>_8wekyb3d8bbwe！MsTeamsVdi“ />

对于旧的 MSIX 安装程序： <App AppUserModelId="Microsoft.Teams.SlimCoreVdi.win-x86.2025.12_8wekyb3d8bbwe!MsTeamsVdi" />.
对于新的拆分 MSIX 体系结构： <App AppUserModelId="Microsoft.Teams.SlimCoreVdiHost.win-x64_8wekyb3d8bbwe!MsTeamsVdi" />.

要查找已发布的 SlimCore 包列表，请检查此表。

Mac 终结点

注意

Mac 现已 100% 全面推出，适用于 AVD/W365 和 Citrix 环境。

满足本文前面所述的最低要求的用户可以使用基于 SlimCore 的新体系结构 (优化) 。

AVD 和 Windows 365 客户必须使用非存储Windows 应用版本 (也称为 Microsoft AutoUpdate 或 MAU 客户端) ，因为只有该版本捆绑插件。 App Store Windows 应用不包括插件，因此用户将保留在基于 WebRTC 的优化中。常青到最新 MAU 客户端的链接： https://aka.ms/RDMacMAU

对于 Citrix 客户，CWA 2508.10 可以在安装时显示一个用户界面，提示用户安装插件，但此流程需要用户操作。 CWA 2603 还支持通过全局应用程序配置服务或 Citrix Studio 中的虚拟通道插件下载管理器策略进行插件部署。
即将推出的 CWA (2607) 版本将自动安装插件。管理员还可以使用 JAMF 等其他工具部署插件。

重要

该插件负责在 Mac 设备上建立虚拟通道以及自动和静默媒体引擎安装。
适用于 Mac 的插件还捆绑了 Host SlimCore MSIX 包。因此，在 macOS 上获取并安装的 SlimCore 包是仅限 ( Microsoft的框架。Teams.SlimCoreVdi.mac-arm64') 。多个版本可以在同一用户设备上共存。 VM 上的 Microsoft Teams 版本决定了插件需要哪个 SlimCore 版本。
所有这些活动对用户和管理员都是透明的。
位置： /Applications/Utilities/MsTeamsVdi.Plugin.app

SlimCoreVdi 安装文件夹

对于 AVD/W365，/users/{USER}/Library/Containers/Windows App/Data/Library/Application Support/Microsoft/TeamsVDI/Packages/
对于 Citrix，/users/{user}/library/application support/Microsoft/TeamsVDI/Packages

Mac 中的日志收集

日志存储在用户设备上的以下目录中：~/Library/Application Support/Microsoft/TeamsVDI

Mac 中不支持的功能

HID (目前仅在公共预览版中可用)
作为与会者进行全体大会优化
对于 AVD/W365，当前不支持跨云
在端到端加密会议中禁用传出屏幕共享
共享系统音频
macOS 网络设置中的经验证的代理仅 (AVD/W365)
仅限 e911 (AVD/W365 中的 LLDP) (链路层发现协议)
远程应用/已发布的应用

Mac 中的已知问题

应用共享期间演示者的鼠标光标缓慢。如果演示者停止并重新启动应用共享，则不再存在延迟。此问题在 Teams 26149.x.x.x 或更高版本中得到修复。
Mac 设备上早于 6.6.10 的 Zoom VDI 插件会导致 Citrix Workspace 应用程序在呼叫转移时崩溃。
如果在通话期间连接/拆卸外部显示器，视频可能会显示在错误的屏幕上。当您在 HDX 会话期间更改显示对齐方式时，也会发生这种情况。

验证终结点是否已优化

满足所有最低要求后，默认情况下，首次启动 Teams 将尝试以 SlimCore 优化模式加载。

可以通过查看 UI) 左上角的 VDI 状态指示器 (，检查在 Teams 客户端中已使用新体系结构进行优化。此外，用户可以在顶部栏上选择三个点 (省略号...) ，然后选择“ 设置>关于”。 Teams 和客户端版本列在此处。

AVD SlimCore 媒体优化 = 基于 SlimCore 的新优化。
AVD 媒体优化 = 基于 WebRTC 的优化。

插件 (MsTeamsPluginAvd.dll、MsTeamsPluginCitrix.dll 或 MsTeamsPluginAmazon.dll) 负责最终下载媒体引擎和 SlimCore（一个 MSIX 包）。它以无管理员权限静默安装，或在 (示例中重启，确切路径) ：

C:\Program Files\WindowsApps\Microsoft.Teams.SlimCoreVdi.win-x64.2024.15_2024.15.1.5_x64__8wekyb3d8bbwe

对于新的拆分 MSIX 包： C:\Program Files\WindowsApps\Microsoft.Teams.SlimCoreVdiFwk.win-x64.2025.28_2025.28.1.4_x64__8wekyb3d8bbweC:\Program Files\WindowsApps\Microsoft.Teams.SlimCoreVdiHost.win-x64_2025.28.1.4_x64__8wekyb3d8bbwe

远程桌面客户端或 Citrix Workspace 应用程序会根据用户的设备下载 x64 或 x86 SlimCore 程序包。 “WindowsApps”文件夹已锁定，因此用户无权访问它。管理员修改 ACL 以取得所有权，但不建议执行此操作。相反，请使用 PowerShell 列出终结点中的 MSIX 应用：

PowerShellCopy

Get-AppxPackage Microsoft.Teams.SlimCore*

运行此 PowerShell 可返回的结果示例为：

Name              : Microsoft.Teams.SlimCoreVdiHost.win-x64
Publisher         : CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US
Architecture      : X64
ResourceId        :
Version           : 2026.20.1.7
PackageFullName   : Microsoft.Teams.SlimCoreVdiHost.win-x64_2026.20.1.7_x64__8wekyb3d8bbwe
InstallLocation   : C:\Program Files\WindowsApps\Microsoft.Teams.SlimCoreVdiHost.win-x64_2026.20.1.7_x64__8wekyb3d8bbwe
IsFramework       : False
PackageFamilyName : Microsoft.Teams.SlimCoreVdiHost.win-x64_8wekyb3d8bbwe
PublisherId       : 8wekyb3d8bbwe
IsResourcePackage : False
IsBundle          : False
IsDevelopmentMode : False
NonRemovable      : False
IsPartiallyStaged : False
SignatureKind     : Developer
Status            : Ok

Name              : Microsoft.Teams.SlimCoreVdiFwk.win-x64.2026.20
Publisher         : CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US
Architecture      : X64
ResourceId        :
Version           : 2026.20.1.7
PackageFullName   : Microsoft.Teams.SlimCoreVdiFwk.win-x64.2026.20_2026.20.1.7_x64__8wekyb3d8bbwe
InstallLocation   : C:\Program
                    Files\WindowsApps\Microsoft.Teams.SlimCoreVdiFwk.win-x64.2026.20_2026.20.1.7_x64__8wekyb3d8bbwe
IsFramework       : True
PackageFamilyName : Microsoft.Teams.SlimCoreVdiFwk.win-x64.2026.20_8wekyb3d8bbwe
PublisherId       : 8wekyb3d8bbwe
IsResourcePackage : False
IsBundle          : False
IsDevelopmentMode : False
NonRemovable      : False
IsPartiallyStaged : False
SignatureKind     : Developer
Status            : Ok

重要

出于兼容性目的，Microsoft 最多可存储 12 个版本的 SlimCoreVdi 框架。我们存储这些版本以防用户访问不同的 VDI 环境，例如永久性（其中 Teams 会自动更新）和非永久（其中 Teams 自动更新已禁用）。

如果已优化，则可以看到 Azure 虚拟桌面/W365 (的终结点上运行 MsTeamsVdi.exe 作为 msrdc.exe) 的子进程，或将 Citrix (作为 wfica32.exe) 的子进程运行。使用进程资源管理器时，如果选择“msrdc.exe (”或“wfica32.exe) ”，选择“显示视图”下的下窗格并切换到“DLL”选项卡，还可以看到正在加载的插件 (MsTeamsPluginAvd.dll 或 MsTeamsPluginCitrix.dll) 。如果您没有获得新的优化，此操作是一个有用的故障排除步骤。

VDI 状态指示器

Microsoft Teams 显示有关优化状态的信息，帮助用户了解其是否已优化。它还通过将光标悬停在 “优化” 横幅上来显示他们使用的是 WebRTC 优化还是基于 Slimcore 的新优化。

如果 Microsoft Teams 未优化，用户会看到一个警告图标。

显示未优化的 Teams 应用的屏幕截图。

用户可以选择三个点并选择优化 虚拟桌面并重启 以尝试修复。

此选择将触发 Teams 重启，这可以解决一些已知问题。如果用户仍未优化，则会显示一个错误代码，以便 IT 管理员根据连接错误表进行快速诊断。

系统会向用户显示一个链接，以接收有关错误的更多信息，如果可操作，则可以尝试自我修复。

会话漫游和重新连接

注意

如果虚拟桌面会话断开连接 (未注销，Teams 仍会在虚拟机) 上运行，现在 Citrix 上的 Teams 也可以切换优化堆栈，而无需在重新连接后重启。换句话说，Teams 会尝试尽可能使用 SlimCore 来优化用户，如果端点不支持，则尝试 WebRTC 优化。

例如，在家办公时 (自带设备 BYOD) 方案中使用的 Windows 终结点安装了该插件，而办公室中公司管理的 Linux 瘦客户端则仅支持 WebRTC。当用户在两个终结点之间漫游时，Teams 将自动选择正确的优化堆栈，而无需要求用户重新启动应用程序。此外，用户还会收到有关优化切换的通知，其中包含可关闭的横幅 (“优化虚拟桌面...”) 。

这种无缝堆栈转换取代了要求用户在 VDI 环境中手动重启应用的模式对话框。

网络注意事项

提示

MsTeamsVdi.exe 是使所有 TCP/UDP 网络连接到 Teams 中继/会议服务器或其他对等方 (信令和媒体) 的过程。

SlimCore MSIX 清单将以下规则添加到防火墙： <Rule Direction="in" IPProtocol="TCP" Profile="all" /><Rule Direction="in" IPProtocol="UDP" Profile="all" />

重要

在将新优化与条件访问策略一起使用的 VDI 环境中，具有持续访问评估 (CAE) 和严格的位置强制，用户可能会遇到重复的 Teams 登录提示或失败调用，因为身份验证请求是根据 IP) 客户端的终结点 (评估的，从而导致从不受信任的网络连接时访问被阻止。此行为是设计使然，与基于 WebRTC 的优化相比，反映了更严格的强制执行。为了减轻影响，客户可以放宽 CAE 策略 (例如，避免严格的位置强制) ，或将相关端点或 ISP IP 范围添加到受信任的位置。

注意

确保用户的设备具有 (UDP 和 TCP) 到 Microsoft 365 URL 和 IP 地址范围中所述的终结点 ID 11、12、47 和 127 的网络连接。
ID 184 也是必需的。下表是摘要，仅供参考，通过 RSS 订阅监视这两个链接 () 获取最新列表。

ID	类别	ER	地址	端口	注释
11	优化必需	是	52.112.0.0/14, 52.122.0.0/15, 2603:1063::/38	UDP：3478、3479、3480、3481	媒体处理器和传输继电器 3478 (STUN) 、3479 (音频) 、3480 (视频) 、3481 (屏幕共享)
12	允许必填项	是	`.lync.com`，， `.teams.microsoft.com`， `teams.microsoft.com*.teams.cloud.microsoftteams.cloud.microsoft`，， 52.112.0.0/14， 52.122.0.0/15， 2603：1027：：/48， 2603：1037：：/48， 2603：1047：：/48， 2603：1057：：/48， 2603：1063：：/38， 2620：1ec：6：：/48， 2620：1ec：40：：/42	TCP：443,80，UDP：443
47	默认为必填项	否	`*.office.net` , `graph.microsoft.com`	TCP：443,80	用于 SlimCore 下载和背景效果
69	默认为必填项	否	`.aria.microsoft.com`, `.events.data.microsoft.com`	TCP：443	后端通信服务
127	默认为必填项	否	`*.skype.com`	TCP：443,80
184	默认为必填项	否	`.cloud.microsoft`, `.static.microsoft`, `*.usercontent.microsoft`	TCP：443，UDP 443	用于铃声、噪音抑制和其他型号

网络体系结构

Teams VDI 2 的网络体系结构。

图中体系结构的演练：

启动 Teams。
Teams 客户端对 Teams 服务进行身份验证。租户策略被推送到 Teams 客户端，相关配置被中继到应用。
Teams 检测到它正在虚拟桌面环境中运行，并实例化内部 vdibridge 服务。
Teams 在服务器上打开一个安全的虚拟频道。
RDP/HDX/Blast/DVC 协议将请求传输到 VDI 客户端 (Windows 应用、Citrix Workspace 应用程序、Horizon Client 或之前加载了 MsTeamsPlugin (客户端虚拟频道组件) 的 Amazon WorkSpaces) 。
VDI 客户端应用生成一个名为 MsTeamsVdi.exe 的新进程，这是用于新优化 (SlimCore) 的新媒体引擎。所有网络活动均由此进程执行。
客户端) 上的 SlimCore 媒体引擎 (和虚拟桌面上的 msteams.exe (现在) 具有双向通道，可以开始处理多媒体请求。

用户调用

对等 A 选择呼叫按钮。 MsTeamsVdi.exe 与 Azure 中的 Microsoft Teams 服务通信，与对等 B 建立端到端信号路径。MsTeamsVdi.exe 收集一系列受支持的调用参数 (编解码器、分辨率等，这称为会话描述协议 (SDP) 提供) 。然后，使用信令路径将这些呼叫参数中继到 Azure 中的 Microsoft Teams 服务，并从那里中继到另一个对等方。
SDP 的报价/应答 (单次协商) 通过信令通道进行，并且使用 STUN 绑定请求 (ICE 连接检查 NAT 和防火墙遍历) 完成。然后，安全实时传输协议 (SRTP) 媒体直接在 MsTeamsVdi.exe 与其他对等 (或 Teams 传输中继或会议服务器之间流动) 。

本文介绍了用于信令、媒体、背景效果和其他选项的 IP 块。

SlimCore 在终结点上处理的流量类型

Teams 媒体流连接是使用标准 IETF 交互式连接建立 (ICE) 实现的，用于 STUN 和 TURN 过程。
实时媒体。数据封装在支持音频、视频和屏幕共享工作负载的实时传输协议 (RTP) 中。通常，媒体流量对延迟高度敏感。此流量必须尽可能采用最直接的路径，并使用 UDP 而不是 TCP 作为传输层协议，从质量角度来看，这是交互式实时媒体的最佳传输方式。
- 最后的办法是，媒体可以使用 TCP/IP，也可以在 HTTP 协议内进行隧道传输，但由于质量不佳，我们不建议这样做。
- RTP 流使用 SRTP 进行保护，其中仅对有效负载进行加密。
信号。终结点与 Teams 服务器或其他客户端之间的通信链接，用于控制活动 (例如，何时) 发起呼叫。大多数信令流量使用 UDP 3478 回退到 HTTPS，尽管在某些情况下 (例如，Microsoft 365 与会话边界控制器之间的连接) 使用 SIP 协议。重要的是要了解此流量对延迟的敏感性要低得多，但如果终结点之间的延迟超过几秒钟，则可能会导致服务中断或调用超时。

带宽消耗

Teams 旨在不受网络条件限制，提供最佳音频、视频和内容共享体验。当带宽不足时，Teams 将优先确保音频质量，其次才是视频质量。在带宽不受限制的情况下，Teams 会优化媒体质量，包括高保真音频、高达 1080p 的视频分辨率，以及视频和内容的每秒高达 30 fps (每秒帧数) 。若要了解详细信息，请阅读带宽要求。

服务质量 (QoS)

实施终结点和网络设备的 QoS 设置，并确定你希望如何处理通话和会议的媒体流量。

先决条件是在 Teams 管理员中心全局启用 QoS。有关为实时媒体流量设置启用插入服务质量 (QoS) 标记的详细信息，请参阅在 Teams 管理中心配置 QoS。

建议的初始端口范围：

媒体流量类型	客户端源端口范围	协议	DSCP 值	DSCP 类
音频	50,000 - 50,019	TCP/UDP	46	加速转发 (EF)
视频	50,020 - 50,039	TCP/UDP	34	保证转发 (AF41)
应用或屏幕共享	50,040 - 50,059	TCP/UDP	18	保证转发 (AF41)

有关为 Windows 终结点配置差异化服务代码点 (DSCP) 标记的信息，请参阅在 Teams 客户端中实施 QoS。

注意

任何基于终结点的标记都必须应用于 MsTeamsVdi.exe，这是处理用户设备上所有多媒体卸载的进程。有关 QoS 的详细信息，请参阅 Playbook 文档。
有关实现路由器 QoS 的信息，请参阅制造商的文档。
在网络设备上设置 QoS 可能包括部分或全部：
- 使用基于端口的访问控制列表 (ACL)
- 定义 QoS 队列
- 定义 DSCP 标记

重要

我们建议使用终结点源端口以及源和目标 IP 地址“any”来实现这些 QoS 策略。这些策略捕获内部网络上的传入和传出媒体流量。

不建议在 VDI 中使用 Microsoft Teams 的技术

VPN 网络。不建议用于媒体流量。
数据包整形器。不建议将任何类型的数据包嗅探器、数据包检查、代理或数据包整形器设备用于 Teams 媒体流量，否则可能会显著降低质量。

Microsoft Teams PowerShell 优化策略

CsTeamsVdiPolicy cmdlet 使管理员能够控制用户可以创建的会议类型或他们可以在会议中访问的功能，特别是在 VDI 环境中，其中使用 VDI 合作伙伴的策略引擎 (Citrix Studio、VMware HTML5 ADMX 模板或 AVD 和 Windows 365) 的注册表项禁用了 WebRTC 优化。

默认策略配置为：

DisableCallsAndMeetings: False
DisableAudioVideoInCallsAndMeetings: False

此策略现在有一个附加参数作为唯一配置点，用于控制用户是否可以获取基于 SlimCore 的新优化模式。换句话说，VDI 合作伙伴的策略引擎不控制新的优化模式：

VDI2Optimization：已启用 (默认值)

名称	定义	示例	注释
New-CsTeamsVdiPolicy	允许管理员定义新的 VDI 策略，这些策略可以分配给用户，用于控制与 VDI 环境中的会议相关的 Teams 功能。	`PS C:\> New-CsTeamsVdiPolicy -Identity RestrictedUserPolicy -VDI2Optimization "Disabled"`	此处显示的命令使用 New-CsTeamsVdiPolicy cmdlet 创建标识为 RestrictedUserPolicy 的新 VDI 策略。此策略使用 VDI 策略的所有默认值，但一个默认值除外：VDI2Optimization。在此示例中，无法使用 SlimCore 优化具有此策略的用户。
Grant-CsTeamsVdiPolicy	允许管理员在每个用户范围内分配 Teams VDI 策略。管理员可以控制用户可以创建的会议类型、他们可以在未优化的 VDI 环境中访问的功能，以及是否可以使用基于 SlimCore 的新优化模式来优化用户。	`PS C:\> Grant-CsTeamsVdiPolicy -identity "Ken Myer" -PolicyName RestrictedUserPolicy`	在此示例中，将标识为“Ken Myer”的用户分配给 RestrictedUserPolicy。
Set-CsTeamsVdiPolicy	允许管理员更新现有 VDI 策略。	`PS C:\> Set-CsTeamsVdiPolicy -Identity RestrictedUserPolicy -VDI2Optimization "Disabled"`	此处显示的命令使用 Set-CsTeamsVdiPolicy cmdlet 使用标识 RestrictedUserPolicy 更新现有 VDI 策略。此策略使用所有现有值，但一个值除外：VDI2Optimization;在此示例中，无法使用 SlimCore 优化具有此策略的用户。
Remove-CsTeamsVdiPolicy	允许管理员删除以前创建的 Teams VDI 策略。没有显式分配策略的用户回退到组织中的默认策略。	`PS C:\> Remove-CsTeamsMeetingPolicy -Identity RestrictedUserPolicy`	在前面显示的示例中，该命令从组织的策略列表中删除受限用户策略，并从分配了该策略的用户中删除此策略的所有分配。
Get-CsTeamsVdiPolicy	允许管理员检索有关组织中配置的所有 VDI 策略的信息。	`PS C:\> Get-CsTeamsVdiPolicy -Identity SalesPolicy`	在本示例中，Get-CsTeamsVdiPolicy 用于返回具有标识 SalesPolicy 的每用户会议策略。由于标识是唯一的，因此此命令不会返回多个项目。

采用新优化的功能列表

下表将新的优化功能集与基于 WebRTC 的优化进行了比较。新的优化支持 AVD/W365、Citrix、Omnissa 和 Amazon 的 Windows 终结点。 Mac 仅在 AVD/W365 和 Citrix 上受支持。 AVD/W365、Citrix 和 Omnissa 支持 WebRTC。

功能	适用于新的优化 (Windows 和 MAC)	在 WebRTC (Windows 和 MAC) 上可用
1080p	是	否
终结点上的硬件加速	是 ¹	否
库视图 3x3 和 7x7	是	否
服务质量	是	否
噪声抑制	是	是 (AVD)
语音隔离和人脸注册	是 ⁶	否
HID	是， (仅适用于 Windows)	是， (AVD 和 Omnissa)
演示者模式	是	否
Teams 高级版	查看 Teams 高级版页面	查看 Teams 高级版页面
组织自定义背景	是， (Teams 高级版需要许可证)	否
用户上传的背景效果	是 ²	否
缩放 +/-	是	否
媒体旁路、基于位置的路由、运营商连接 ³	是	否
通话质量仪表板和 Teams 管理中心	是	受限
已发布的应用/远程应用/云应用	是， (AVD/W365 和 Citrix)	是， (适用于 AVD，仅适用于 Windows)
授予/接管控制权	是	是
应用共享	是	是
E911	是	是
联播	是	是
共享系统音频	是， (仅适用于 Windows)	是
辅助铃声	是	是
背景模糊	是	是
组织者可以安排会议和事件	是	是
组织者、演示者和与会者可加入最多 1,000 名与会者的会议和事件，例如网络研讨会	是	是
组织者和演示者可以参加大型活动，例如全体大会	是	否
与会者可以参加大型活动，例如全体大会	是	是
对最多 1,000 名与会者的会议和事件（例如网络研讨会）的组织者和演示者进行了优化	是 ⁴	是
大型活动（如全体大会）的组织者和演示者已得到优化	是	否
最多 1,000 名与会者的会议和活动（例如网络研讨会）中的与会者将得到优化	是	否
大型活动（如全体大会）的与会者已得到优化	否	否
批注	仅作为演示者。 ⁵	否

¹ 图形硬件加速需要 DirectX 9 或更高版本，对于 Windows 10 (，需要 WDDM 2.0 或更高版本，对于 Windows 10 Fall Creators Update) ，需要 WDDM 1.3 或更高版本。
² 如果以来宾身份加入会议，则不支持此功能。不支持通过脚本在用户的 Appdata 配置文件中放置背景文件， (用户必须通过 Teams 上传所需的自定义文件，然后将其复制到用户的 OneDrive - 前提是该文件) 有足够的存储容量。
³ 运营商使用手机号码在印度进行连接需要从终结点的操作系统和本地 Internet 分支进行经纬度访问。运营商：与有线或无线号码连接，可以使用 IP/子网或 Internet 分支映射到某个位置。确保终结点 OS 检测到正确的国家/地区至关重要，因为通过印度境外的分组路由流量可能会导致终结点 OS 错误识别位置。有关更多详细信息，请检查印度的有线和无线号码类型。
⁴ NDI (网络设备接口) ，制作者不支持用于连接媒体设备 (如工作室摄像机和混音器) 的现代解决方案。
⁵ 观看者看不到批注， (它们被传入的视频窗口覆盖)
隐藏。⁶ 语音和人脸注册依赖于 VDI 提供商摄像头/麦克风重定向 (，例如 Citrix HDX、Omnissa RTAV、Microsoft RDP 等 ) 。请参阅 “已知问题” 部分。

终结点上的 SlimCore 用户配置文件

新的 VDI 解决方案将用户特定数据存储在终结点上的以下位置，具体取决于供应商：

C:\users\<user>\AppData\Local\Packages\Microsoft.Teams.SlimCoreVdiHost.win-x64_8wekyb3d8bbwe\LocalCache\Local\Microsoft\TeamsVDI\<vdi provider>-tfw-<cloudname>\

较旧的 SlimCore MSIX 包 (于新的拆分 MSIX 包之前，具有主机和框架) 存储用户特定数据：

C:\users\<user>\AppData\Local\Microsoft\TeamsVDI\<vdi provider>-default-<cloudname>\

日志、铃声、配置以及 (用于噪声抑制、带宽估计等的 AI 或 ML 模型 ) 保存在此位置。此外，上传到 Teams 的自定义背景效果随后会从用户的 OneDrive 下载到该位置的“downloads”文件夹 (因此，该功能需要具有足够存储空间的 OneDrive 帐户才能) 工作。例如，如果在用户注销后清除这些 AppData 文件夹 (例如，锁定的瘦客户端，而没有) 漫游配置文件，MsTeamsVdi.exe 会重新创建它们并下载用户特定的配置， (大约 12 MB 的数据) 。用户特定数据可以增长到 ~100 MB (包括 ~60 MB 的日志) 。

重要

锁定的瘦客户端必须允许读/写这些位置。否则，新的优化可能会失败。对于较旧的 Windows 10 1809 瘦客户端 (（例如 Dell Wyse 5070 和类似型号) ），SlimCoreVDI 的进程将 AppData 写入虚拟化文件存储，因此 SlimCore 用户配置文件的文件夹位置 (具体取决于 SlimCore MSIX 包) ： C:\Users\<user>\AppData\Local\Packages\Microsoft.Teams.SlimCoreVdi.win-<architecture>.<version>_8wekyb3d8bbwe\LocalCache\. C:\Users\<user>\AppData\Local\Packages\Microsoft.Teams.SlimCoreVdiHost.win-x64_8wekyb3d8bbwe\LocalCache\.

锁定瘦客户端环境中的 SlimCore 安装和升级过程 (可选)

默认情况下，MsTeamsPlugin 会自动下载并安装正确的 SlimCore 媒体引擎版本，无需用户或管理员干预。但是，分支机构中处于受限网络环境中的客户可以选择替代的 SlimCore 分发过程，而无需终结点能够使用 https 从 Microsoft 的公共内容交付网络获取 SlimCore 包。

注意

有关与其相应 Teams 版本匹配的 SlimCore 包的更新列表，请检查此表。

重要

如果必须选择此方法，则必须保证：

虚拟桌面中禁用了 Teams 自动更新。
在虚拟桌面中升级 Teams 之前，会将 SlimCore 包预预预到终结点的本地存储或网络共享。任何较新的 Teams 版本都会请求匹配的新版本的 SlimCore，如果插件找不到它，则表示用户处于服务器端呈现) (回退模式。

发生这种情况是因为 Teams 和 SlimCore 版本必须匹配。

配置步骤

在用户的终结点 (瘦客户端/胖客户端) 上，必须创建以下注册表项：
- Citrix 的位置：HKLM\SOFTWARE\WOW6432Node\Microsoft\Teams\MsTeamsPlugin
- Azure 虚拟桌面/W365 的位置：HKLM\SOFTWARE\Microsoft\Teams\MsTeamsPlugin
- 名称：MsixUrlBase
- 类型：REG_SZ
- 数据：本地存储或网络存储 UNC 路径，例如 file://C:/Temp 或 file://ComputerName/SharedFolder。
注册表项定义基 URL。
此外，管理员必须从 Microsoft 的内容交付网络下载与计划将来部署的 Teams 版本匹配的确切 SlimCore MSIX 包版本。

重要

MSIX 程序包需要与 x86 (的 Citrix Workspace 应用程序的体系结构或位数相匹配，) 远程桌面或 Windows 应用客户端： Microsoft.Teams.SlimCoreVdi.<platform>-<architecture>.msix.
若要保留结构，请将 MSIX 放入具有注册表项中指定位置内版本的特定文件夹中。例如 C：\Temp\2024.4.1.9\Microsoft.Teams.SlimCoreVdi.win-x86.msix 或 //ComputerName/SharedFolder/2024.4.1.9/。

注意

如果插件在本地或网络存储中找不到 SlimCore MSIX 包，它会自动尝试从 Microsoft 公共内容交付网络下载该包作为回退。

统一写入筛选器 (UWF)

使用应用了统一写入筛选器的精简客户端的客户应创建以下排除项，以便允许预配和激活 SlimCore MSIX 包：

uwfmgr.exe 文件 Add-Exclusion “C：\Program Files\WindowsApps”
uwfmgr.exe 文件 Add-Exclusion “C：\Users\User\AppData\Local\Packages\Microsoft.Teams.SlimCoreVdiHost.win-x64_8wekyb3d8bbwe”

具有 RAM 磁盘的精简客户端

像 HP/DELL 这样具有 RAM 磁盘管理器的瘦客户端，其中环境变量 TEMP/TMP 指向 RAM 磁盘 (例如，在查看 VM 的事件查看器说明条目中查找“Microsoft Teams VDI”) 时，Z：) 将无法预配 SlimCore MSIX 包 (“sc_host_install_error”：“{”val“：4390，”cat“：”windows“}”。解决方法是MSTEAMSVDI_BITS_TMP_PATH创建一个新的系统变量，并将其指向一个临时物理磁盘位置， (例如 C：\TMP 或 C：\TEMP) 。这允许后台智能传输服务成功下载和预配 SlimCore。

跨云协作

Microsoft 的公共云、GCC (政府社区云) 、GCCH (政府社区云高) 以及国防部 (国防部) 云中的组织现在可以通过新的优化有效地相互协作， (这种协作适用于公司内部和公司间) 。这种协作通常涉及对共享内容的访问，这需要经过身份验证的访问。以前，由于音频/视频缺乏优化，通过 Teams 进行的跨云协作受到限制。通过基于 Teams 和 Slimcore 的优化，用户现在可以享受高清的用户体验。有关跨云的更多信息，请检查此链接。

支持以下方案：

跨云匿名 允许以下场景：用户登录到 Teams 中的云 A，并匿名加入其他云 B 中的会议。有关更多详细信息，请查看 “ (IT 管理员管理匿名参与者对 Teams 会议和事件的访问权限) ”。
跨云来宾访问 扩展了功能，允许用户参与团队、频道、文档和 Teams 会议中的丰富协作体验，以获得包括音频/视频优化、屏幕共享、文件共享以及 1：1 和 1：n 聊天在内的完整体验。请点击此处查看详细信息。
通过跨云身份验证的会议加入， Teams 用户能够登录到其家庭租户中的帐户时加入另一个云中的会议。此功能使会议主持人能够验证会议参与者的身份，而无需向这些参与者授予对主机租户的任何访问权限。

最低版本：Teams 25060.205.3499.6849。远程桌面客户端 1.2.6186。 Citrix 插件 2024.41.1.1.

已知问题：

HID 仅适用于主云。
Teams UI 静音不会在非主云中播放“静音/取消静音”语音命令。
此处介绍了更多外围设备限制
登录到多云 (多云或跨云) 的任何用户都无法使用 WebRTC 进行优化。如果用户漫游到不支持 SlimCore 的设备，则他们将处于服务器端渲染) (回退模式，直到他们漫游回支持 SlimCore 的设备。出现此问题的原因是 WebRTC 不支持任何跨云功能。
如果即使用户满足最低要求，跨云功能似乎也无法正常工作，则可以在使用 SlimCore) 对其进行优化后退出 Teams (，并尝试删除以下路径中名为 ecs_settings.dat64 的文件：%localappdata%\packages\MSTeams_8wekyb3d8bbwe\LocalCache\microsoft\MSTeams。重启 Teams。

Citrix 虚拟频道允许列表

CVAD 中的虚拟频道允许列表策略设置允许使用允许列表，该列表指定可以在 ICA 会话中打开哪些虚拟频道。启用后，必须说明除 Citrix 内置虚拟通道之外的所有进程。因此，Teams 客户端需要更多条目才能连接到客户端插件 (MsTeamsPluginCitrix.dll) 。

在 Citrix Virtual Apps and Desktops 2203 或更高版本中， 默认情况下会启用虚拟频道允许列表。这些默认设置会拒绝访问 Teams 自定义虚拟频道，因为允许列表不包括 Teams 主进程名称。

Teams 客户端需要三个自定义虚拟频道才能正常工作：MSTEAMS、MSTEAM1 和 MSTEAM2。 Ms-teams.exe 访问这些频道。可以使用通配符来允许 ms-teams.exe 可执行文件和自定义虚拟通道：

MSTEAMS， C：\Program Files\WindowsApps\MSTeams*8wekyb3d8bbwe\ms-teams.exe
MSTEAM1， C：\Program Files\WindowsApps\MSTeams*8wekyb3d8bbwe\ms-teams.exe
MSTEAM2， C：\Program Files\WindowsApps\MSTeams*8wekyb3d8bbwe\ms-teams.exe

通配符支持在以下版本中可用：
- VDA 2206 CR.
- VDA 2203 LTSR 从 CU2 开始。
必须重新启动 VDA 计算机才能使策略生效。

注意

VDA 2603 或更高版本现在默认允许三个虚拟通道，而无需 Citrix Studio 策略的特定配置 ('Allowed') 。

与未优化的 Teams 桌面客户端相比，传出屏幕共享和应用共享在优化的 VDI 中的行为有所不同。因此，这些活动需要采用用户设备资源的编码， (例如 CPU、GPU、RAM、网络等) 。从网络角度来看，共享直接在用户的设备和其他对等方或会议服务器之间完成。

注意

虚拟机端屏幕共享 (VMSS)

对于 Omnissa、Amazon 或 MAC (Citrix 或 AVD/W365) ，共享直接在用户的虚拟机（演示者）和其他对等方（查看者）或会议服务器之间完成，因此管理员必须在 VM 的网络上允许 ID 11 和 12，如 Microsoft 365 URL 和 IP 地址范围中所述。这是因为当 VDI 用户选择屏幕共享按钮时，p2p 音频/视频通话将升级为群组通话，从而允许 Teams 直接从虚拟机共享内容。 Teams 优化的观众仍会直接在其终结点上接收传入的屏幕共享流，卸载发生
。此功能当前为 Windows 用户以及 Citrix (AVD/W365) 提供公共预览版。查看上面的“网络架构”图以了解更多详细信息。管理员可以在 Teams 管理员中心检测这些传出屏幕共享会话， (它们显示为用户) 的附加“屏幕共享流”会话或 CQD (在“用户代理类别”) 上显示为“Microsoft Teams VDI (VM 屏幕共享) ”

提示

可以在 VM 上创建以下注册表项来控制 vmss CPU 资源消耗：

路径： HKCU\Software\Microsoft\Teams\VMSS 或 HKLM\Software\Microsoft\Teams\VMSS (HKLM 优先于 HKCU)
名称： MaxFPS (DWORD)
值：介于 1 和 15 之间的任意值

典型的 PowerPoint 会话消耗 3fps。如果用户单击共享工具栏中的“优化”按钮， (用于) 共享视频，则 Teams 会尝试将帧率提高到 15 fps，并且预计会对 CPU 产生更大的影响。将 MaxFPS 的上限限制在 5-10 之间有助于减少此场景的影响。

大小调整指南

以下建议源自 Microsoft 的内部负载测试。由于测试结果可能因部署而异，因此客户应在其特定环境中进行自己的验证。结果受多种因素的影响，包括 VM 大小、工作负载模式，最重要的是是否存在 GPU 加速。

在单用户 4vCPU/16GB RAM VM 上，配备 Intel Xeon CPU E5-2673 v4 @ 2.30GHz (，且没有 GPU 或快速同步，因此使用 H264 软件编码) ，

使用 4K 外部监视器时，当用户在 UI 工具栏) 单击“优化视频”时，VM 上 Microsoft Teams 的内存使用量会消耗，并且会消耗额外的 ~510 MB，以及额外的 ~7-8% CPU (（3 fps) 或 25-30% CPU (（15 fps）。
使用 2K 外部监视器时，当用户在 UI 工具栏) 单击“优化视频”时，VM 上 Microsoft Teams 的内存使用量会消耗额外的 ~320 MB，并额外增加 ~320 MB 和 3-4% 的 CPU (（3 fps) ）或 20-25% CPU (（15 fps）。

全屏共享捕获 Teams 呼叫监视器，并使其对其他参与者可见。里面的视频元素不可见，而是显示为空白方块。执行应用共享时，只有正在共享的应用程序对其他参与者可见，并且不会捕获呼叫监视器。

Citrix 应用保护和 Microsoft Teams 兼容性

启用了应用保护的用户仍然可以在使用新的优化时共享他们的屏幕和应用。共享需要 VDA 版本 2402 或更高版本，以及适用于 Windows 2309.1 或更高版本的 CWA。安装并启用应用保护模块后，较低版本的用户最终会共享黑屏。

AVD 屏幕记录保护和 Microsoft Teams 兼容性

启用了屏幕记录保护 (SCP) 以阻止远程桌面客户端上的屏幕捕获 (“在客户端) 上阻止屏幕捕获”的用户仍可共享其屏幕和应用，同时使用 Microsoft Teams 的新基于 SlimCore 的优化。共享需要以下最低版本：Teams 25060.205.3499.6849，远程桌面客户端 1.2.6081 或 Windows 应用 2.0.379。

较低版本的用户最终会共享一个启用了 SCP 的黑屏。

AVD RemoteApp / W365 云应用和 Citrix 虚拟应用

如果在 Azure 虚拟桌面中发布带有 RemoteApp、Windows 365 中的云应用或 Citrix Virtual Apps (已发布应用) 的 Microsoft Teams 应用程序，只要用户满足以下最低要求，就可以使用新体系结构进行优化：

适用于 Windows 2.0.964.0 的 Windows 应用
Citrix 插件 2026.15.1.1
Microsoft Teams 26043.2016.4478.2773

已知问题：

授予/获取控制权当前不可用。
Mac 终结点不受支持，因此不会进行优化，并且用户处于回退模式 (也称为服务器端呈现) 。如果用户看到行为不一致且未处于回退模式，请升级到 Microsoft Teams 26093.411.4595.9804 或更高版本。

自定义背景效果

新的优化允许用户在 Teams 会议期间通过模糊或更改背景、上传自己的图像或从 Teams 中已有的背景图像中进行选择来保持其背景的私密性。上传自定义图像需要用户通过 Teams UI 上传文件，因此文件必须通过客户端驱动器映射) 直接或间接在虚拟桌面 (中可用。然后，Teams 会将文件上传到用户的 OneDrive 文件夹，并指示用户设备上运行的媒体引擎下载该文件以供本地处理。用户的设备网络必须允许访问 graph.microsoft.com。不支持通过脚本将背景文件放置在用户本地的 Appdata 配置文件中 (用户必须通过 Teams 上传所需的自定义文件，然后将其复制到用户的 OneDrive - 前提是它具有足够的存储容量) 。如果以来宾身份加入会议，则不支持自定义背景功能。

大型事件 (，例如全体大会) 和直播活动

加入这些类型活动的与会者未 (WebRTC 或 SlimCore) 进行优化，因此它们默认为服务器端呈现，从而在虚拟桌面上导致大量资源消耗， (主要是 CPU、RAM 和虚拟通道带宽) 。因此，Microsoft eCDN 和对等 (P2P) 流量在虚拟机本身执行，因为无法进行卸载。有关更多详细信息，请参阅此文章。

有关演示者/组织者角色支持，请参阅本文前面包含新优化表的功能列表。

VDI 中的外围设备

使用 SlimCore 优化 Teams 后，连接到物理设备的摄像头、麦克风、位置和扬声器将映射到虚拟桌面上。 Teams 将枚举所有检测到的设备，并优先考虑在用户的设备) 上运行时 mmsys.cpl 面板中显示的默认通信设备 (。基于 SlimCore 的优化支持人机界面设备 (HID) for Teams 认证耳机，允许用户直接从耳机自行静音/取消静音和增加/减少音量。目前，不支持认证 Teams 设备上的 Microsoft Teams 按钮。

提示

使用策略 CSP - 隐私，可以通过声明 SlimCore 的包系列名称 (Microsoft.Teams.SlimCoreVdiHost.win-x64_8wekyb3d8bbwe) 来预先指定相机、麦克风和位置的每应用设置。这些设置为 LetAppsAccessCamera_ForceAllowTheseApps、 LetAppsAccessMicrophone_ForceAllowTheseApps LetAppsAccessLocation_ForceAllowTheseApps

注意

对于某些外围设备，两个并行运行的统一通信应用可能会导致 HID 冲突，其中活动呼叫断开连接。

请参阅 “已知问题” 部分。

作为解决方法，可以通过 Teams 25060.205.3499.6849 或更高版本上的注册表项禁用 HID，密钥可以在终结点上创建。 (如果有 Citrix) (2025.24.1.3 插件，或远程桌面客户端 1.2.6275 / Windows 应用 2.0.550.0) ，则也可以在 VM 上创建密钥。

HKEY_CURRENT_USER\Software\Microsoft\Teams\HID

名称： DisableHidManagerV1

类型：DWORD

值：1 (当设置为 1 时，它将禁用 HID) (如果设置为 0 或密钥不存在，则启用 HID)

监视 API

管理员可以创建自定义脚本来查询 vdi_connection_info.json - 虚拟机中的此文件包含有关当前和上次会话的信息，例如优化状态、外设以及不同组件的软件版本。

VDA 或远程桌面主机) 中的位置 (：C：\Users<username>\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\tfw

监视 API 的典型用例包括：

管理员在 VDA 或远程桌面主机中部署自动化脚本，以检测客户端端点操作系统自上次连接以来是否更改。该脚本使用 JSON 文件的内容来比较最近两个会话的值，并发出它们自己的警报/弹出消息。
开发人员创建报告 VDI 优化连接当前状态的第三方应用。该脚本使用 JSON 文件的内容来检索当前 Teams 会话的所有可用连接、优化和设备信息。

json 文件结构：

时间戳 - vdiConnectedState.timestamp 指示会话连接的时间戳
VDI 优化 - vdiConnectedState.vdiMode 指示优化版本 (在整个 VDI 会话) 中保持静态
连接状态 - connectedStack (远程 = 优化，本地 = 未优化) (在整个 VDI 会话) 中保持静态
终结点上的 SlimCore 版本 - remoteSlimCoreVersion
VM 上的 VdiBridge 版本 - bridgeVersion
终结点上的 MS Teams 插件版本 - pluginVersion
Teams 版本 - vdiVersionInfo.teamsVersion
客户端平台 - vdiVersionInfo.clientPlatform
VDI 客户端 (CWA 或 Windows 应用) 版本 - vdiVersionInfo.rdClientVersion
VM 操作系统版本 - vdiVersionInfo.vmVersion
可用的外围设备 - devices.speakers.available、devices.cameras.available、devices.microphones.available (实时更新 JSON 文件)
所选外围设备 - devices.speakers.selected、devices.cameras.selected、devices.microphone.selected (实时更新 json 文件)
辅助铃声 - devices.secondaryRinger (json 文件的实时更新)

注意

在 WebRTC 优化中，仅填充 vdiConnectedState，指示会话当前所处的优化。会话的 JSON 文件中未存储 vdiVersionInfo 和设备信息。如果没有可用的优化，则不会对 JSON 文件进行更新。

VDI 中的通话质量仪表板

CQD) (通话质量仪表板允许 IT 专业人员使用聚合数据来识别造成媒体质量问题的问题，方法是比较用户组的统计信息来识别趋势和模式。 CQD 不专注于解决单个呼叫问题，而是专注于确定适用于许多用户的问题和解决方案。

现在，通过多个维度和筛选器公开 VDI 用户信息。有关每个维度的更多信息，请查看此页面。

注意

适用于 CQD 的 Power BI 查询模板下载中提供了新的体验质量 (QER) 模板。版本 8 现在包含用于查看 VDI 以客户端为中心的指标的模板。在 VDI 报告中，使用新体系结构优化的用户被归类为“VDI 2.0 优化”，而“优化”则指 WebRTC 优化。

重要

在 CQD 中，维度“第二客户端 VDI 模式”VdiMode 值 (x2xx) 表示 VDI SlimCore 优化和 VDI SlimCore 未连接 (未优化回退) 。这种重复可能会导致误解，因为未优化会话中的通话质量差可能是 VDI SlimCore 优化的问题。维度“第二个客户端 VDI 已优化”是显示用户是否得到优化的准确方法，因为此维度计算 VDI 模式和“第二个客户端 VDI 连接状态”之间的端到端结果值。仅当连接状态为“已连接”时，才会使用 SlimCore 进行端到端优化。
维度“客户端 VDI 已优化”的 CQD 报告中的值为“非活动”意味着管理员已禁用 Teams 优化策略 (例如，通过 Citrix Studio 策略“Microsoft Teams 重定向”，或通过 Omnissa 和 AVD/Windows 365) 的注册表项禁用。这会导致 VdiMode x0xx (第二位数字为零) 。此方案中的用户将还原为服务器端呈现，其中所有多媒体都由虚拟机处理，无需卸载到端点。
在 Citrix 环境中，VDA 安装在用户的工作站 (远程 PC) 上，如果用户在工作站 (（即本地) ）启动 Teams，则 Teams 会话可能会被标记为“非活动”或未优化。

查询基础知识

格式正确的 CQD 查询/报告包含以下所有三个参数：

格式正确的查询的一些示例如下：

“显示上个月 [筛选器] 具有新优化 [维度] 的 VDI 用户的差流 [测量]。”
“显示上个月按 Total Stream Count [Dimension] 显示糟糕的应用共享 [度量] 以及第一或第二客户端 VDI 模式优化的位置 [筛选器]。”

也可以使用许多维度和度量值作为筛选器。您可以在查询中使用过滤器来消除信息，就像选择维度或度量以在查询中添加或包含信息一样。

UNION 的作用

默认情况下，筛选器允许您使用 AND 运算符筛选条件。但在某些情况下，你可能希望将多个筛选条件组合在一起，以获得类似于 OR 运算的结果。例如：若要从 VDI 用户获取所有流，UNION 将提供合并数据集的独特视图。要使用“联合”，请在你要联合的两个筛选条件上的“联合”字段中插入普通文本。

呼叫方和被呼叫方位置

CQD 不使用调用方或被调用方字段，而是使用 First 和 Second ，因为调用方和被调用方之间存在中间步骤。

第一个 始终是服务器终结点 (例如，如果服务器涉及流，则 Audio-Video 多点控制单元或媒体处理器服务器) 。
第二个 始终是客户端终结点，除非它是服务器-服务器流。

如果两个端点类型相同 (例如，个人对个人呼叫) ，则根据用户代理类别的内部排序设置第一个和第二个，以确保排序一致。

已知问题

对于公共预览版) 、演示者 (和扩展中的 Windows) (Windows 、Citrix (Mac) 和 Citrix/AVD (Windows 终结点，查看者) 可能会在应用共享时遇到鼠标拖动或光标延迟。如果演示者停止并重新启动应用共享，则不再存在延迟。此问题在 Teams 26149.x.x.x 或更高版本中得到修复。
对于公共预览版) 中的 Windows) (Windows 、Mac) (Citrix/AVD 和 Windows 终结点的 Citrix/AVD (，尝试加入启用了 Captcha 的会议的匿名 VDI 用户无法共享其屏幕。
对于 Teams/设置/识别) (语音或人脸识别注册，用户不能从下拉菜单更改相机/麦克风。它将始终使用通过 RDP/HDX/Blast/DCV 协议本身可供虚拟桌面使用的默认系统设备。因此，管理员必须通过配置相应的外围重定向策略来确保 VM/Teams 有权访问它们。
如果 Teams 已优化，虚拟机中“系统”/“设置”/“声音”下的混音器无法控制音量级别。用户必须依赖 Teams 音频设置中的内置音量滑块或终结点本身的音量合成器。
SCP) (屏幕记录保护会导致演示者的屏幕显示为黑屏，只有鼠标光标位于顶部 (接收方) 可以看到。此问题已在 Teams 25060.205.3499.6849 和远程桌面客户端 1.2.6081 或 Windows 应用 2.0.379 中修复。
如果在活动调用期间将虚拟机锁定 (VM) ，则调用将断开连接。此问题已在 25094.303.3554.9058 或更高版本中修复。终结点锁定不会导致摄像头、麦克风和屏幕共享自动关闭。
如果用户从同一台本地计算机启动虚拟桌面并登录 Teams，则在连接了 HID 外设的本地计算机上运行的 Teams 中通话断线。如果用户有一个活动的虚拟桌面，并启动了安装了 Teams (的第二个虚拟桌面或其他使用优化) 的统一通信应用程序，也会发生此问题。
目前不支持相机自我预览， (是在“设置”/“设备”下，也不支持在通话中选择相机图标) 上的向下箭头时。
在终结点的控制面板/Apps/Installed apps 中，用户会看到多个“Microsoft Teams VDI”条目， () 安装的每个 Slimcore 包都有一个条目。较新的拆分 MSIX 包修复了此问题，其中“Microsoft Teams VDI 优化器”是菜单上显示的唯一应用， (并且较旧的“Microsoft Teams VDI”条目将在一段时间后自动清理) 。
进行全屏共享时，呼叫监控窗口对其他参与者可见 (，) 内没有任何视频内容。
用户尝试截取 Microsoft Teams 内容的屏幕截图， (例如传入的屏幕共享或视频源，) 无法捕获任何内容，因为它是在用户的设备中呈现 (卸载) 。因此，捕获了一个黑色方块。此限制不适用于 PowerPoint Live，因为该模态不会卸载 (换句话说，它是由 Teams 应用) 在虚拟机上呈现的。 Citrix 客户可以实施此解决方法来拍摄屏幕截图，或使用 Citrix 截图工具。
在 Citrix 中，如果演示者同时使用 VDA (Virtual Delivery Agent) 版本 2402 和 CWA for Windows 2309.1 (或更高版本) ，则其他参与者的应用程序共享会话可能会冻结。
- 当视频元素被销毁时，就会发生这个问题。
  - 例如，参与者在应用共享会话期间关闭相机。
  - 如果有人只打开摄像头，则没有问题，因为视频元素是创建的，而不是销毁的。
  - 如果演示者最大化呼叫监视器 (，则会破坏演示者正在) 共享的内容的自我预览。
- 停止并重新共享窗口应该可以解决此问题。
- 此问题已在 Teams 24335.206.X.X 或更高版本中得到解决。
在 CQD 中，vdiMode (x2xx) 同时表示 VDI SlimCore 优化和未优化回退，这可能会错误地归因于较差的通话质量。有关详细信息，请参阅本文的 VDI 中的通话质量仪表板部分。
对于 Amazon WorkSpaces，共享系统音频 (包括计算机音频) ，不支持通过聊天共享屏幕。

反馈

此页面是否有帮助？

Last updated on 2026-08-10