Upgrade to the new Teams using policies
You can upgrade to the new Teams client to your organization by setting policies in either the Teams Admin Center or by using PowerShell.
Prerequisites
Requirement | Version |
---|---|
Windows | Windows 10 version 10.0.19041 or higher (excluding Windows 10 LTSC for Teams desktop app) |
Webview2 | Update to the most current version. Learn more: Enterprise management of WebView2 Runtimes |
Teams app | Version 1.6.00.4472 to see the Try the new Teams toggle.If you are at a lower version, select the overflow menu (…) > Check for updates > Update. Then restart your app. |
Settings | Turn on the "Show Notification Banners" setting in System > Notifications > Microsoft Teams to receive Teams Notifications. |
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) is not supported. |
Required Microsoft 365 Apps Security Updates
Channel | Version & Build |
---|---|
Semi-Annual Enterprise Channel | Version 2302 (Build 16130.20306)Version 2208 (Build 15601.20578) |
Monthly Enterprise Channel | Version 2301 (Build 16026.20222)Version2212 (Build 15928.20294) |
Office LTSB | Version 2018 (Build 10396.20023)Version 2021 (Build 14332.20481) |
Learn more at Update History for Microsoft 365 Apps.
Set the policies to upgrade to the new Teams client
As an admin, you can manage how new Teams to your users.
To control which users can see the toggle, use the Teams admin setting UseNewTeamsClient under the TeamsUpdateManagement policy.
Manage this setting in the Teams Admin Center or using Teams PowerShell.
Configure setting via Teams Admin Center.
Policy settings for upgrade
Setting | Description |
---|---|
Not enabled | Use this value to hide the new Teams toggle switch. Users won't be able to opt in to the new Teams. |
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. |
Microsoft controlled | Default. The value lets Microsoft control whether the new Teams toggle switch is shown or not based on product readiness |
**New Teams as default Rollout for the feature began in early August, 2023 | Use this value to make new Teams as the default version. Users can switch back to classic Teams using the toggle. |
In addition to PowerShell, you can also use Teams Admin Center to manage the visibility of the toggle on a per-user basis.
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 |
---|---|
Not enabled | Use this value to hide the new Teams toggle switch. Users won't be able to opt in to the new Teams. |
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. |
New Teams as default | Sets the new Teams as default. Note: This option is currently being rolled out |
Microsoft controlled | Default. Use this value to let Microsoft control the following:-Whether the "Try the new Teams" toggle switch is shown or not- In the future, let Microsoft manage the installation of the new Teams client and Allow Microsof to determine default client behavior based on the rollout schedule. |
Note
The option "Classic Teams as default" was previously called "Users can choose".
Select new Teams as default from this setting to ensure users can get the new Teams experience when they launch
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.
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.
How to uninstall the new Teams client
Any user who was using the new Teams before the policy was implemented can manually opt out by using the new Teams toggle.
After they opt out, the toggle won't appear when they relaunch Teams. To prevent users from using this client and want to uninstall the client, users can manually uninstall it from settings.
Remove new Teams for all users
To remove the new Teams from all users' computers, use the following PowerShell command:
Remove-AppxPackage
PowerShell cmdlet to remove new Teams from all users on all computers:
Get-AppxPackage MSTeams -AllUsers |Remove-AppxPackage -AllUsers For an individual user without administrator privilege, use this command: Get-AppxPackage MSTeams|Remove-AppxPackage
Feedback
Submit and view feedback for