Partager via

Nouvelle solution VDI pour Teams

  • Article
  • S’applique à:
    Microsoft Teams

La nouvelle solution VDI pour Teams est une nouvelle architecture permettant d’optimiser la livraison de charges de travail multimédias dans les bureaux virtuels.

Important

Pour participer à la préversion publique, les administrateurs doivent déplacer les utilisateurs vers le canal de préversion publique, comme décrit dans cet article.

Composants

Composant Rôle Mettre à jour Taille Remarques
Nouveau vdiBridge Teams Module de canal virtuel côté serveur. Nouvelle version avec chaque nouvelle version de Teams. Fourni avec de nouveaux Teams.
Canal virtuel personnalisé (VC) Vc personnalisé appartenant à Microsoft Teams. API stable : aucune mise à jour n’est prévue. Consultez la liste verte du canal virtuel de stratégie Citrix Studio.
Plug-in DLL VC côté client. Responsable également du téléchargement slimCore et du nettoyage. Peu fréquent (idéalement aucune mise à jour). Environ 200 Ko. Fourni avec rd client 1.2.5405.0 ou Windows App 1.3.252 ou version ultérieure. Citrix CWA 2402 ou version ultérieure peut extraire et installer le plug-in.
SlimCore Moteur multimédia (spécifique au système d’exploitation, et non au fournisseur VDI). Mise à jour automatique vers une nouvelle version avec chaque nouvelle version de Teams. Environ 50 Mo. Package MSIX hébergé sur le CDN public de Microsoft

Configuration système requise

Configuration requise Version minimale
Nouveau Teams 24124.2315.2911.3357 (pour Azure Virtual Desktop/Windows 365)
24165.1410.2974.6689 (pour Citrix)
Azure Virtual Desktop/Windows 365 Application Windows : 1.3.252
Client Bureau à distance : 1.2.5405.0
Citrix VDA : application Citrix Workspace 2203 LTSR CU3 ou 2305 CR
: 2203 LTSR (tout cu), 2402 LTSR ou 2302 CR
Point de terminaison Windows 10 1809 (condition minimale SlimCore)
Les objets de stratégie de groupe ne doivent pas bloquer les installations MSIX (voir Étape 3 : Préproduction et inscription slimCore MSIX sur le point de terminaison)
Processeur minimal : Intel Celeron (ou équivalent) à 1,10 GHz, 4 cœurs, RAM minimale : 4 Go

Optimisation avec une nouvelle solution VDI pour Teams

Étape 1 : Confirmer les prérequis

  1. Vérifiez que vous disposez de la nouvelle version 24124.2311.2896.3219 ou ultérieure (pour Azure Virtual Desktop/Windows 365) et de la version 24165.1410.2974.6689 ou ultérieure pour Citrix.
  2. Activez la nouvelle stratégie Teamssi nécessaire pour un groupe d’utilisateurs spécifique (elle est activée par défaut au niveau global de l’organisation).
  3. Pour Citrix, vous devez configurer la liste verte des canaux virtuels , comme décrit dans la section Liste verte des canaux virtuels Citrix de cet article.

Étape 2 : installation du plug-in sur le point de terminaison

  1. Pour Azure Virtual Desktop et Windows 365, MsTeamsPluginAvd.dll est fourni avec le client Bureau à distance pour Windows 1.2.5405.0 ou avec l’application Windows App Store 1.3.252 ou ultérieure.
  • Le plug-in se trouve à l’emplacement du dossier où le client Bureau à distance est installé. Il s’agit de AppData\Local\Apps\Remote Desktop ou de C :\Program Files (x86), selon le mode dans lequel il a été installé.
  • Pour l’application Windows App Store , étant donné qu’elle est basée sur MSIX, elle se trouve dans C :\Program Files\WindowsApps. L’accès à ce dossier est limité.
  1. Pour Citrix CWA 2402 ou version ultérieure, MsTeamsPluginCitrix.dll pouvez être installé :
  • Utilisation de l’interface utilisateur lors de l’installation de CWA : dans la page Modules complémentaires, cochez la case Installer le plug-in VDI Microsoft Teams , puis sélectionnez Installer. Acceptez le contrat utilisateur qui s’affiche et poursuivez l’installation de l’application Citrix Workspace.

Remarque

L’application Citrix Workspace 2402 présente uniquement l’interface utilisateur d’installation du plug-in lors d’une nouvelle installation. Pour que les mises à niveau sur place présentent également cette option, l’application Citrix Workspace 2405 ou ultérieure est requise.

  • Via la ligne de commande ou des scripts pour les appareils gérés à l’aide de : C:\>CitrixWorkspaceApp.exe installMSTeamsPlugin
  • Les administrateurs peuvent également installer le plug-in manuellement sur n’importe quelle CWA prise en charge existante (voir Configuration système requise) à l’aide d’outils tels que SCCM (utiliser le type de déploiement du package d’application Windows) ou Intune (utiliser l’application métier). Les administrateurs peuvent utiliser msiexec avec les indicateurs appropriés, comme indiqué dans cette documentation.

Important

Vous trouverez le lien de téléchargement MSI du plug-in pour les clients Citrix ici.

Le msi du plug-in détecte automatiquement le dossier d’installation CWA et place MsTeamsPluginCitrix.dll à cet emplacement :

Type d’utilisateur Dossier d’installation Type d’installation
Administrateur 64 bits : C :\Program Files (x86)\Citrix\ICA Client
32 bits : C :\Program Files\Citrix\ICA Client		 Installation par système
  • Les plug-ins ne peuvent pas être rétrogradés, mais uniquement mis à niveau ou réinstallés (réparés).
  • L’installation par utilisateur de CWA n’est pas prise en charge.
  • Si aucune CWA n’est trouvée sur le point de terminaison, l’installation est arrêtée.

Étape 3 : Mise en lots et inscription slimCore MSIX sur le point de terminaison

Le plug-in exécute cette étape en mode silencieux, sans intervention de l’utilisateur ou de l’administrateur. La préproduction et l’inscription s’appuient sur le service ARS (App Readiness Service) sur le point de terminaison. Il est possible que l’installation du package MSIX soit bloquée par des clés de Registre définies par une stratégie de groupe ou un outil tiers. Pour obtenir la liste complète des clés de Registre applicables, consultez Fonctionnement de la stratégie de groupe avec les applications empaquetées - MSIX.

Les clés de Registre suivantes peuvent bloquer l’installation du nouveau package MSIX du moteur multimédia :

Important

Si AllowAllTrustedApps est désactivé, l’installation du nouveau moteur multimédia (MSIX) échoue. Ce problème a été résolu dans la mise à jour cumulative d’octobre de Windows KB5031455 :

Si cette mise à jour facultative d’octobre n’est pas disponible pour votre build de système d’exploitation, la mise à jour de sécurité de novembre inclut également le correctif.

Ces trois clés de Registre se trouvent à l’un des emplacements suivants sur l’appareil de l’utilisateur :

  • HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock
  • HKLM\SOFTWARE\Policies\Microsoft\Windows\Appx

Certaines stratégies peuvent modifier ces clés de Registre et bloquer l’installation des applications dans votre organisation, car les administrateurs définissent une stratégie restrictive. Voici quelques-unes des stratégies d’objet de stratégie de groupe connues qui pourraient empêcher l’installation :

  • Empêcher les utilisateurs non administrateurs d’installer des applications Windows empaquetées.
  • Autoriser l’installation de toutes les applications approuvées (désactivée).

Remarque

AppLocker ou Windows Defender Application Control peut également empêcher l’installation du package MSIX.

Important

Assurez-vous qu’il n’existe aucune configuration ou stratégie bloquante, ou ajoutez une exception pour les packages SlimCore MSIX dans Stratégie de sécurité locale -> Stratégies de contrôle d’application -> AppLocker.

Vérification que le point de terminaison est optimisé

Une fois que vous avez satisfait à toutes les exigences minimales, le premier lancement de Teams est toujours en mode optimisé WebRTC par défaut.

Important

Pour les expériences de première exécution, deux redémarrages d’application sont nécessaires pour obtenir la nouvelle optimisation.

Vous pouvez vérifier dans le client Teams que vous êtes optimisé avec la nouvelle architecture en accédant aux points de suspension (trois points...) dans la barre supérieure, puis en sélectionnant Paramètres > à propos de. Les versions de Teams et du client y sont répertoriées.

Le plug-in (MsTeamsPluginAvd.dll ou MsTeamsPluginCitrix.dll) est responsable du téléchargement final du moteur multimédia, et SlimCore, qui est un package MSIX. Il s’installe en mode silencieux sans privilèges d’administrateur ou redémarre dans (par exemple, le chemin exact varie) :

C:\Program Files\WindowsApps\Microsoft.Teams.SlimCoreVdi.win-x64.2024.15_2024.15.1.5_x64__8wekyb3d8bbwe

Le client Bureau à distance télécharge le package SlimCore x64 ou x86, et Citrix CWA télécharge un package x86. Ce dossier étant verrouillé, les utilisateurs n’y ont pas accès. Les administrateurs peuvent en prendre possession en modifiant les listes de contrôle d’accès, bien que cette action ne soit pas recommandée. Utilisez plutôt PowerShell pour répertorier les applications MSIX dans le point de terminaison :

PowerShellCopy

Get-AppxPackage Microsoft.Teams.SlimCore*

Important

Microsoft stocke jusqu’à dix versions de SlimCoreVdi à des fins de compatibilité, et dans le cas où l’utilisateur accède à différents environnements VDI (par exemple, persistant, où les nouvelles mises à jour automatiques Teams se mettent à jour automatiquement et non persistants, où les nouvelles mises à jour automatiques Teams sont désactivées).

Si vous êtes optimisé, vous pouvez voir MsTeamsVdi.exe s’exécuter sur votre point de terminaison pour Azure Virtual Desktop/W365 ou Citrix.

Si vous activez le volet inférieur et basculez vers l’onglet DLL, vous pouvez également voir le plug-in en cours de chargement. Cette action est une étape de dépannage utile si vous n’obtenez pas la nouvelle optimisation.

Itinérance de session et reconnexions

Les nouveaux teams chargent WebRTC ou SlimCore au moment du lancement. Si les sessions de bureau virtuel sont déconnectées (non déconnectées, Teams reste en cours d’exécution sur la machine virtuelle), les nouvelles équipes ne peuvent pas changer de pile d’optimisation, sauf si elles sont redémarrées. Par conséquent, les utilisateurs peuvent être en mode de secours (non optimisé) s’ils se déplacent entre différents appareils qui ne prennent pas en charge la nouvelle architecture d’optimisation (par exemple, un appareil MAC utilisé en BYOD pendant qu’il travaille à domicile et un client léger géré par l’entreprise au bureau).

Options de reconnexion L’optimisation actuelle est WebRTC L’optimisation actuelle est SlimCore
Reconnexion à partir d’un point de terminaison sans MsTeamsPlugin Optimisation classique de WebRTC Secours (SlimCore local)
Reconnexion à partir d’un point de terminaison avec MsTeamsPlugin Optimisation classique de WebRTC Nouvelle optimisation basée sur SlimCore

Considérations relatives à la mise en réseau

Remarque

MsTeamsVdi.exe est le processus qui établit toutes les connexions réseau TCP/UDP aux relais/serveurs de conférence Teams ou à d’autres homologues.

Le manifeste MSIX SlimCore ajoute les règles suivantes au pare-feu : <Rule Direction="in" IPProtocol="TCP" Profile="all" /><Rule Direction="in" IPProtocol="UDP" Profile="all" />

Assurez-vous que l’appareil de l’utilisateur dispose d’une connectivité réseau (UDP et TCP) aux ID de point de terminaison 11, 12, 47 et 127 décrits dans URL et plages d’adresses IP Microsoft 365.

ID Catégorie ER Adresses Ports Remarques
11 Optimiser les besoins Oui 13.107.64.0/18, 52.112.0.0/14, 52.122.0.0/15, 2603:1063::/38 UDP : 3478, 3479, 3480, 3481 Processeurs multimédias et relais de transport 3478 (STUN), 347 (audio), 3480 (vidéo), 3481 (partage d’écran)
12 Autoriser obligatoire Oui *.lync.com, *.teams.microsoft.com, teams.microsoft.com 13.107.64.0/18, 52.112.0.0/14, 52.122.0.0/15, 52.238.119.141/32, 52.244.160.207/32, 2603:1027 ::/48, 2603:1037 ::/48, 2603:1047 ::/48, 2603:1057 ::/48, 2603:1063 ::/38, 2620:1ec :6 ::/48, 2620:1ec :40 ::/42 TCP : 443, 80
47 Valeur par défaut requise Non *.office.net TCP : 443, 80 Utilisé pour les téléchargements SlimCore et les effets d’arrière-plan
127 Valeur par défaut requise Non *.skype.com TCP : 443, 80

Architecture réseau

Architecture réseau de Teams VDI 2.

Procédure pas à pas de l’architecture dans le diagramme :

  1. Démarrez de nouvelles équipes.
  2. Le client Teams s’authentifie auprès des services Teams. Les stratégies de locataire sont envoyées au client Teams et les configurations pertinentes sont relayées à l’application.
  3. Teams détecte qu’il s’exécute dans un environnement de bureau virtuel et instancie le service vdibridge interne.
  4. Teams ouvre un canal virtuel sécurisé sur le serveur.
  5. Le protocole RDP ou HDX transmet la requête à l’application cliente bureau à distance ou à l’application Citrix Workspace qui a précédemment chargé MsTeamsPlugin (composant de canal virtuel côté client).
  6. L’application Client Bureau à distance ou Espace de travail Citrix génère un nouveau processus appelé MsTeamsVdi.exe, qui est le nouveau moteur multimédia (SlimCore) utilisé pour la nouvelle optimisation.
  7. Le moteur multimédia SlimCore (sur le client) et msteams.exe (sur le bureau virtuel) ont désormais un canal bidirectionnel et peuvent commencer à traiter les demandes multimédias.

Appels utilisateur

  1. L’homologue A clique sur le bouton d’appel. MsTeamsVdi.exe communique avec les services Microsoft Teams dans Azure, en établissant un chemin de signalisation de bout en bout avec l’homologue B. MsTeamsVdi.exe collecte une série de paramètres d’appel pris en charge (codecs, résolutions, etc., ce que l’on appelle une offre SDP (Session Description Protocol). Ces paramètres d’appel sont ensuite relayés à l’aide du chemin de signalisation vers les services Microsoft Teams dans Azure et à partir de là vers l’autre homologue.
  2. L’offre/réponse SDP (négociation à passe unique) s’effectue via le canal de signalisation, et les vérifications de connectivité ICE (traversée NAT et pare-feu à l’aide de demandes de liaison STUN) se terminent. Ensuite, le média SRTP (Secure Real-Time Transport Protocol) circule directement entre MsTeamsVdi.exe et l’autre homologue (ou les relais de transport Teams ou les serveurs de conférence).

Les blocs IP pour la signalisation, les médias, les effets d’arrière-plan et d’autres options sont décrits dans cet article.

Types de trafic gérés par SlimCore sur le point de terminaison

  1. La connectivité des flux multimédias Teams est implémentée à l’aide de l’IETF Interactive Connectivity Establishment (ICE) standard pour les procédures STUN et TURN.
  2. Média en temps réel. Données encapsulées dans le protocole RTP (Real-time Transport Protocol) qui prend en charge les charges de travail audio, vidéo et de partage d’écran. En général, le trafic multimédia est très sensible à la latence. Ce trafic doit prendre le chemin le plus direct possible et utiliser UDP et TCP comme protocole de couche de transport, qui est le meilleur transport pour les médias interactifs en temps réel du point de vue de la qualité.
  • En dernier recours, le média peut utiliser TCP/IP et être également tunnelisé dans le protocole HTTP, mais cela n’est pas recommandé en raison d’implications de mauvaise qualité.
  • Le flux RTP est sécurisé à l’aide de SRTP, dans lequel seule la charge utile est chiffrée.
  1. Signalisation. Lien de communication entre le point de terminaison et les serveurs Teams, ou d’autres clients, utilisé pour contrôler les activités (par exemple, lorsqu’un appel est lancé). La plupart du trafic de signalisation utilise UDP 3478 avec secours vers HTTPS, bien que dans certains scénarios (par exemple, la connexion entre Microsoft 365 et un contrôleur de bordure de session) il utilise le protocole SIP. Il est important de comprendre que ce trafic est beaucoup moins sensible à la latence, mais qu’il peut entraîner des interruptions de service ou des délais d’expiration des appels si la latence entre les points de terminaison dépasse plusieurs secondes.

Consommation de bande passante

Teams est conçu pour offrir la meilleure expérience audio, vidéo et de partage de contenu, quelles que soient vos conditions réseau. Lorsque la bande passante est insuffisante, Teams donne la priorité à la qualité audio par rapport à la qualité vidéo. Lorsque la bande passante n’est pas limitée, Teams optimise la qualité des médias, y compris l’audio haute fidélité, la résolution vidéo jusqu’à 1080p et jusqu’à 30 images par seconde (images par seconde) pour la vidéo et le contenu. Pour en savoir plus, consultez Exigences en matière de bande passante

Qualité des services (QoS)

Implémentez des paramètres QoS pour les points de terminaison et les appareils réseau et déterminez comment vous souhaitez gérer le trafic multimédia pour les appels et les réunions.

  • En tant que prérequis, activez la Qualité de service globalement dans le Centre d’administration Teams. Consultez Configurer qoS dans le centre d’administration Teams pour plus d’informations sur l’activation des marqueurs d’insertion de qualité de service (QoS) pour les paramètres de trafic multimédia en temps réel .

    Plages de ports initiales recommandées :

    Type de trafic média Plage de port source du client Protocole Valeur DSCP Classe DSCP
    Audio 50,000 - 50,019 TCP/UDP 46 Acheminement accéléré (EF)
    Vidéo 50,020 - 50,039 TCP/UDP 34 Acheminement assuré (AF41)
    Partage d’application ou d’écran 50 040 = 50 059 TCP/UDP 18 Acheminement assuré (AF41)

  • Pour plus d’informations sur la configuration des marquages DSCP pour les points de terminaison Windows, consultez Implémenter QoS dans les clients Teams.

    Remarque

    Tout marquage basé sur un point de terminaison doit être appliqué à MsTeamsVdi.exe, le processus qui gère tous les déchargements multimédias sur l’appareil de l’utilisateur.

  • Pour plus d’informations sur l’implémentation de QoS pour les routeurs, consultez la documentation de votre fabricant.

  • La définition de qoS sur les appareils réseau peut inclure tout ou partie des éléments suivants :

    • à l’aide de listes de contrôle d’accès (ACL) basées sur les ports
    • définition des files d’attente QoS
    • définition de marquages DSCP

Important

Nous vous recommandons d’implémenter ces stratégies QoS à l’aide des ports sources du point de terminaison et d’une adresse IP source et de destination « any ». Cela intercepte le trafic multimédia entrant et sortant sur le réseau interne.

  1. Réseau VPN. Il n’est pas recommandé pour le trafic multimédia.
  2. Modélisateurs de paquets. Tout type de renifleur de paquets, d’inspection des paquets, de proxys ou de modélisateur de paquets n’est pas recommandé pour le trafic multimédia Teams et peut dégrader considérablement la qualité.

Stratégie Microsoft Teams PowerShell pour l’optimisation

Les applets de commande CsTeamsVdiPolicy permettaient aux administrateurs de contrôler le type de réunions que les utilisateurs peuvent créer ou les fonctionnalités auxquelles ils peuvent accéder lors d’une réunion en particulier dans un environnement VDI, où l’optimisation WebRTC a été désactivée à l’aide du moteur de stratégie du partenaire VDI (Citrix Studio, modèle VMware HTML5 ADMX ou cette clé de Registre pour AVD et Windows 365).

Les configurations de stratégie par défaut sont les suivantes :

  • DisableCallsAndMeetings : False
  • DisableAudioVideoInCallsAndMeetings : False

Cette stratégie est maintenant développée avec un argument supplémentaire comme seul point de configuration pour contrôler si un utilisateur peut obtenir le nouveau mode d’optimisation basé sur SlimCore ou non (en d’autres termes, les moteurs de stratégie du partenaire VDI ne contrôlent pas le nouveau mode d’optimisation) :

  • VDI2Optimization : Activé (valeur par défaut)
Nom Définition Exemple Remarques
New-CsTeamsVdiPolicy Permet aux administrateurs de définir de nouvelles stratégies VDI qui peuvent être attribuées aux utilisateurs pour contrôler les fonctionnalités Teams liées aux réunions sur un environnement VDI. PS C:\> New-CsTeamsVdiPolicy -Identity RestrictedUserPolicy -VDI2Optimization "Disabled" La commande présentée ici utilise l’applet de commande New-CsTeamsVdiPolicy pour créer une stratégie VDI avec l’identité RestrictedUserPolicy. Cette stratégie utilise toutes les valeurs par défaut d’une stratégie VDI, sauf une : VDI2Optimization. Dans cet exemple, les utilisateurs avec cette stratégie ne peuvent pas être optimisés avec SlimCore.
Grant-CsTeamsVdiPolicy Permet aux administrateurs d’affecter une stratégie VDI Teams à une étendue par utilisateur pour contrôler le type de réunions qu’un utilisateur peut créer, les fonctionnalités auxquelles il peut accéder sur un environnement VDI non optimisé et si un utilisateur peut être optimisé avec le nouveau mode d’optimisation basé sur SlimCore. PS C:\> Grant-CsTeamsVdiPolicy -identity "Ken Myer" -PolicyName RestrictedUserPolicy Dans cet exemple, un utilisateur avec l’identité « Ken Myer » se voit attribuer restrictedUserPolicy.
Set-CsTeamsVdiPolicy Permet aux administrateurs de mettre à jour les stratégies VDI existantes. PS C:\> Set-CsTeamsVdiPolicy -Identity RestrictedUserPolicy -VDI2Optimization "Disabled" La commande présentée ici utilise l’applet de commande Set-CsTeamsVdiPolicy pour mettre à jour une stratégie VDI existante avec Identity RestrictedUserPolicy. Cette stratégie utilise toutes les valeurs existantes, sauf une : VDI2Optimization ; Dans cet exemple, les utilisateurs avec cette stratégie ne peuvent pas être optimisés avec SlimCore.
Remove-CsTeamsVdiPolicy Permet aux administrateurs de supprimer une stratégie VDI Teams créée précédemment. Les utilisateurs sans stratégie explicitement affectée reviennent à la stratégie par défaut dans l’organisation. PS C:\> Remove-CsTeamsMeetingPolicy -Identity RestrictedUserPolicy Dans l’exemple ci-dessus, la commande supprime la stratégie utilisateur restreinte de la liste des stratégies de l’organisation et supprime toutes les affectations de cette stratégie aux utilisateurs auxquels la stratégie est affectée.
Get-CsTeamsVdiPolicy Permet aux administrateurs de récupérer des informations sur toutes les stratégies VDI qui ont été configurées dans l’organisation. PS C:\> Get-CsTeamsVdiPolicy -Identity SalesPolicy Dans cet exemple, Get-CsTeamsVdiPolicy est utilisé pour retourner la stratégie de réunion par utilisateur qui a une stratégie De ventes d’identité. Étant donné que les identités sont uniques, cette commande ne retourne pas plusieurs éléments.

Liste des fonctionnalités avec la nouvelle optimisation

Fonctionnalité Disponible
1080p Oui
Accélération matérielle sur le point de terminaison Oui
Vue Galerie 3x3 et 7x7 Oui
Qualité de service Oui
Suppression du bruit Oui
CACHÉ Oui
Mode présentateur Oui
Teams Premium Oui
(En attente : filigrane, mairies, décorer mon arrière-plan)
Effet d’arrière-plan chargé par l’utilisateur Bientôt disponible
Zoom +/- Bientôt disponible

Profil utilisateur SlimCore sur le point de terminaison

La nouvelle solution pour VDI stocke des données spécifiques à l’utilisateur sur le point de terminaison aux emplacements suivants, en fonction de votre fournisseur :

  • C:\users\<user>\AppData\Roaming\Microsoft\TeamsVDI\avd-default-<cloudname>\
  • C:\users\<user>\AppData\Roaming\Microsoft\TeamsVDI\citrix-default-<cloudname>\

Important

Les clients légers verrouillés doivent autoriser ces emplacements à être en lecture/écriture, sinon la nouvelle optimisation risque d’échouer.

Les journaux, les configurations et les modèles IA ou ML (utilisés pour la suppression du bruit, l’estimation de la bande passante, etc.) sont enregistrés à cet emplacement. Si ces dossiers sont vidés après la déconnexion d’un utilisateur (par exemple, des clients légers verrouillés sans profils itinérants), MsTeamsVdi.exe les recréeront et téléchargeront la configuration spécifique à l’utilisateur (environ 6 Mo de données).

Processus d’installation et de mise à niveau SlimCore dans les environnements client légers verrouillés (facultatif)

Par défaut, MsTeamsPlugin télécharge et installe automatiquement la version appropriée du moteur multimédia SlimCore sans intervention de l’utilisateur ou de l’administrateur. Toutefois, les clients qui utilisent des environnements réseau restreints dans la filiale peuvent opter pour un autre processus de distribution SlimCore, sans que le point de terminaison puisse récupérer des packages SlimCore à l’aide de https à partir du CDN public de Microsoft.

Important

Si vous devez choisir cette méthode, vous devez garantir que :

  1. La mise à jour automatique de Teams est désactivée dans le bureau virtuel.
  2. Les packages SlimCore sont préprovisionnés sur le stockage local ou le partage réseau du point de terminaison avant de mettre à niveau les nouveaux teams dans le bureau virtuel. Toute version plus récente de Teams demande une nouvelle version correspondante de SlimCore et si le plug-in ne peut pas la trouver, l’utilisateur sera en mode de secours (rendu côté serveur).

Cela est dû au fait que les nouvelles versions de Teams et SlimCore doivent correspondre.

Étapes de configuration

  1. Sur le point de terminaison de l’utilisateur (client léger/client fat), vous devez créer la clé de registre suivante :
  • Emplacement de Citrix : HKLM\SOFTWARE\WOW6432Node\Microsoft\Teams\MsTeamsPlugin
  • Emplacement d’Azure Virtual Desktop/W365 : HKLM\SOFTWARE\Microsoft\Teams\MsTeamsPlugin
  • Nom : MsixUrlBase
  • Type : REG_SZ
  • Données : chemin UNC du stockage local ou du stockage réseau, tel que file://C:/Temp ou file://ComputerName/SharedFolder. La clé d’inscription définit l’URL de base.
  1. En outre, les administrateurs doivent télécharger la version exacte du package MSIX SlimCore à partir du CDN de Microsoft qui correspond à la nouvelle version de Teams que vous envisagez de déployer à l’avenir.

Important

Le package MSIX doit correspondre à l’architecture ou au nombre de bits de l’application Citrix Workspace (x86 uniquement) ou des clients Bureau à distance ou Application Windows : Microsoft.Teams.SlimCoreVdi.<platform>-<architecture>.msix.

  1. Placez le MSIX dans un dossier spécifique avec la version dans l’emplacement spécifié dans la clé de Registre pour conserver la structure. Par exemple, C :\Temp\2024.4.1.9\Microsoft.Teams.SlimCoreVdi.win-x86.msix ou //ComputerName/SharedFolder/2024.4.1.9/.

Remarque

Si le plug-in ne trouve pas de package SlimCore MSIX dans le stockage local ou réseau, il tente automatiquement de le télécharger à partir du CDN public Microsoft comme solution de secours.

Problèmes connus

  • Azure RemoteApps et Citrix Published Apps ne sont pas pris en charge pour l’instant.
  • Les appels sont supprimés sur Teams en cours d’exécution sur l’ordinateur local sur lequel un périphérique HID est connecté si un utilisateur lance un bureau virtuel à partir de cette même machine locale et se connecte à Teams.
  • Si vous essayez de participer à une réunion juste après le lancement de Teams (par exemple, en cliquant sur un lien profond Teams dans Outlook sans que de nouveaux Teams ne s’exécutent), l’appel peut être lancé.

Liste verte des canaux virtuels Citrix

Le paramètre de stratégie De liste verte des canaux virtuels dans CVAD permet d’utiliser une liste verte qui spécifie les canaux virtuels qui peuvent être ouverts dans une session ICA. Lorsqu’il est activé, tous les processus à l’exception des canaux virtuels intégrés Citrix doivent être indiqués. Par conséquent, davantage d’entrées sont requises pour que le nouveau client Teams puisse se connecter au plug-in côté client (MsTeamsPluginCitrix.dll).

Avec Citrix Virtual Apps and Desktops 2203 ou version ultérieure, la liste verte des canaux virtuels est activée par défaut. Ces paramètres par défaut refusent l’accès aux nouveaux canaux virtuels personnalisés Teams, car la liste verte n’inclut pas le nouveau nom du processus principal Teams.

Le nouveau client Teams nécessite trois canaux virtuels personnalisés pour fonctionner : MSTEAMS, MSTEAM1 et MSTEAM2. Ces canaux sont accessibles par ms-teams.exe. Vous pouvez utiliser des caractères génériques pour autoriser le ms-teams.exe exécutable et le canal virtuel personnalisé :

  • MSTEAMS,C :\Program Files\WindowsApps\MSTeams*8wekyb3d8bbwe\ms-teams.exe
  • MSTEAM1,C :\Program Files\WindowsApps\MSTeams*8wekyb3d8bbwe\ms-teams.exe
  • MSTEAM2,C :\Program Files\WindowsApps\MSTeams*8wekyb3d8bbwe\ms-teams.exe
  1. La prise en charge des caractères génériques est disponible dans :
  • VDA 2206 CR.
  • VDA 2203 LTSR à partir de CU2.
  1. Les machines VDA doivent être redémarrés pour que la stratégie prenne effet.

Compatibilité entre Citrix App Protection et Microsoft Teams

Les utilisateurs qui ont activé la protection des applications peuvent toujours partager leur écran et leurs applications tout en utilisant la nouvelle optimisation. Le partage nécessite VDA version 2402 ou ultérieure, et CWA pour Windows 2309.1 ou version ultérieure. Les utilisateurs des versions antérieures finissent par partager un écran noir à la place lorsque le module Protection des applications est installé et activé.

Résolution des problèmes

  • Non optimisé avec SlimCore et à la place, vous voyez :
    « Azure Virtual Desktop Media Optimized »
    « Citrix HDX Optimized »

    • Les codes d’erreur 2000 (« Aucun plug-in ») et 2001 (« Canal virtuel non disponible ») sont les causes les plus probables.
    1. Vérifiez que votre « liste verte de canal virtuel » est correctement configurée pour autoriser MSTEAMS, MSTEAM1 MSTEAM2.
    2. Vérifiez que le point de terminaison possède le plug-in et qu’il est chargé par le client VDI avec l’Explorateur de processus :
    • Exécutez l’Explorateur de processus.
    • Activez le volet inférieur et basculez vers l’onglet DLL.
    • Sur Azure Virtual Desktop, recherchez le processus msrdc.exe et vérifiez que le MsTeamsPluginAvd.dll est chargé.
    • Sur Citrix, recherchez le processus wfica32.exe et vérifiez que le MsTeamsPluginCitrix.dll est chargé.
    1. Redémarrez la nouvelle application Teams. Il nécessite deux redémarrages pour passer de WebRTC à SlimCore, lorsque le plug-in est détecté pour la première fois.
    2. Si le problème persiste, cochez l’Observateur d’événements dans la machine virtuelle pour les erreurs liées à Microsoft Teams VDI (nouveau Teams 24123.X.X.X ou version ultérieure).

  • Non optimisé avec SlimCore et à la place, vous voyez : « Azure Virtual Desktop SlimCore Media Not Connected » ou « Citrix SlimCore Media Not Connected ».

Nouveaux journaux Teams pour VDI

Les journaux Teams peuvent être collectés en sélectionnant Ctrl+Alt+Maj+1 lors de l’exécution de Teams sur une machine virtuelle. Cette action génère un dossier ZIP dans le dossier Téléchargements. Dans le fichier PROD-WebLogs-*.zip, recherchez le dossier Core.

Azure Virtual Desktop/W365 Citrix
« vdiConnectedState » : {"connectedStack » : « remote"}, « vdiVersionInfo » : {"bridgeVersion » : « 2024.18.1.11 », « remoteSlimcoreVersion » : « 2024.18.01.11 », « nodeId » : « 1051a908af6b160e », « clientOsVersion » : « 10.0.22631 », « rdClientVersion » : « 1.2.5405.0 », « rdClientProductName » : « Microsoft® Remote Desktop », « pluginVersion » : « 2024.14.01.1 », « screenShareFallback » : true} « vdiConnectedState » : {"connectedStack » : « remote"}, « vdiVersionInfo » : {"bridgeVersion » : « 2024.18.1.14 », « remoteSlimcoreVersion » : « 2024.18.01.14 », « nodeId » : « ffffffff93eaee6a », « clientOsVersion » : « 10.0.22631 », « rdClientVersion » : « 24.3.0.64 », « rdClientProductName » : « Citrix Workspace », « pluginVersion » : « 2024.15.01.3 », « screenShareFallback » : true}
  • vdiConnectedState affiche la pile d’appels active actuelle.
    • connectedStack : remote indique que Teams s’est correctement connecté au point de terminaison distant via le canal virtuel. Cela ne signifie pas nécessairement que la pile des appels est correctement initialisée, de sorte que l’utilisateur peut toujours rencontrer des échecs liés à l’appel, comme l’impossibilité de démarrer un appel.
    • connectedStack : local indique que la connexion au canal virtuel a échoué. L’utilisateur est maintenant en mode de secours.
  • vdiVersionInfo fournit des informations utiles pour le client Teams et le point de terminaison.
    • bridgeVersion est lié à la version du client de bureau Teams s’exécutant sur la machine virtuelle.
    • remoteSlimcroreVersion est la version du VDI SlimCore disponible sur le point de terminaison.
    • nodeId est un ID unique lié au point de terminaison.
    • clientOsVersion est la version du système d’exploitation du point de terminaison.
    • rdClientVersion est la version du client Bureau à distance s’exécutant sur le point de terminaison, qui est utilisée pour se connecter à la machine virtuelle.
    • rdClientProductName est le nom du client Bureau à distance s’exécutant sur le point de terminaison.
    • pluginVersion est la version du plug-in intégrée au client Bureau à distance.

Diagnostics-logs.txt peut être sur weblogs\user(..)

Pour examiner plus en détail les problèmes liés à la connexion VDI, l’utilisation du mot clé vdiBRidgeEventsHandler fournit les journaux de la gestion des événements de connexion et de déconnexion vdiBridge, comme indiqué (gestion des événements onConnected) dans l’exemple suivant d’une connexion réussie avec la nouvelle pile d’optimisation :

7432 2024-03-01T17:51:22.032Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - onConnected: end, currentStack=remote 7435 2024-03-01T17:51:22.032Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - new calling stack type set: currentStack=remote 7436 2024-03-01T17:51:22.032Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - deviceManagerService reloaded 7445 2024-03-01T17:51:22.031Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - calling stack reinit complete with nextStack=remote 7464 2024-03-01T17:51:21.785Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - starting calling stack reinit with nextStack=remote 7465 2024-03-01T17:51:21.785Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - SlimCore replacement complete, remote is now available 7467 2024-03-01T17:51:21.783Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - setVDIOptimizationModeOverride: from SlimCore to SlimCore 7468 2024-03-01T17:51:21.782Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - onConnected: isVersionMismatch=false, forceVersion=undefined, bridgeVersion=2024.5.1.11 7469 2024-03-01T17:51:21.782Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - cached local SlimCore for future (fallback), currentStack=local 7470 2024-03-01T17:51:21.782Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - onConnected: start, vendorType=1, remoteSlimcoreVersion=2024.05.01.11, platform=win-x86, loadErrc=1, deployErrc=24002, nodeId=ffffffffbd7d5e77 7471 2024-03-01T17:51:21.782Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - enqueueBridgeCallback: adding onConnected to queue, 0 bridge callbacks in queue, isBridgeCallbacksQueueProcessing=false

Erreur de connexion

En cas d’erreur de connexion, le code d’erreur se trouve à partir de la ligne de journal contenant « loadErrc » et « deployErrc ». Le code enregistré ici doit être mappé à l’aide de cette table :

Code d’erreur deployErrc Définition Remarques
0 0 D’ACCORD Code spécial pour les messages de télémétrie « ConnectedNoPlugin ».
5 43 ERROR_ACCESS_DENIED MsTeamsVdi.exe processus a échoué au démarrage. Peut être dû à l’activation de BlockNonAdminUserInstall. Ou le point de terminaison peut être occupé à inscrire plusieurs packages MSIX après l’ouverture de session d’un utilisateur et il n’a pas terminé l’inscription de SlimCoreVdi.
404 3235 HTTP_STATUS_NOT_FOUND Problème de publication : le package MSIX SlimCore est introuvable sur le CDN.
1260 10083 ERROR_ACCESS_DISABLED_BY_POLICY Cette erreur signifie généralement que le Gestionnaire de package Windows ne peut pas installer le package MSIX SlimCore. L’Observateur d’événements peut afficher le code d’erreur hexadécimal 0x800704EC. Les stratégies AppLocker peuvent provoquer ce code d’erreur. Vous pouvez désactiver AppLocker ou ajouter une exception pour les packages SlimCoreVdi dans Stratégie de sécurité locale -> Stratégies de contrôle d’application -> AppLocker. Cochez « Étape 3 » sous « Optimisation avec une nouvelle solution VDI pour Teams ».
1460 11683 ERROR_TIMEOUT MsTeamsVdi.exe processus a échoué au démarrage (délai d’expiration de 60 secondes).
1722 RPC_S_SERVER_UNAVAILABLE « Le serveur RPC n’est pas disponible » MsTeamsVdi.exe'erreur associée.
2000 16002 Aucun plug-in Le point de terminaison n’a pas le MsTeamsPlugin, ou s’il l’a, il n’a pas été chargé (vérifiez avec l’Explorateur de processus).
2001 Canal virtuel non disponible Erreur sur Citrix VDA WFAPI.
3000 24002 Déploiement SlimCore non nécessaire Ce code n’est pas vraiment une erreur. C’est un bon indicateur que l’utilisateur est sur la nouvelle architecture d’optimisation avec SlimCore.
3001 24010 SlimCore déjà chargé Ce code n’est pas vraiment une erreur. C’est un bon indicateur que l’utilisateur est sur la nouvelle architecture d’optimisation avec SlimCore.
3004 24035 Irresponsive du plug-in Essayez de redémarrer une session RDP ou ICA.
3005 24043 Délai d’expiration du plug-in lors du téléchargement Échec du téléchargement du MSIX dans les 2 minutes.
3007 24058 Délai d’expiration du chargement Le téléchargement ou l’installation de SlimCore a expiré (Internet lent ou App Readiness Service est occupé).
4000 ERROR_WINS_INTERNAL WINS a rencontré une erreur lors du traitement de la commande.
15615 1951 ERROR_INSTALL_POLICY_FAILURE Erreur liée à SlimCore MSIX. Pour installer cette application, vous avez besoin d’une licence de développeur Windows ou d’un système prenant en charge le chargement indépendant. La clé de registre AllowAllTrustedApps peut être définie sur 0 ?
15616 ERROR_PACKAGE_UPDATING Erreur liée à SlimCore MSIX « Impossible de démarrer l’application, car elle est en cours de mise à jour ».
15700 APPMODEL_ERROR_NO_PACKAGE Le processus n’a pas d’identité de package. Il n’existe aucun alias pour MsTeamsVdi dans %LOCALAPPDATA%\Microsoft\WindowsApps. Les journaux du Hub de commentaires sont nécessaires lors de la reproduction de l’erreur (veillez à sélectionner Plateforme de développement comme catégorie et Déploiement d’applications en tant que sous-catégorie).

Utilisation de l’Observateur d’événements sur la machine virtuelle pour la résolution des problèmes

Chaque événement de connexion/déconnexion est journalisé dans l’observateur d’événements en cours d’exécution sur la machine virtuelle. L’Observateur d’événements peut également afficher les erreurs liées au client. Filtrer par source (VDI Microsoft Teams) et ID d’événement (0). Les codes d’erreur se trouvent dans la section Nouveaux journaux Teams pour VDI .

Remarque

Pour pouvoir filtrer par source, vous devez exécuter cette commande à partir d’une fenêtre PowerShell avec élévation de privilèges :

PS C :\Windows\system32> New-EventLog -LogName Application -Source « Microsoft Teams VDI »

Résolution des erreurs de déploiement de plug-in

Les informations de diagnostic se trouvent dans les journaux des événements détaillés sur l’appareil de l’utilisateur. Après l’installation, MsTeamsPluginCitrix.dll est écrit dans le dossier CWA. Uniquement pour la plateforme Citrix, les clés suivantes sur le point de terminaison (et non sur la machine virtuelle) sont créées :

Clé Type de clé Nom de la clé Valeur de clé
HKLM\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ICA 3.0 String VirtualDriverEx MicrosoftTeamsVDI
HKLM\SOFTWARE\WOW6432Node\Citrix\ICAClient\Engine\Configuration\Advanced\Modules\MicrosoftTeamsVDI String DriverNameWin32 MsTeamsPluginCitrix.dll

Pour déboguer les installations, vous pouvez activer la journalisation du programme d’installation, mais vous devez ensuite utiliser msiexec manuellement et passer les indicateurs corrects. Par exemple, si le plug-in n’est pas installé actuellement, il peut être installé avec des journaux comme suit : msiexec.exe /i MsTeamsPluginCitrix.msi /l*vx installer.log.txt.

Résolution des erreurs de déploiement MSIX SlimCoreVdi

Veillez à consulter la section Mise en lots et inscription slimCore MSIX sur le point de terminaison , car certains objets de stratégie de groupe peuvent empêcher les installations MSIX.

Les informations de diagnostic se trouvent dans les journaux des événements détaillés sur l’appareil de l’utilisateur.

  1. Accédez à Journaux > des applications et services de l’observateur d’événements (local) > Microsoft > Windows.
  2. Recherchez les journaux disponibles dans les catégories suivantes :
  • AppxPackagingOM > Microsoft-Windows-AppxPackaging/Operational
  • >AppXDeployment-Server Microsoft-Windows-AppXDeploymentServer/Operational
  1. Passez en revue les journaux sous AppXDeployment-Server.

Erreur 15615

L’erreur 15615 signifie généralement que le Gestionnaire de package Windows ne peut pas installer le package MSIX avec SlimCoreVdi.

  • Assurez-vous que la signature numérique de ce MSIX est approuvée par le point de terminaison (accédez à Propriétés > MSIX > Détails des signatures > numériques). Il s’agit d’une signature Microsoft valide et conviviale pour le magasin, mais les clients peuvent avoir quelque chose de spécial configuré.
  • Essayez d’activer la stratégie AllowAllTrustedApps.
  • Essayez d’autoriser le chargement indépendant d’applications à partir de sources non-magasin approuvées.
    • Sur Windows 10, ce paramètre est activé par défaut. Par conséquent, modifiez-le ici au cas où il est désactivé : Paramètres > Mise à jour et sécurité > Pour les développeurs > Charger une version test des applications.
    • Sur Windows 11, ce paramètre est activé par défaut : Paramètres Applications >> Paramètres Avancés de l’application > Choisissez où obtenir les applications > n’importe où.

Collection de journaux

La journalisation se trouve aux emplacements suivants :

  • Sur le client :
    • AppData\Roaming\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\skylib
    • AppData\Roaming\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\media-stack
  • Sur le serveur :
    • AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs\skylib