Product documentation
Profile Management
Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR 7.15
View PDF

Enable roaming for the new Microsoft Teams

August 29, 2024
Contributed by: 
C C

This article provides guidance on how to enable roaming for the new Microsoft Teams (version 2.1 or later) using Profile Management. The process varies depending on the installer type that you choose:

Install and configure using the per-machine installer

Requirement: Profile Management version 2402 or later.

As an administrator, follow these steps to create the machines:

  1. Install the new Microsoft Teams using the per-machine installer on the master image.

    For more information about the installation, see this Microsoft article.

  2. Install the Profile Management version 2402 or later on the master image.
  3. Create the machines using the master image.
  4. Configure required settings for Microsoft Teams roaming to take effect.

Install and configure using the per-user installer

Requirement: Profile Management version 2308 or later.

As an administrator, follow these steps to prepare the machines:

  1. Upgrade Profile Management to version 2308 or later.
  2. Verify that the profile roaming feature functions correctly for users.
  3. Enable the Enable UWP apps roaming policy. For more information, see Enable UWP app roaming.
  4. Configure required settings for Microsoft Teams roaming to take effect.

As a user who wants to use the new Microsoft Teams on multiple machines, you need to install the new Microsoft Teams only on one of those machines:

  1. Log on to a machine.

  2. Install the new Microsoft Teams using the per-user installer.

    Profile Management captures the installed Microsoft Teams and containerizes it. When you log on to a different machine, Profile Management automatically mounts the Microsoft Teams container to that machine.

Configure required settings

Both file-based and container-based profile solutions support roaming on the new Microsoft Teams. For the roaming to take effect, complete the following required settings accordingly:

Required settings for the file-based profile solution

Perform the following required settings for the Microsoft Teams roaming to take effect:

  1. Add the following folders to the Folders to mirror policy:

    • AppData\Roaming\Microsoft\Windows\Cookies
    • AppData\Local\Microsoft\Windows\INetCookies
    • AppData\Local\Microsoft\Windows\WebCache
    • AppData\Local\Microsoft\Vault
    • AppData\Local\Microsoft\Windows\Caches
    • AppData\Local\Packages

  2. If the Accelerate folder mirroring policy is disabled, follow Microsoft’s recommendations to exclude folders.

  3. If Accelerate folder mirroring policy enabled, configure the exclusion list with the following considerations:

    • Don’t follow Microsoft’s recommendations to exclude folders.

    • Ensure that no folders under AppData\Local\Packages\MSTeams_8wekyb3d8bbwe are in the exclusion list if AppData\Local\Packages or AppData\Local\Packages\MSTeams_8wekyb3d8bbwe is included in the Folders to mirror policy.

    • Check the Microsoft Teams troubleshooting guide - Step 3: Check whether you have the Read permission to access all the following directories in the AppData folder. Ensure that all folders in the list, except those folders under AppData\LocalLow, aren’t included in the exclusion list. (Note: You can decide whether to include AppData\LocalLow folders in the exclusion list).

  4. Add the following folders to the Profile streaming exclusion list - directories policy:
    • 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

  5. If the Start menu doesn’t display the new Microsoft Teams icon (especially on Windows Server 2019 or 2022 and Windows 10), configure the following settings:

    • For Windows Server 2022 and Windows 10, add the following path to the exclusion list:

      AppData\Local\Packages\Microsoft.Windows.StartMenuExperienceHost_cw5n1h2txyewy\TempState

    • For Windows Server 2019, add the following path to the exclusion list:

      AppData\Local\Packages\Microsoft.Windows.ShellExperienceHost_cw5n1h2txyewy\TempState

    • Set the following registry key to 1 (DWORD):

      HKCU\Software\Microsoft\Windows\CurrentVersion\ImmersiveShell\StateStore\ResetCache

  6. If the VDA version is earlier than 2402, deploy the following registry key to optimize the new Microsoft Teams client. If this registry key is missing, the new Microsoft Teams client operates in non-optimized mode (server-side rendering).

    • Location: HKLM\SOFTWARE\WOW6432Node\Citrix\WebSocketService
    • Key (REG_Multi_SZ): ProcessWhitelist
    • Value: msedgewebview2.exe

Required settings for the container-based profile solution

Configure the following required settings for the Microsoft Teams roaming to take effect:

  1. If the Enable local caching for profile containers policy is disabled, configure the exclusion list with the following considerations:

    • Don’t follow Microsoft’s recommendations to exclude folders. Ensure that no folders under AppData\Local\Packages\MSTeams_8wekyb3d8bbwe are in the container exclusion list.

    • Check the Microsoft Teams troubleshooting guide - Step 3: Check whether you have the Read permission to access all the following directories in the AppData folder. Ensure that all folders in the list, except those under AppData\LocalLow, aren’t included in the container exclusion list. (Note: You can decide whether to include AppData\LocalLow folders in the container exclusion list).

  2. If the Enable local caching for profile containers policy is enabled, follow these steps:

    1. Follow Microsoft’s recommendations to exclude folders.

    2. Add the following folders to the Folders to mirror policy:

      • AppData\Roaming\Microsoft\Windows\Cookies
      • AppData\Local\Microsoft\Windows\INetCookies
      • AppData\Local\Microsoft\Windows\WebCache
      • AppData\Local\Microsoft\Vault
      • AppData\Local\Microsoft\Windows\Caches
      • AppData\Local\Packages

  3. If the Start menu doesn’t display the new Microsoft Teams icon (especially on Windows Server 2019 or 2022 and Windows 10), configure the following settings:

    • For Windows Server 2022 and Windows 10, add the following path to the exclusion list:

      AppData\Local\Packages\Microsoft.Windows.StartMenuExperienceHost_cw5n1h2txyewy\TempState

    • For Windows Server 2019, add the following path to the exclusion list:

      AppData\Local\Packages\Microsoft.Windows.ShellExperienceHost_cw5n1h2txyewy\TempState

    • Set the following registry key to 1 (DWORD):

      HKCU\Software\Microsoft\Windows\CurrentVersion\ImmersiveShell\StateStore\ResetCache

  4. If the VDA version is earlier than 2402, we recommend deploying the following registry key to optimize the new Microsoft Teams client. If this registry key is missing, the new Microsoft Teams client operates in non-optimized mode (server-side rendering).

    • Location: HKLM\SOFTWARE\WOW6432Node\Citrix\WebSocketService
    • Key (REG_Multi_SZ): ProcessWhitelist
    • Value: msedgewebview2.exe
Enable roaming for the new Microsoft Teams
August 29, 2024
Contributed by: 
C C
August 29, 2024
Contributed by: 
C C

In this article

Site feedback | Your privacy choices footer linkYour Privacy Choices | Privacy and legal terms | Cookie preferences | Consent settings | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.