Use Microsoft Teams on Azure Virtual Desktop

Microsoft Teams on Azure Virtual Desktop supports chat and collaboration. With media optimizations, it also supports calling and meeting functionality. To learn more about how to use Microsoft Teams in Virtual Desktop Infrastructure (VDI) environments, see Teams for Virtualized Desktop Infrastructure.

With media optimization for Microsoft Teams, the Remote Desktop client handles audio and video locally for Teams calls and meetings by redirecting it to the local device. You can still use Microsoft Teams on Azure Virtual Desktop with other clients without optimized calling and meetings. Teams chat and collaboration features are supported on all platforms.

Prerequisites

Before you can use Microsoft Teams on Azure Virtual Desktop, you'll need to do these things:

Media optimization for Microsoft Teams is only available for the following two clients:

  • Windows Desktop client for Windows 10 or 11 machines, version 1.2.1026.0 or later.
  • macOS Remote Desktop client, version 10.7.7 or later.

For more information about which features Teams on Azure Virtual Desktop supports and minimum required client versions, see Supported features for Teams on Azure Virtual Desktop.

Prepare to install the Teams desktop app

This section will show you how to install the Teams desktop app on your Windows 10 or 11 Enterprise multi-session or Windows 10 or 11 Enterprise VM image. To learn more, check out Install or update the Teams desktop app on VDI.

Prepare your image for Teams

To enable media optimization for Teams, set the following registry key on the host VM:

  1. From the start menu, run Registry Editor as an administrator. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Teams. Create the Teams key if it doesn't already exist.

  2. Create the following value for the Teams key:

    Name Type Data/Value
    IsWVDEnvironment DWORD 1

Alternatively, you can create the registry entry by running the following commands from an elevated PowerShell session:

New-Item -Path "HKLM:\SOFTWARE\Microsoft\Teams" -Force
New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Teams" -Name IsWVDEnvironment -PropertyType DWORD -Value 1 -Force

Install the Remote Desktop WebRTC Redirector Service

The Remote Desktop WebRTC Redirector Service is required to run Teams on Azure Virtual Desktop. To install the service:

  1. Sign in to a session host as a local administrator.

  2. Download the Remote Desktop WebRTC Redirector Service installer.

  3. Open the file that you downloaded to start the setup process.

  4. Follow the prompts. Once it's completed, select Finish.

You can find more information about the latest version of the WebSocket service at What's new in the Remote Desktop WebRTC Redirector Service.

Install Teams on Azure Virtual Desktop

You can deploy the Teams desktop app using a per-machine or per-user installation. To install Teams on Azure Virtual Desktop:

  1. Download the Teams MSI package that matches your environment. We recommend using the 64-bit installer on a 64-bit operating system.

  2. Run one of the following commands to install the MSI to the host VM:

    • For per-machine installation, run this command:

      msiexec /i <path_to_msi> /l*v <install_logfile_name> ALLUSER=1 ALLUSERS=1
      

      This process installs Teams to the %ProgramFiles(x86)% folder on a 64-bit operating system and to the %ProgramFiles% folder on a 32-bit operating system. At this point, the golden image setup is complete. Installing Teams per-machine is required for non-persistent setups.

      During this process, you can set the ALLUSER=1 and the ALLUSERS=1 parameters. The following table lists the differences between these two parameters.

      Parameter Purpose
      ALLUSER=1 Used in virtual desktop infrastructure (VDI) environments to specify per-machine installation.
      ALLUSERS=1 Used in both non-VDI and VDI environments to make the Teams Machine-Wide Installer appear in Programs and Features under the Control Panel and in Apps & Features in Windows Settings. The installer lets all users with admin credentials uninstall Teams.

      When you install Teams with the MSI setting ALLUSER=1, automatic updates will be disabled. We recommend you make sure to update Teams at least once a month. To learn more about deploying the Teams desktop app, check out Deploy the Teams desktop app to the VM.

      Note

      We recommend you use per-machine installation for better centralized management for both pooled and personal host pool setups.

      Users and admins can't disable automatic launch for Teams during sign-in at this time.

    • For per-user installation, run the following command:

      msiexec /i <path_to_msi> /l*v <install_logfile_name> ALLUSERS=1
      

      This process installs Teams to the %AppData% user folder.

      Note

      Per-user installation only works on personal host pools. If your deployment uses pooled host pools, we recommend using per-machine installation instead.

Verify media optimizations loaded

After installing the WebSocket Service and the Teams desktop app, follow these steps to verify that Teams media optimizations loaded:

  1. Quit and restart the Teams application.

  2. Select your user profile image, then select About.

  3. Select Version.

    If media optimizations loaded, the banner will show you Azure Virtual Desktop Media optimized. If the banner shows you Azure Virtual Desktop Media not connected, quit the Teams app and try again.

  4. Select your user profile image, then select Settings.

    If media optimizations loaded, the audio devices and cameras available locally will be enumerated in the device menu. If the menu shows Remote audio, quit the Teams app and try again. If the devices still don't appear in the menu, check the Privacy settings on your local PC. Ensure the under Settings > Privacy > App permissions - Microphone the setting "Allow apps to access your microphone" is toggled On. Disconnect from the remote session, then reconnect and check the audio and video devices again. To join calls and meetings with video, you must also grant permission for apps to access your camera.

    If optimizations don't load, uninstall then reinstall Teams and check again.

Customize Remote Desktop Protocol properties for a host pool

Customizing a host pool's Remote Desktop Protocol (RDP) properties, such as multi-monitor experience or enabling microphone and audio redirection, lets you deliver an optimal experience for your users based on their needs.

Enabling device redirections isn't required when using Teams with media optimization. If you're using Teams without media optimization, set the following RDP properties to enable microphone and camera redirection:

  • audiocapturemode:i:1 enables audio capture from the local device and redirects audio applications in the remote session.
  • audiomode:i:0 plays audio on the local computer.
  • camerastoredirect:s:* redirects all cameras.

To learn more, check out Customize Remote Desktop Protocol properties for a host pool.

Next steps

See Supported features for Teams on Azure Virtual Desktop for more information about which features Teams on Azure Virtual Desktop supports and minimum required client versions.

Learn about known issues, limitations, and how to log issues at Troubleshoot Teams on Azure Virtual Desktop.

Learn about the latest version of the WebSocket Service at What's new in the WebSocket Service for Azure Virtual Desktop.