使用策略升级到新的 Teams

• 适用于:

  Microsoft Teams

可以通过在 Teams 管理员 中心设置策略或使用 PowerShell 升级到组织的新 Teams 客户端。

先决条件

要求	版本
Windows	Windows 10版本 10.0.19041 或更高版本 (不包括Windows 10 LTSC for Teams 桌面应用) 。 Windows N SKU 的用户需要为 Windows 10/11 N 启用媒体功能包
Webview2	更新到最新版本。 了解详细信息： WebView2 运行时的企业管理
Teams 应用	版本 1.6.00.4472 以查看“试用新 Teams”切换。 如果使用的是较低版本，请选择溢出菜单 (...) > 检查更新>更新。 然后重启应用。
Office	Microsoft 365 应用版或Office LTSC 2021 了解详细信息：Office 版本和与 Microsoft 365 服务的连接
设置	打开系统>通知 Microsoft Teams 中的“显示通知>横幅”设置以接收 Teams 通知。
传递优化 (DO)	DO 支持 Teams 自动更新，这是 服务协议的一部分所必需的。 概述： 什么是传递优化？ 建议的设置： 设置传递优化 注意： 不支持下载模式 100 (绕过) 。

必需Microsoft 365 应用版安全汇报

频道	版本 & 生成
Semi-Annual 企业频道	版本 2302 (内部版本 16130.20306) 版本 2208 (内部版本 15601.20578)
每月企业频道	版本 2301 (内部版本 16026.20222) 版本 2212 (内部版本 15928.20294)
Office LTSB	版本 2018 (内部版本 10396.20023) 版本 2021 (内部版本 14332.20481)

有关详细信息，请参阅更新Microsoft 365 应用版的历史记录。

注意

经典 Teams 客户端的可用性结束于 2024 年 6 月 30 日。 有关详细信息，请参阅 经典 Teams 客户端的可用性终止。

设置要升级到新 Teams 客户端的策略

作为管理员，你可以管理新 Teams 向用户提供的方式。

若要控制哪些用户可以看到切换，请使用 TeamsUpdateManagement 策略下的 Teams 管理员设置 UseNewTeamsClient。

在 Teams 管理员中心或使用 Teams PowerShell 管理此设置。

Teams 管理员中心

通过 Teams 管理员 中心配置设置。

升级策略设置

设置	说明
未启用	使用此值可隐藏新的 Teams 切换开关。 用户将无法选择加入新 Teams。
默认为经典 Teams	使用此值可让经典 Teams 默认版本。 将显示新的 Teams 切换开关，让用户选择加入新 Teams，并根据需要切换回去。 注意： 此选项以前称为 “用户可以选择”。
Microsoft 控制	默认。 值允许 Microsoft 根据产品就绪情况控制是否显示新的 Teams 切换开关
新 Teams 作为此功能的默认 推出始于 2023 年 8 月初	使用此值可使新 Teams 成为默认版本。 用户可以使用切换开关切换回经典 Teams。
新 Teams 仅在 2024 年 2 月中旬推出 ()	使用此值可使新 Teams 成为默认版本，并在 14 天后卸载经典 Teams。 用户无法选择切换回经典 Teams。

除了 PowerShell 之外，还可以使用 Teams 管理员中心来管理每个用户切换的可见性。

1. 登录到 Microsoft Teams 管理中心。

2. 从左侧导航窗格中选择 “Teams > 更新策略 ”。

3. 选择“ 添加 ”以创建新策略，或选择现有策略以打开“更新策略”。

4. 命名更新策略，添加说明，并选择“使用新 Teams 客户端”的设置，如下所示。

   

设置	说明
未启用	使用此值可隐藏新的 Teams 切换开关。 用户将无法选择加入新 Teams。
默认为经典 Teams	使用此值可让经典 Teams 默认版本。 将显示新的 Teams 切换开关，让用户选择加入新 Teams，并根据需要切换回去。 注意： 此选项以前称为 “用户可以选择”。
默认新建 Teams	将新 Teams 设置为默认值。 注意： 此选项当前正在推出
Microsoft 控制	默认。使用此值可让 Microsoft 控制以下内容： -是否显示 “试用新 Teams”切换开关 - 将来，让 Microsoft 管理新 Teams 客户端的安装，并允许 Microsoft 根据 推出计划确定默认客户端行为。

注意

选项“经典 Teams 作为默认”以前称为“用户可以选择”。

5. 从此设置中选择“新 Teams”作为默认设置，以确保用户在启动时可以获得新的 Teams 体验

6. 定义策略后，可以使用组策略分配将其分配给 用户或用户组 。 若要将其分配给组，请选择“ 组策略分配 ”，然后选择 “添加”，或选择列出的组之一。

选择要分配给组的策略。

7. 定义策略后，可以将其分配给“用户管理用户”>下的特定用户。

如果在 Teams 管理员中心更新策略设置，则新设置最长可能需要 24 小时才能生效。 用户无需重启应用。

PowerShell

将 UseNewTeamsClient 设置配置为以下可能值之一：

设置	解释
MicrosoftChoice	默认设置。 此值允许 Microsoft 控制是否根据产品就绪情况显示 Teams (预览) 切换开关。
用户选择	此值允许向所有用户显示新的 Teams 切换开关。 用户可以选择加入或退出。
AdminDisabled	此值在视图中隐藏新的 Teams 切换开关。 用户将无法选择加入新 Teams。

下面是在 PowerShell 中配置此设置所需的步骤：

1. 导入最新的 Teams PowerShell cmdlet (需要版本 4.9.1 或更高版本) ，方法是按照 使用 Microsoft Teams PowerShell 管理 Teams 说明进行操作。 直接链接：PowerShell 库 Microsoft Teams 4.9.1。
2. 使用以下命令连接到管理员帐户：

Connect-MicrosoftTeams

3. 通过 PowerShell 连接并登录后，可以浏览相关命令的列表：输入 *-CsTeamsUpdateManagementPolicy，并通过) (选项卡键的命令按 Tab。

4. 使用以下命令更改现有更新管理策略，以选择加入已分配的用户以允许他们试用新的 Teams：

Set-CsTeamsUpdateManagementPolicy -identity <new_policy_name> -UseNewTeamsClient 

UserChoice

示例：

Set-CsTeamsUpdateManagementPolicy -identity MySetting -UseNewTeamsClient UserChoice

注意

用于 现有策略修改 的此方法不会立即生效。 最多需要 24 小时才能将更改传播到用户。 用户不需要重启应用，但特别是对于选择加入，他们需要在全新安装后重启一次才能看到切换。

5. 使用以下命令部署 新策略 ，以选择退出特定用户查看切换：

New-CsTeamsUpdateManagementPolicy -identity <new_policy_name> -UseNewTeamsClient AdminDisabled

Grant-CsTeamsUpdateManagementPolicy -identity <user> -PolicyName <new_policy_name>

例子：

New-CsTeamsUpdateManagementPolicy -identity MySetting -UseNewTeamsClient AdminDisabled
Grant-CsTeamsUpdateManagementPolicy -identity admin@contoso.org -PolicyName MySetting

注意

新策略分配方法最多需要 24 小时才能生效。 用户无需重启应用。

如何卸载新的 Teams 客户端

在实施策略之前使用新 Teams 的任何用户都可以使用新的 Teams 切换来手动选择退出。

选择退出后，重新启动 Teams 时不会显示切换开关。 若要防止用户使用此客户端并想要卸载客户端，用户可以从设置中手动卸载它。

删除所有用户的新 Teams

若要从所有用户的计算机中删除新 Teams，请使用以下 PowerShell 命令：

Remove-AppxPackage 

PowerShell cmdlet 用于从所有计算机上的所有用户中删除新 Teams：

Get-AppxPackage *MSTeams* -AllUsers |Remove-AppxPackage -AllUsers

没有管理员权限的单个用户的 PowerShell cmdlet：

Get-AppxPackage *MSTeams*|Remove-AppxPackage

用于在计算机范围内卸载 Teams 的命令：teamsbootstrapper.exe -x -m

注意

如果你已将 Teams 更新策略设置为 “未启用”，但用户仍收到带有 M365 应用的新 Teams 客户端，请按照如何卸载新 Teams 客户端 一文中的说明操作，为你的用户卸载它。

用户设置迁移

在初始切换期间，最终用户设置会自动从经典 Teams 迁移到新 Teams。

注意

用户首次更新到新 Teams 时，仅迁移一次设置。 之后，如果用户在经典 Teams 和新 Teams 之间来回切换，则不会进行设置更改的增量迁移。

迁移的设置

从经典 Teams 切换到新 Teams 时自动迁移的本地设置：

区域	项目
常规	聊天密度
	在聊天列表中显示消息预览
	应用语言
	> 显示 > 关闭动画
设备	音频设备
	> 音频设备 > 扬声器
	> 音频设备 > 麦克风
	噪声抑制
	高保真音乐模式
	辅助响铃
	相机
	自动调整麦克风敏感度
文件和链接	下载：位置
	下载：始终作为保存下载文件的位置
	文件打开首选项：始终打开 word/ppt/excel 文件...
自定义背景图像文件	磁盘上的映像文件
通话/会议阶段	背景效果，模糊

相关主题

• 排查新 Teams 客户端中的安装问题
• 升级到适用于虚拟化桌面基础结构的新 Teams (VDI)