Bulk upgrade to the new Microsoft Teams client
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
Prerequisites for target computers
For new Teams to be successfully installed, computers must meet the minimum requirements listed here.
Required system and app requirements
| Requirement | Version |
|---|---|
| Windows | Windows 10 version 10.0.19041 or higher |
| Classic Teams app | Version 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. |
| Settings | Turn on the "Show Notification Banners" setting in System > Notifications > Microsoft Teams to receive Teams Notifications. |
| Webview2 | Update to the most current version. Learn more: Enterprise management of WebView2 Runtimes |
| App sideloading enabled | Ensure 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) | Learn more at Delivery Optimization |
Note
Learn more: Update History for Microsoft 365 Apps.
Step 1: Upgrade the new Teams application
All steps must be completed to successfully upgrade to the new Teams.
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:
- Download the .exe installer
- Open the Command Prompt as an Admin.
- At the prompt enter: .\teamsbootstrapper.exe -p
- A success or fail status displays. If you receive an error, learn more at Common HRESULT values.
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.
- Download the .exe installer.
- Download the MSIX.
- Open the Command Prompt as an Admin.
- Depending on where your MSIX is located, do the following:
For local path, enter: .\teamsbootstrapper.exe -p -o "c:\path\to\teams.msix"
Example:
For UNC, enter: .\teamsbootstrapper.exe -p -o "\unc\path\to\teams.msix"
Example:
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:
- Download the .exe installer.
- Use Intune, Microsoft Endpoint Configuration Manager, Group Policy, or third-party distribution software, to distribute the installer to your target computers.
- 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
- Sign in to the Microsoft Teams admin center.
- Select Teams > Teams Update policies from the left navigation pane.
- Select Add to create a new policy or select an existing policy to open Update policy.
- Name the update policy, add a description, and select the setting for “Use new Teams client”, as shown below.
| Setting | Description |
|---|---|
| New Teams as default | Sets the new Teams as default. Note: This option is currently being rolled out |
| Classic Teams as default | Use 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.
- 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.
- 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 goes into effect within one minute. The user doesn't have to restart the app.
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:
I. Users can launch classic Teams, and then switch the toggle to go to new Teams.
OR
II. Users can directly launch new Teams:
- In Windows, select Start > new Microsoft Teams.
- Select "Yes" at the confirmation prompt screen.
- Once confirmed, the new Teams launches and is the default version.
Feedback
Submit and view feedback for