批量升级到新的 Microsoft Teams 客户端

• 适用于:

  Microsoft Teams

直接或“批量”升级非常有用，因为用户不需要手动下载和安装 Teams 客户端。 Microsoft为新的 Teams 客户端提供可执行 (.exe) 文件，以便你可以使用所选的软件管理工具（如 Intune 或 Configuration Manager）将应用程序直接升级到组织中的计算机。

Teams 安装程序在目标计算机上安装 Teams MSIX 包，确保 Teams 能够与 Office 和其他Microsoft软件正确互操作。

注意

新增功能。 脱机安装程序选项现在可用。 了解详细信息： 使用脱机安装程序下载并安装新的 Teams

运作方式

TeamsBootstrapper 是具有无外设命令行界面的轻型联机安装程序。 它允许管理员为给定目标计算机上的所有用户预配 (安装) 应用。

在计算机上运行 teamsbootstrapper.exe 时：

• 安装程序从 Microsoft 下载最新的 Teams MSIX 包
• 安装程序为计算机上的所有用户以及之后可能添加的任何用户安装 Teams 应用程序。

重要

已安装不同 Teams 版本的用户会将其版本替换为预配的版本。

• 修改注册表以允许 Teams 使用 Office 和其他计算机应用程序。
• 在命令行上显示成功或失败消息

重要

必须使用最新版本的 bootstrapper.exe。 如果以前已下载 .exe，请通过查看版本上的“属性详细信息>产品版本”>来验证是否具有最新版本，并将其与最新下载的属性进行比较。

目标计算机的先决条件

若要成功安装新 Teams，计算机必须满足此处列出的最低要求。

必需的系统和应用要求

要求	版本/说明
Windows	Windows 10 版本 10.0.19041 或更高版本 (不包括 Windows 10 LTSC for Teams 桌面应用)
经典 Teams 应用	版本 1.6.00.4472 或更高版本，查看 “试用新 Teams ”切换。 重要： 仅当你希望用户能够在经典 Teams 和新 Teams 之间切换时，才要求经典 Teams。 如果仅希望用户看到新的 Teams 客户端，则此先决条件是可选的。
Office	Microsoft 365 应用或 Office LTSC 2021 了解详细信息： Office 版本和与 Microsoft 365 服务的连接
设置	打开“系统>>通知”中的“显示通知横幅”设置，Microsoft Teams 接收 Teams 通知。
Webview2	更新到最新版本。 了解详细信息： WebView2 运行时的企业管理
传递优化 (DO)	DO 支持 Teams 自动更新，这是 服务协议的一部分所必需的。 概述： 什么是传递优化？ 建议的设置： 设置传递优化 注意： 不支持下载模式 100 (绕过) 。

注意

了解详细信息： Microsoft 365 应用的更新历史记录。

步骤 1：升级新的 Teams 应用程序

必须完成所有步骤才能成功升级到新的 Teams。

重要

必须运行最新版本的 bootstrapper.exe，以避免可能已修复的任何问题。 如果以前已下载过该文件，请通过检查版本上的“属性详细信息>产品版本”>来确认你拥有最新版本，并将其与最新下载版本进行比较。

选项 1A：下载并安装适用于单台计算机的新 Teams

若要在具有多个用户的单个计算机上安装新 Teams，请执行以下步骤：

1. 下载 .exe 安装程序。 如果之前已下载此文件，请通过比较每个文件的属性来确认你拥有最新版本。
2. 以管理员身份打开命令提示符。
3. 在提示符处输入： .\teamsbootstrapper.exe -p
4. 将显示成功或失败状态。 如果收到错误，请在 通用 HRESULT 值中了解详细信息。
   

选项 1B：使用脱机安装程序下载并安装新的 Teams

管理员还可以使用本地团队 MSIX 来预配新 Teams。 此选项可最大程度地减少用于初始安装的带宽量。 MSIX 可以存在于本地路径或 UNC 中。

1. 下载 .exe 安装程序。 如果之前已下载此文件，请通过比较每个文件的属性来确认你拥有最新版本。
2. 下载 MSIX：
   - MSIX x86
   - MSIX x64
   - ARM64
3. 以管理员身份打开命令提示符。
4. 根据 MSIX 所在的位置，执行以下操作：
   

对于本地路径，请输入：.\teamsbootstrapper.exe -p -o “c：\path\to\teams.msix”

例：

对于 UNC，请输入：.\teamsbootstrapper.exe -p -o “\unc\path\to\teams.msix”

例：

选项 B：在整个组织中升级到新的 Teams

若要将此安装程序部署到一组计算机或整个组织，请执行以下步骤：

1. 下载 .exe 安装程序。 如果之前已下载此文件，请通过比较每个文件的属性来确认你拥有最新版本。
2. 使用 Intune、 Microsoft Endpoint Configuration Manager、 组策略或第三方分发软件将安装程序分发到目标计算机。
3. 在每台计算机上运行安装程序。

适用于电脑和 Mac 的 Gov 云更新

电脑更新

如果客户租户位于 GCCH、DoD 或 Gallatin 上，则客户可能需要通过下面列出的注册表项设置初始云终结点。 使用注册表项设置终结点将限制团队连接到正确的云终结点，以便与 Teams 进行预登录连接，如下所示：

HKEY_CURRENT_USER\SOFTWARE\Policies\Microsoft\Office\16.0\Teams
Value = CloudType
value type = DWORD
  1 = Commercial, 2 = GCC, 3 = GCCH, 4 = DOD, 7 = Gallatin

Mac 更新

如果客户租户位于 GCCH、DoD 或 Gallatin 上，则客户可能需要通过下面列出的 .plist 配置密钥设置初始云终结点。 使用 .plist 配置设置终结点将限制团队连接到正确的云终结点，以便与 Teams 进行预登录连接，如下所示：

Domain: com.microsoft.teams2
Key: CloudType
Data Type: Int
Value: {Enter number associated with the cloud}
  1 = Commercial, 2 = GCC, 3 = GCCH, 4 = DOD, 7 = Gallatin

可以使用 Intune 将 .plist 配置传播到托管设备，如将 首选项文件设置添加到 intune 中的 macOS 设备Microsoft中所述。

步骤 2：将新 Teams 设置为默认值

注意

也可以使用 PowerShell 设置管理策略。 了解详细信息： 设置策略以升级到新的 Teams 客户端 - Powershell 方法

1. 登录到 Microsoft Teams 管理中心。
2. 从左侧导航窗格中选择 “Teams > 更新策略 ”。
3. 选择 添加 以新建策略，或选择现有策略以打开 更新策略。
4. 命名更新策略，添加说明，然后选择“使用新 Teams 客户端”的设置，如下所示。

设置	说明
默认新建 Teams	将新 Teams 设置为默认值。 注意： 此选项当前正在推出
默认为经典 Teams	使用此值可让经典 Teams 默认版本。 将显示新的 Teams 切换开关，让用户选择加入新 Teams，并根据需要切换回去。

注意

此选项以前称为 “用户可以选择”。

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

注意

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

删除所有用户的新 Teams

若要为所有用户卸载和取消预配新 Teams，请使用以下命令：

./teamsbootstrapper -x

删除所有用户的经典 Teams

重要

重要提示：此命令选项需要最低引导程序版本 1.0.2414501 或更高版本。

安装新的 Teams 版本后，使用以下命令为设备上的所有用户卸载经典 Teams 计算机范围的安装程序和经典 Teams 应用：

./teamsbootstrapper -u

最终用户体验：启动新 Teams

将新 Teams 部署到目标计算机后，用户将照常登录。 对于首次使用，用户可以通过以下两种方式之一启动新 Teams：

选项 1： 用户可以启动经典 Teams，然后切换切换开关以转到新的 Teams。

选项 2： 用户可以直接启动新的 Teams：

1. 在 Windows 中，选择“ 启动> 新Microsoft Teams”。
2. 在确认提示屏幕中选择“是”。
3. 确认后，新的 Teams 将启动，并且是默认版本。