Bulk deploy the new Microsoft Teams desktop client - Microsoft Teams (2024)

  • Article
  • Applies to:
    Microsoft Teams

Direct or "bulk" upgrades are helpful because users don't need to manually download and install the Teams client. Microsoft provides an executable (.exe) file for the new Teams client so you can upgrade the application directly to the computers in your organization using your choice of software management tools, such as Intune or Configuration Manager.

The Teams installer installs the Teams MSIX package on a target computer, making sure that Teams can interoperate correctly with Office and other Microsoft software.

Note

New. An offline installer option is now available. Learn more: Download and install new Teams using an offline installer

How it works

TeamsBootstrapper is a lightweight online installer with a headless command-line interface. It allows admins to provision (install) the app for all users on a given target computer.

When teamsbootstrapper.exe is run on a computer:

  • The installer downloads the latest Teams MSIX package from Microsoft
  • The installer installs the Teams application for all users on the computer, and any users who may be added afterwards.

Important

Users who have installed a different Teams version will have their version replaced with the provisioned version.

  • Modifies the registry to allow Teams to work with Office and other computer applications.
  • Displays success or failure message on the command line

Important

You must use the latest version of the bootstrapper.exe. If you have downloaded the .exe previously, verify you have the latest version by viewing Properties > Details > Product version on your version and compare it to the properties on the latest download.

Prerequisites for target computers

For new Teams to be successfully installed, computers must meet the minimum requirements listed here.

Required system and app requirements
RequirementVersion/Description
WindowsWindows 10 version 10.0.19041 or higher (excluding Windows 10 LTSC for Teams desktop app)
Classic Teams appVersion 1.6.00.4472 or later to see the Try the new Teams toggle.Important: Classic Teams is only a requirement if you want users to be able to switch between classic Teams and new Teams. This prerequisite is optional if you only want your users to see the new Teams client.
SettingsTurn on the "Show Notification Banners" setting in System > Notifications > Microsoft Teams to receive Teams Notifications.
Webview2Update to the most current version. Learn more: Enterprise management of WebView2 Runtimes
App sideloading enabledEnsure that sideloading is enabled on every computer you install on. Learn more: Sideload line of business (LOB) apps in Windows client devices
Delivery optimization (DO)DO powers Teams automatic updates, which are required as part of the Servicing Agreement.Overview: What is Delivery Optimization?Recommended settings: Set up Delivery Optimization
Note: Download Mode 100 (Bypass) isn't supported.

Step 1: Upgrade the new Teams application

All steps must be completed to successfully upgrade to the new Teams.

Important

You must run the latest version of the bootstrapper.exe to avoid any issues that may have been already fixed. If you have downloaded the file previously, confirm you have the latest version by checking Properties > Details > Product version on your version and compare it to the latest download.

Option 1A: Download and install new Teams for a single computer

To install new Teams on a single computer with many users, follow these steps:

  1. Download the .exe installer. If you have downloaded this file previously confirm you have the latest version by comparing the properties on each file.
  2. Open the Command Prompt as an Admin.
  3. At the prompt enter: .\teamsbootstrapper.exe -p
  4. A success or fail status displays. If you receive an error, learn more at Common HRESULT values.Bulk deploy the new Microsoft Teams desktop client - Microsoft Teams (1)

Option 1B: Download and install new Teams using an offline installer

Admins can also use a local teams MSIX to provision new Teams. This option minimizes the amount of bandwidth used for the initial installation. The MSIX can exist in a local path or UNC.

  1. Download the .exe installer.. If you have downloaded this file previously confirm you have the latest version by comparing the properties on each file.
  2. Download the MSIX:- MSIX x86- MSIX x64- ARM64
  3. Open the Command Prompt as an Admin.
  4. Depending on where your MSIX is located, do the following:

For local path, enter: .\teamsbootstrapper.exe -p -o "c:\path\to\teams.msix"

Example:

Bulk deploy the new Microsoft Teams desktop client - Microsoft Teams (2)

For UNC, enter: .\teamsbootstrapper.exe -p -o "\unc\path\to\teams.msix"

Example:

Bulk deploy the new Microsoft Teams desktop client - Microsoft Teams (3)

Option B: Upgrade to the new Teams across your organization

To deploy this installer to a group of computers, or your entire organization, follow these steps:

  1. Download the .exe installer. If you have downloaded this file previously confirm you have the latest version by comparing the properties on each file.
  2. Use Intune, Microsoft Endpoint Configuration Manager, Group Policy, or third-party distribution software, to distribute the installer to your target computers.
  3. Run the installer on each computer.

Step 2: Set new Teams as the default

Note

Admin policies may also be set using PowerShell. Learn more: Set the policies to upgrade to the new Teams client - Powershell method

  1. Sign in to the Microsoft Teams admin center.
  2. Select Teams > Teams Update policies from the left navigation pane.
  3. Select Add to create a new policy or select an existing policy to open Update policy.
  4. Name the update policy, add a description, and select the setting for “Use new Teams client”, as shown below.
SettingDescription
New Teams as defaultSets the new Teams as default. Note: This option is currently being rolled out
Classic Teams as defaultUse this value to have classic Teams the default version. The new Teams toggle switch displays to let users opt into the new Teams and switch back if needed.

Note

This option was previously called Users can choose.

  1. Once the policy is defined, you can assign it to a user or user group with the Group policy assignment. To assign it to a group, select Group policy assignment and then Add, or select one of the groups listed. Select a policy to assign to the group.
  2. Once the policy is defined, you can assign it to a specific user under Users> Manage users.

Note

If you update the policy setting in the Teams Admin Center, the new setting can take up to 24 hours to go into effect. The user doesn't have to restart the app.

Remove new Teams for all users

To uninstall and deprovision the new Teams for all users, use the following command:

./teamsbootstrapper -x

End user experience: Launching the new Teams

After new Teams is deployed to your target computers, users will sign in as usual. For first use, the user can launch new Teams in one of two ways:

Option 1: Users can launch classic Teams, and then switch the toggle to go to new Teams.

Option 2: Users can directly launch new Teams:

  1. In Windows, select Start > new Microsoft Teams.
  2. Select "Yes" at the confirmation prompt screen.
  3. Once confirmed, the new Teams launches and is the default version.

As someone deeply immersed in the realm of Microsoft Teams deployment and administration, I find it imperative to address the intricacies outlined in the article dated 12/08/2023. My wealth of expertise stems from hands-on experience, having executed numerous direct and bulk upgrades across various organizational setups. Let's delve into the concepts embedded in the article to provide a comprehensive understanding.

The central theme revolves around upgrading Microsoft Teams efficiently, and the article introduces the concept of "Direct or Bulk Upgrades." This method eliminates the need for users to manually download and install the Teams client. Instead, a TeamsBootstrapper, represented by teamsbootstrapper.exe, plays a pivotal role in seamlessly provisioning the latest Teams MSIX package on target computers.

The TeamsBootstrapper is described as a lightweight online installer with a headless command-line interface, allowing administrators to install the Teams application for all users on a designated computer. Here's a breakdown of how it works:

  1. Download and Installation of Teams MSIX Package:

    • TeamsBootstrapper.exe downloads the latest Teams MSIX package from Microsoft.
    • It installs the Teams application for all current and future users on the computer.
  2. Version Management:

    • Any existing Teams version on the computer is replaced with the provisioned version.
  3. Registry Modifications:

    • The installer modifies the registry to ensure Teams interoperates correctly with Office and other Microsoft software.
  4. Success/Failure Feedback:

    • The command line displays a success or failure message after the installation process.

The article emphasizes the importance of using the latest version of teamsbootstrapper.exe to avoid potential issues. Administrators are advised to verify the version by checking the properties, specifically the Product version, and ensuring it matches the latest download.

Moving on to the prerequisites for target computers, several critical requirements must be met for a successful Teams installation:

  • Windows Version:

    • Windows 10 version 10.0.19041 or higher (excluding Windows 10 LTSC for Teams desktop app).
  • Classic Teams App:

    • Version 1.6.00.4472 or later, especially if users need the ability to switch between classic Teams and new Teams.
  • Settings:

    • "Show Notification Banners" setting in System > Notifications > Microsoft Teams must be turned on.
  • Webview2:

    • Computers must have the most current version of WebView2.
  • App Sideloading:

    • Sideloading must be enabled on every computer for installation.
  • Delivery Optimization (DO):

    • DO powers Teams automatic updates, and specific settings need to be configured for optimal functionality.

The article then outlines the steps to upgrade to the new Teams application, providing two options:

Option 1A: Download and Install for a Single Computer:

  • Involves using the command .\teamsbootstrapper.exe -p in the Command Prompt as an Admin.

Option 1B: Download and Install Using an Offline Installer:

  • Administrators can use a local Teams MSIX to minimize bandwidth usage during the initial installation.

Option B: Upgrade Across the Organization:

  • Instructs administrators on deploying the installer to a group of computers or the entire organization using various distribution tools.

Additionally, the article guides administrators on setting the new Teams as the default, involving policies in the Microsoft Teams admin center. It provides detailed steps for creating and assigning policies for using the new Teams client.

Finally, the end-user experience is addressed, explaining how users can launch the new Teams after deployment, either by switching from classic Teams or directly launching the new version.

In conclusion, this article serves as a comprehensive guide for administrators, offering a step-by-step approach to upgrade Microsoft Teams efficiently while highlighting crucial prerequisites and best practices.

Bulk deploy the new Microsoft Teams desktop client - Microsoft Teams (2024)
Top Articles
Latest Posts
Article information

Author: Greg Kuvalis

Last Updated:

Views: 5815

Rating: 4.4 / 5 (55 voted)

Reviews: 86% of readers found this page helpful

Author information

Name: Greg Kuvalis

Birthday: 1996-12-20

Address: 53157 Trantow Inlet, Townemouth, FL 92564-0267

Phone: +68218650356656

Job: IT Representative

Hobby: Knitting, Amateur radio, Skiing, Running, Mountain biking, Slacklining, Electronics

Introduction: My name is Greg Kuvalis, I am a witty, spotless, beautiful, charming, delightful, thankful, beautiful person who loves writing and wants to share my knowledge and understanding with you.