Upgrade to new Teams for Virtualized Desktop Infrastructure (VDI)
This article describes the requirements and limitations of using the new Microsoft Teams client in a virtualized environment.
Important announcement for classic Teams for VDI
The classic Teams for VDI will reach end of availability on June 30th, 2024. For more information, see: End of availability for classic Teams client
After that date, users won't be able to use classic Teams but instead be prompted to switch to new Teams. We recommend you update to new Teams today.
Note
New Teams for VDI is now generally available for customers in public clouds, GCC, GCC High and DoD government cloud.
Requirements
For new Teams to be successfully installed, you need version 23306.3314.2555.9628 or higher. In addition, virtual machines must meet the minimum requirements listed here:
| Requirement | Version |
|---|---|
| Windows | - Windows 10.0.19041 or higher - Windows Server 2019 (10.0.17763) - Windows Server 2022 (10.0.20348) or higher- Windows Server 2016 is NOT supported. Plan upgrades.- WebView2 framework required in Windows Server and Windows 10/11 Multi-User environments |
| Webview2 | Minimum version: 90.0.818.66. Learn more: Enterprise management of WebView2 Runtimes |
| 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. |
| 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 |
| Exclude antivirus and DLP | Add new Teams to antivirus and DLP applications so Teams can start correctly. Learn more: Exclude antivirus and DLP applications from blocking Teams |
Virtualization provider requirements
Currently, new Teams on VDI with audio/video (AV) optimization is certified with Azure Virtual Desktops, Windows 365, Citrix, and VMware.
Review the information in this section to ensure that you meet all requirements for proper functionality.
Azure Virtual Desktop
Azure Virtual Desktop provides AV optimization for Teams on VDI. To learn more on requirements and installation, see Use Teams on Azure Virtual Desktop.
The following minimum versions are necessary to support the new Teams client:
- Remote Desktop Client for Windows 1.2.1755
- Remote Desktop Client for Mac 10.7.7
- WebRTC Redirector Service 1.1.2110.16001
Microsoft recommends using the latest available versions.
In addition, you must deploy the following registry key on the virtual desktop for the new Teams client to be optimized:
HKLM\SOFTWARE\Microsoft\Teams:
- Name: IsWVDEnvironment
- Type: DWORD
- Value: 1
Windows 365
Windows 365 uses AV optimization provided by Azure Virtual Desktop to ensure optimal Teams experiences from Cloud PCs. To learn more on requirements and installation, see Use Teams on Cloud PC.
The Windows 10/11 images in the gallery are preconfigured with required optimization components. When you install and use Microsoft Teams in your Cloud PC, you get an optimized experience. A new image with the new Teams client will be added to the gallery in a few weeks.
If you want to create custom images that include optimizations for Microsoft Teams, you need to perform the steps described in Create a custom Cloud PC image to support Microsoft Teams.
The following minimum versions are necessary to support the new Teams client:
- Remote Desktop Client for Windows 1.2.1755
- Remote Desktop Client for Mac 10.7.7
- Windows 365 app for Windows via the Microsoft Store
In addition, you must deploy the following registry key on the virtual desktop for the new Teams client to be optimized:
HKLM\SOFTWARE\Microsoft\Teams:
- Name: IsWVDEnvironment
- Type: DWORD
- Value: 1
Citrix Virtual Apps and Desktops and Citrix DaaS requirements
The following minimum versions are necessary to support the new Teams client:
Citrix Workspace app:
- Windows 2203 LTSR (and any CU)
- Windows 2302 CR
- Linux 2207
- Mac 2302
- Chrome/HTML5 2301
Citrix Virtual Delivery Agent (VDA):
- 2203 LTSR (and any CU)
- 2212 CR
- 1912 CU6 (but latest CU recommended - please note App Sharing is not supported on 1912)
In addition, you must deploy the following registry key on the VDA for the new Teams client to be optimized:
- Location: HKLM\SOFTWARE\WOW6432Node\Citrix\WebSocketService
- Key (REG_Multi_SZ): ProcessWhitelist
- Value: msedgewebview2.exe
If this registry key is missing, the new Teams client operates in nonoptimized mode (server-side rendering). This regkey is not needed anymore if you are using VDA 2402 (check here for more details).
Note
Citrix Virtual Apps (also known as published apps) is currently supported with VDA 2402 LTSR.
For additional information, learn more at Optimization for Microsoft Teams.
VMware Horizon and Workspace ONE requirements
The following minimum versions are necessary to support the new Teams client:
- Horizon 8 2111 ESB (8.4)
To learn more on the latest requirements and instructions, including how to configure media optimization for Teams, see Configuring Media Optimization for Microsoft Teams.
Deploy the new Microsoft Teams client
To deploy the new Microsoft Teams client to your organization, select one of the following options.
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.
Note
Make sure you have these KBs in your system, as they address many policy settings restricting download and installation of new Teams.
- If using Windows 10 or 11, make sure you're installing the appropriate KB patch Windows 10: October 26, 2023 - KB5031445 (OS Build 19045.3636) or Windows 11: October 26, 2023 - KB5031445 (OS Build 22621.2506). Otherwise, when GPO AllowAllTrustedApps is set to false and the issue mentioned in the “Features currently not available and known issues in VDI with the new Teams” section of this article can occur (New Teams fails to launch for users logging into non-persistent virtual desktops, or the app is not visible in the Start Menu.).
- If GPO BlockNonAdminUserInstall is set to true, users might face the issue mentioned in the “Features currently not available and known issues in VDI with the new Teams” section can occur (New Teams fails to launch for users logging into non-persistent virtual desktops, or the app is NOT visible in the Start Menu). Make sure you have the respective KB for your OS:
- KB5035942 (Windows 11 version 22H2 and 23H2, all editions)
- KB5035941 (Windows 10 any version, all editions)
- KB5036909 (Windows Server 2022)
Option 1: Uninstall the classic Teams client and install the new one
Recommended way to deploy new Teams in VDI. The direct or 'bulk deployment' method is used for this option. Learn more at Bulk deploy the new Microsoft Teams desktop client.
Using the teamsbootstrapper.exe -p command always guarantees the latest new Teams client is installed.
A phased and controlled rollout can then be achieved by selectively expanding the new computer catalogue/delivery group assignments to more users.
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:- MSIX x86- MSIX x64- ARM64.
- Open the Command Prompt as an Admin.
- Depending on where your MSIX is located, do the following steps:
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 2: Install both apps 'side by side'
Let the user switch between them by using the toggle on the top left of the Teams UI. You can control who sees the toggle by configuring the Teams Admin Center policy Teams update policy.
If the toggle is being used for the new Teams client rollout, admins must make sure that the VDI environments meet the minimum requirements described here: Troubleshooting installation issues in the new Teams client.
If IT administrators set restrictions for MSIX or deploy GPOs, it could prevent users from downloading and installing the app. If restrictions are in place, the user could see errors like this:
Important
The 'side by side' method is only supported in persistent environments. Classic Teams 1.7.00.7956 or higher will suppress the app switcher toggle irrespective of the Teams Admin Center policy value when classic Teams is running in a non-persistent environment, where non-persistent is detected based on the installation folder of classic Teams MSI, C:\Program Files (x86).
Classic Teams versus new Teams installers in VDI environments
The classic Teams client and the new Teams client have different install locations and profile management requirements. It's important to understand the differences and plan accordingly.
| Installer format | Install location | Auto update |
|---|---|---|
| Classic Teams MSI with the ALLUSERS=1 flag | C:\Program Files (x86)\Microsoft\Teams | Disabled |
| Classic Teams .EXE | %localappdata%/Microsoft/Teams | Enabled |
| New Teams .EXE bootstrapper | Teamsbootstrapper.exe is a lightweight wrapper online installer with a headless command-line interface. It allows admins to 'provision' (install) the app for all users on a given target computer/. It installs the Teams MSIX package on a target computer, making sure that Teams can interoperate correctly with Office and other Microsoft software.C:\Program Files\WindowsApps\PublisherName.AppName_AppVersion_architecture_PublisherIDExampleC:\Program Files\WindowsApps\MSTeams.23306.3314.2555.9628_x64_8wekyb3d8bbwe | Enabled. It can be disabled via regkey. Learn more: Disable new Teams autoupdate |
Troubleshooting new Teams deployment errors
Administrators can rely on the teamsbootstrapper.exe error code that describes the problem. If the error code doesn't provide enough information, more diagnostic information can be found in the detailed event logs.
- Go the Event Viewer (Local) > Applications and Services Logs > Microsoft > Windows.
- Check for available logs under these categories:
- AppxPackagingOM > Microsoft-Windows-AppxPackaging/Operational
- AppXDeployment-Server > Microsoft-Windows-AppXDeploymentServer/Operational
- Review logs under AppXDeployment-Server
Learn more here: Common error codes
Installation instructions for Windows Server 2019
For Windows Server 2019, the only supported installation method is:
Dism /Online /Add-ProvisionedAppxPackage /PackagePath:<MSIX package path> /SkipLicense
Make sure sideloading is enabled, and that WebView2 is installed. See 'Requirements' section above.
The /SkipLicense command is needed because the MSIX package isn't considered a "Store Package" (since it wasn't downloaded from the store). Therefore, for the Dism installation command to succeed, you need to enable this policy as well during installation time: Computer Configuration > Administrative Templates > Windows Components > App Package Deployment > Allow all trusted apps to install.
Known limitations:
- Classic Teams on Windows Server 2019 isn't displaying the app switcher toggle if Classic Teams version is lower than 1.6.00.33567
- New Teams on Windows Server 2019 currently isn't compatible with FSLogix and fails to launch. See FSLogix known issues for more details.
Outlook presence integration with New Teams in Windows Server 2019
For Outlook to properly display presence status, the following steps are required on the golden image:
- Install machine-wide (ALLUSERS=1) the 'Windows 10 1809 and Windows Server 2019 KB5035849 240209_02051 Feature Preview.msi'.
- Open your Group Policy Editor. Navigate to Computer Configuration\Administrative Templates\KB5035849 240209_02051 Feature Preview\Windows 10, version 1809 and Windows Server 2019. Change the value of that Setting to Enabled.
- Install KB5035849 March 2024 cumulative update from the Microsoft Update Catalog or WSUS for Enterprises.
- Install machine-wide (ALLUSERS=1) the 'MSTeamsNativeUtility.msi'.
- Reboot the virtual machine.
- Install new Teams 24033.811.2738.2546 or higher, using Dism as described in the section above.
Note
Steps 1, 2, 3, 4, and 5 are only required once. Subsequent golden image maintenances will not need these steps repeated.
Important
Outlook must be started after new Teams is launched for presence to be shown correctly.
Remove new Teams for all users
To uninstall and deprovision the new Teams for all users, use the following command:
./teamsbootstrapper -x
This command unregisters and deprovisions the new Teams for all users. Teams user profile/cache is deleted.
Disable new Teams autoupdate
To prevent new Teams from autoupdating, use the following registry key on the virtual machine. Only new Teams builds higher than 23306.3314.2555.9628 in VDI can process this registry key.
Location: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Teams
Name: disableAutoUpdate
Type: DWORD
Value: 1
Profile and cache location for new Teams Client
All the user settings and configurations are now stored in:
- C:\Users<username>\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\
- C:\Users<username>\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\Settings\settings.dat
- C:\Users<username>\AppData\Local\Publishers\8wekyb3d8bbwe\TeamsSharedConfig\app_switcher_settings.json
- C:\Users<username>\AppData\Local\Publishers\8wekyb3d8bbwe\TeamsSharedConfig\tma_settings.json
Make sure these folders and files are persisted for proper Teams functioning.
Note
It's critical that all the necessary directories and top folder structure under AppData\Local\Packages\MSTeams_8wekyb3d8bbwe are correctly set up as directories, not as files or reparse points, and roam with the user's profile:
AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\AC AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\AppData AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalState AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\RoamingState AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\Settings AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\SystemAppData AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\TempState
TeamsSharedConfig stores user configurations for the Teams app switcher toggle (and what should be the default app, the Classic or New Teams), and the Teams Meeting Add In for Outlook.
The folder "meeting-addin" under TeamsSharedConfig shouldn't be persisted, as this could cause issues with the default meeting coordinates in the meeting templates inserted into Outlook.
Important
Customers using FSLogix need to install hotfix 2.9.8784.63912 in order to guarantee proper integration with the new Teams client in VDI. The hotfix addresses the following issues:
- In non-persistent multiuser environments, the new Teams can become unregistered for some users after a new Teams update
- During user sign out, new Teams client user data/cache located in %LocalAppData%\Packages\MSTeams_8wekyb3d8bbwe\LocalCache was not saved in the FSLogix Profile or ODFC containers.
Note: Customers using Profile and ODFC or just ODFC containers, will still need to add the setting ‘IncludeTeams’ for the new Teams user data/cache to be preserved.
Note
Folder Redirection or Roaming User Profiles aren't supported with the new Teams client in VDI environments since they can't roam folders in AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams. Customers can continue to use Folder Redirection or Roaming User Profiles with a complementary product, such as FSLogix, Citrix Profile Manager, VMware, and DEM, that can roam the Appdata\Local folders above.
Folder exclusions
Disk storage usage
The new Teams app takes up about 50% less disk space than the classic version. To make it easier to distribute our client to Windows devices, we have added support for MSIX, which improves the dependability of installations and app updates, as well as reduces network bandwidth and disk space consumption. This packaging technology also shows the accurate disk space usage. Users may see larger disk usage than classic Teams in Windows settings, but the difference is mainly because the disk space related to Electron-based classic Teams is not fully and correctly shown.
Disk Footprint - Key folders and location
- App installer: C:\Program Files\WindowsApps\MSTeams_[version]_[arch]__8wekyb3d8bbwe Includes the installation package, supports the ability to reset the app, and allows single instancing.
- User and app data: C:\Users<alias>\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe This includes code (Javascript bundles), code cache, browser caches, databases for user data (like conversations which scales based on usage), and web storage (from domains hosted within Teams, such as Sharepoint, Viva learning, Apps, and so on).
The underlying folder structure is logically similar to Electron-based classic Teams. For non-persistent setups where storage footprint is a consideration, the following guidance applies:
Recommended for exclusion
| Folder | Folder path | Role | Exclusion impact |
|---|---|---|---|
| Logs | LocalCache\Microsoft\MSTeams\Logs LocalCache\Microsoft\MSTeams\PerfLog | Diagnostics, perf logs, and so on. | No impact. |
| WebStorage | LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\ WebStorage | Storage used and managed by the browser when accessing other web apps inside a web app using iframes. For example, loading Sharepoint, OneDrive and office apps within Teams. | Loading these apps again could be slower after clearing this cache. |
| GPU Cache | LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\ GPUCache | GPU cache. | No impact. |
Review tradeoff considerations, requiring evaluation and testing for these environments
| Folder | Folder path | Role | Exclusion impact |
|---|---|---|---|
| Service worker | LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\ Service Worker\CacheStorage LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\Code Cache | Code and caching of Web/JS Scripts for the app to run. | - Reduced performance to download and load scripts on every app launch - No offline access to app |
| IndexedDB | LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\IndexedDB | Holds app and user data and is the recommended way to cache data at scale in a web app to improve responsiveness. | - Significantly higher app launch times as data (such as chat or channel conversations) must be pulled down, along with network usage as data needing to be downloaded and cached every time. - The size of the data varies based on the user profile. - Users might see We’re setting things up for you in the launch splash-screen. |
| Cache | LocalCache\Microsoft\MSTeams\EBWebView\WV2Profile_tfw\Cache | Cache used and managed by the browser for the contents of all network calls that leave the app. Also known as Disk Cache. | For example, profile pictures in Teams are mostly cached in this storage by the browser. These will need to be downloaded again. |
Other than the folders in this section, we don't recommend excluding additional directories.
New Teams and Outlook integration
When the "Register the new Teams as the chat app for Microsoft 365" checkbox is selected under Settings > General > System, this lets the new Teams client integrate with all the Microsoft 365 apps that have instant message capabilities (presence, chat, VOIP, etc.).
For example, Outlook goes through the discovery process outlined here to integrate with the default IM client application: Integrating IM applications with Office
Note
If the new Teams is installed on a virtual machine where the classic Teams is not installed, you must make sure you are using new Teams version 23320.3021.2567.4799 or higher in order to guarantee proper integration with Outlook and presence.
Teams Meeting add-in
Additionally, the new Teams MSIX package bundles the Teams Meeting add-in (or TMA) MSI ("MicrosoftTeamsMeetingAddinInstaller.msi"). TMA lets you schedule a Teams meeting from Outlook.
For Security articles related to TMA integration with the Outlook client, learn more at Teams meeting add-in security when using your Outlook client.
All new Teams files that are installed on the computer are signed, so IT admins can use AppLocker / Code Integrity / Windows Defender Application Guard policies configured to enforce that.
- For New Teams per-user installations of TMA, the install folder is in AppData\Local\Microsoft\TeamsMeetingAddin
- Starting from new Teams version 24060.2623.2790.8046, the TMA per-user install folder is changed to AppData\Local\Microsoft\TeamsMeetingAdd-in (an additional '-')
- Installation logs for TMA MSI are stored here: AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs \tma_addin_msi.txt
Note
In Windows Server or Windows 10/11 Multiuser environments, installation of MicrosoftTeamsMeetingAddinInstaller.msi can fail with the error "Installation success or error status: 1625.".
This error is caused by GPOs affecting Windows Installer. This includes DisableUserInstalls, DisableMSI, or AppLocker policies based on Publisher rule conditions, or a RuleCollection for MSI installs. In this case you must create an exception such as:
- FilePathCondition Path="%PROGRAMFILES%\WINDOWSAPPS*\MICROSOFTTEAMSMEETINGADDININSTALLER.MSI"
Workaround: You can install the MSI that is located in the new Teams installation directory from an Admin Command prompt using:
msiexec.exe /i "C:\Program Files\WindowsApps\MSTeams_X.X.X.X_x64__8wekyb3d8bbwe\MicrosoftTeamsMeetingAddinInstaller.msi" ALLUSERS=1 /qn /norestart TARGETDIR="C:\Program Files (x86)\Microsoft\TeamsMeetingAdd-in\<version>\"
TARGETDIR must be kept consistent across installs so that the Teams Meeting Add-in MSI can easily detect and clean up older versions. If multiple directories are used, then the installation may not behave as expected.
X.X.X.X needs to be replaced by the New Teams version. Make sure there's a double underscore between the CPU architecture (x64) and the PublisherID (8wekyb3d8bbwe). The exact version number can be extracted by running this command in PowerShell:
Get-AppXPackage -Name "*msteams*" | Select-Object -ExpandProperty Versionversion must be replaced with the MSI file version, for example, 1.24.2203.0. The exact version number can be extracted by running this command in PowerShell:
PS C:\WINDOWS\system32> Get-AppLockerFileInformation -Path "C:\PROGRAM FILES\WINDOWSAPPS\MSTEAMS_24026.1000.2656.1710_X64__8WEKYB3D8BBWE\MICROSOFTTEAMSMEETINGADDININSTALLER.MSI" | Select -ExpandProperty Publisher | select BinaryVersion
BinaryVersion
1.24.2203.0
Example: The following is are examples of the final command:
msiexec.exe /i "C:\Program Files\WindowsApps\MSTeams_23320.3021.2567.4799_x64__8wekyb3d8bbwe\MicrosoftTeamsMeetingAddinInstaller.msi" ALLUSERS=1 /qn /norestart TARGETDIR="C:\Program Files (x86)\Microsoft\TeamsMeetingAdd-in\1.24.2203.0\"
If (-not ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] 'Administrator') ){
Write-Error "Need to run as administrator. Exiting.."
exit 1
}
# Get Version of currently installed new Teams Package
if (-not ($NewTeamsPackageVersion = (Get-AppxPackage -Name MSTeams).Version)) {
Write-Host "New Teams Package not found. Please install new Teams from https://aka.ms/GetTeams ."
exit 1
}
Write-Host "Found new Teams Version: $NewTeamsPackageVersion"
# Get Teams Meeting Addin Version
$TMAPath = "{0}\WINDOWSAPPS\MSTEAMS_{1}_X64__8WEKYB3D8BBWE\MICROSOFTTEAMSMEETINGADDININSTALLER.MSI" -f $env:programfiles,$NewTeamsPackageVersion
if (-not ($TMAVersion = (Get-AppLockerFileInformation -Path $TMAPath | Select-Object -ExpandProperty Publisher).BinaryVersion))
{
Write-Host "Teams Meeting Addin not found in $TMAPath."
exit 1
}
Write-Host "Found Teams Meeting Addin Version: $TMAVersion"
# Install parameters
$TargetDir = "{0}\Microsoft\TeamsMeetingAddin\{1}\" -f ${env:ProgramFiles(x86)},$TMAVersion
$params = '/i "{0}" TARGETDIR="{1}" /qn ALLUSERS=1' -f $TMAPath, $TargetDir
# Start the install process
write-host "executing msiexec.exe $params"
Start-Process msiexec.exe -ArgumentList $params
write-host "Please confirm install result in Windows Eventlog"
After installation, restart Outlook and verify TMA is loading. Logs are located on %localappdata%\Temp\Microsoft\Teams\meeting-addin.
For Teams Meeting add-in troubleshooting articles, learn more at: Resolve issues with Teams Meeting add-in for Outlook.
If classic Teams is removed and only new Teams is being installed, the Teams Meeting Add-in MSI could fail to create three registry keys under HKCU that prevent the Meeting Add In from loading properly.
These keys should be then deployed via additional sign in scripts or similar methods:
Note
These HKCU regkeys are not needed anymore if you're installing new Teams 24060.2623.2790.8046 or higher, as it bundles TeamsMeetingAddIn.msi version 1.0.24054.1, which has a fix for successful regkeys creation under HKCU.
Troubleshooting new Teams and Outlook integration
Symptoms
You see any of the following issues when you check the presence status for a user in Outlook:
- The presence indicator isn't visible.
- The displayed presence is incorrect.
- The presence status is Status unknown.
Troubleshooting steps
- Make sure new Teams is running. Then launch Outlook.
- Check the registry settings on your computer to verify that new Teams is registered as the default instant messaging (IM) app.
a. Start Registry Editor. b. Locate the following subkey:
- HKEY_CURRENT_USER\Software\IM Providers
c. Verify the following values:
- **Name:** DefaultIMApp
- **Type:** REG_SZ
- **Data:** MsTeams (If you see Teams, it means classic Teams is still the default IM app)
- Locate the following subkey:
- HKEY_CURRENT_USER\Software\IM Providers\MsTeams (Outlook monitors this registry key for value changes)
- Verify the following values:
-Name: UpAndRunning -Type: REG_DWORD -Data: 2 (0—Not running, 1—Starting, 2—Running)
- If the issues persist, contact Microsoft Support.
Control fallback mode in Teams
When users connect from an unsupported endpoint, the users are in fallback mode, in which Audio/Video isn't optimized. You can disable or enable fallback mode by setting one of the following registry DWORD values:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Teams\DisableFallback
HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\Teams\DisableFallback
- To disable fallback mode, set the value to 1.
- To enable audio only, set the value to 2.
- If the value isn't present or is set to 0 (zero), fallback mode is enabled.
- On Fallback, screen sharing functionality is supported with a different screen picker UI (similar to the experience a user would see on Teams for Web).
Multitenant and Multi-account in VDI
The new version of Teams in VDI allows you to sign in quickly and easily, and allowing you to switch between multiple accounts and organizations from the same Microsoft 365 cloud environment.
Note
Cross cloud guests and Cross cloud meetings are not supported on VDI. See Collaborate with guests from other Microsoft 365 cloud environments and Manage accounts and organizations in Microsoft Teams for more information.
If any of your accounts have guest access to other organizations, you don’t need to add them--they appear automatically. A guest is someone from outside an organization that a team owner invites to join the team, such as a partner or consultant. Guests have fewer capabilities than team members or team owners.
Learn more: Manage accounts and organizations in Microsoft Teams
Features currently not available and known issues in VDI with the new Teams
- Screen sharing from chat for Azure Virtual Desktops/Windows 365 (This issue is now fixed on RD Client 1.2.5105 and Redirector Service 1.50.2402.29001).
- Screen sharing from chat for Citrix when using Workspace app 2311 only.
- The app switcher toggle isn't shown in new Teams if the virtual machine has the machine-wide classic Teams installed (MSI with ALLUSERS=1). Note: This issue is fixed on new Teams version 23320.3021.2567.4799 or higher.
- msteams_autostart.exe "The parameter is incorrect": In non-persistent environments that use FSLogix (any version) or Citrix Profile Manager profile containers, when new Teams attempts to autostart or a user tries to launch Teams from the Start menu, it throws the error: "The parameter is incorrect." The frequency and reproducibility of the error varies depending on the environment and especially the antivirus software being used (SentinelOne, Palo Alto, Trend Micro, Bitdefender, CrowdStrike, and so on.) and exclusions in place.
- New Teams fails to launch for users logging into non-persistent virtual desktops, or the app is not visible in the Start Menu.
- Admins don't experience this issue - after installing new Teams on the golden image they can launch it successfully.
- After sealing the golden image and deploying it at scale (with provisioning tools like Citrix MCS/PVS or VMware Instant-Clones), users log into the virtual machines and click on the new Teams icon, but aren't able to launch the app. The issue is caused by a failed registration of the MSIX package at the user level with different profile management software (FSLogix, Citrix CPM, Ivanti UEM, and so on), even though the staging of the package was successful (the OS stored the package’s contents on the disk in the %ProgramFiles%\WindowsApps directory). This issue can be confirmed by running Get-AppxPackage -name MsTeams for the affected users. Running this code will return an empty output.
- If Get-AppxPackage -name MsTeams -allusers is now run from an elevated powershell command window, the output shows that Teams is registered (see line PackageFullName) and the Status is OK.
Note
Microsoft is working on a solution and plan to remove these limitations soon.
Enhancements in new Teams
Issues from classic Teams are now fixed in new Teams:
- Multitenant Multi-Account.
- Performance improvements in hardware resource consumptions.
- Channels 2.0.
- Multi-window is enabled by default, without prompting for a Restart.
- Sharing toolbar improvements (including pinning/unpinning).
VDI Feature comparison between classic Teams and new Teams
All the multimedia features that work on the classic Teams client are expected to work in the new Teams client. For specific feature matrix, check your VDI Provider website.
| Provider | Details |
|---|---|
| Azure Virtual Desktops and Windows 365 | Supported features for Microsoft Teams on Azure Virtual Desktop |
| Citrix | Optimization for Microsoft Teams |
| VMware | MS Teams Optimization Feature Compatibility Matrix for Horizon 7 and Horizon 8 Recent Releases. (86475) (vmware.com) |
New Teams for web in VDI
New Teams for Web isn't supported in VDI environments, so performance and reliability may be negatively impacted if used in VDI.
Features not supported in VDI
The following features aren't supported in either classic Teams or new Teams.
- QoS.
- 1080p.
- Custom Backgrounds uploaded by users.
- Teams Premium features (End to End Encryption, Watermark, Premium Events aren't optimized, Custom meeting backgrounds for organizations).
- Avatars.
- Gallery View 3x3 and 7x7.
- Noise Suppression (except for AVD/W365, where noise suppression is on by default, but confirmation isn't shown in Teams client UI. This is by design).
- Zoom In / Out.
- Location Based Routing.
- Media Bypass.
- HID (Citrix only).
- Share System Audio (Citrix and VMware).
- Broadcast and live event producer and presenter roles.
- Cross cloud anonymous join in Government Clouds (GCC, GCC High and DoD).
- Record video clip doesn't capture screen share.
- The call monitor (the small floating window after you minimize the main Teams window) doesn't display video or screen share.
- Teams calls drop on a local machine if a user launches a virtual desktop from that local machine and logs into Teams (AVD/W365 and VMware only).
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for