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

Microsoft a terminé le déploiement de la disponibilité générale pour les clients Citrix. La nouvelle optimisation nécessite Microsoft Teams version 24295.605.3225.8804 et la version du client 24110115722, comme indiqué dans Paramètres>à propos de Teams.

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 de propre-up. Peu fréquent (idéalement aucune mise à jour). Environ 200 Ko. Fourni avec rd client 1.2.5405.0 ou Windows App version 1.3.252 ou 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 24193.1805.3040.8975 (pour Azure Virtual Desktop/Windows 365)
24295.605.3225.8804 (pour Citrix)
Azure Virtual Desktop/Windows 365 Windows App : 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
MsTeamsPluginCitrix : 2024.41.1.1
Point de terminaison Windows 10 1809 (condition minimale de SlimCore)
Les objets de stratégie de groupe ne doivent pas bloquer les installations MSIX (voir Étape 3 : Préproduction et inscription de 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 24193.1805.3040.8975 ou ultérieure (pour Azure Virtual Desktop/Windows 365) et de la version 24295.605.3225.8804 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 se trouve dans AppData\Local\Apps\Remote Desktop ou C :\Program Files (x86), selon le mode dans lequel il a été installé.
    • L’application Windows App Store, puisqu’elle est basée sur MSIX, se trouve dans C :\Program Files\WindowsApps. L’accès à ce dossier est limité.

  2. 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 quel CWA pris en charge existant (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 msiexec.

      Important

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

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 un stratégie de groupe ou un outil tiers. Pour obtenir la liste complète des clés de Registre applicables, consultez Fonctionnement de 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 d’applications dans votre organization, 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.

AppLocker est une fonctionnalité de sécurité de défense en profondeur qui n’est pas considérée comme une fonctionnalité de sécurité Windows défendable. Windows Defender Application Control doit être utilisé lorsque l’objectif est de fournir une protection robuste contre une menace et qu’il n’existe aucune limitation par conception qui empêcherait la fonctionnalité de sécurité d’atteindre cet objectif.

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.

AppLocker ne peut pas traiter les caractères génériques de fin, contrairement à Windows Defender Application Control. Étant donné que les packages SlimCoreVdi contiennent un PackageFamilyName spécifique à la version (par exemple, Microsoft.Teams.SlimCoreVdi.win-x64.2024.36_8wekyb3d8bbwe), les clients peuvent ajouter des exclusions AppX ou MSIX en s’appuyant sur publisherID 8wekyb3d8bbwe à la place.

Vérification que le point de terminaison est optimisé

Une fois que vous avez satisfait à toutes les exigences minimales, le lancement de Teams pour la première fois le trouve 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 case activée dans le client Teams que vous avez 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.

  • AVD SlimCore Media Optimized = Nouvelle optimisation basée sur SlimCore.
  • AVD Media Optimized = Optimisation héritée basée sur WebRTC.

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*

Voici un exemple des résultats qui peuvent être retournés à partir de l’exécution de ce PowerShell :

Name              : Microsoft.Teams.SlimCoreVdi.win-x64.2024.32
Publisher         : CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US
Architecture      : X64
ResourceId        :
Version           : 2024.32.1.7
PackageFullName   : Microsoft.Teams.SlimCoreVdi.win-x64.2024.32_2024.32.1.7_x64__8wekyb3d8bbwe
InstallLocation   : C:\Program
                    Files\WindowsApps\Microsoft.Teams.SlimCoreVdi.win-x64.2024.32_2024.32.1.7_x64__8wekyb3d8bbwe
IsFramework       : False
PackageFamilyName : Microsoft.Teams.SlimCoreVdi.win-x64.2024.32_8wekyb3d8bbwe
PublisherId       : 8wekyb3d8bbwe
IsResourcePackage : False
IsBundle          : False
IsDevelopmentMode : False
NonRemovable      : False
IsPartiallyStaged : False
SignatureKind     : Developer
Status            : Ok

Important

Microsoft stocke jusqu’à 12 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 (en tant que processus enfant de msrdc.exe) ou Citrix (en tant que processus enfant de wfica32.exe). Lorsque vous utilisez process Explorer, si vous sélectionnez msrdc.exe (ou wfica32.exe), sélectionnez Afficher le volet inférieur sous Affichage et basculez vers l’onglet DLL, vous pouvez également voir le plug-in (MsTeamsPluginAvd.dll ou MsTeamsPluginCitrix.dll) en cours de chargement. Cette action est une étape de dépannage utile si vous n’obtenez pas la nouvelle optimisation.

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). Pour éviter ce scénario, Teams invite l’utilisateur avec une boîte de dialogue modale demandant de redémarrer l’application. Après le redémarrage, les utilisateurs sont en mode d’optimisation WebRTC.

Options de reconnexion Si l’optimisation actuelle est WebRTC Si l’optimisation actuelle est SlimCore
Reconnexion à partir d’un point de terminaison sans MsTeamsPlugin Ensuite, optimisation
classique WebRTC (« AVD Media Optimized »)
(« Citrix HDX Media Optimized »)		 Puis redémarrer l’invite
de dialogue Après le redémarrage, l’utilisateur est sur l’optimisation webRTC classique. Sinon, Teams n’est pas redémarré et l’utilisateur est en mode de secours (rendu côté serveur).
Reconnexion à partir d’un point de terminaison avec MsTeamsPlugin Ensuite, optimisation
classique WebRTC (« AVD Media Optimized »)
(« Citrix HDX Media Optimized »)		 Puis 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 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), 3479 (audio), 3480 (vidéo), 3481 (partage d’écran)
12 Autoriser obligatoire Oui *.lync.com, *.teams.microsoft.com, teams.microsoft.com 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 sélectionne 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 il 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.
  3. 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 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 QoS, reportez-vous au document playbook .

  • 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 Access Control Listes basées sur les ports (ACL)
    • 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 spécifiquement 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 dans 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 le organization. PS C:\> Remove-CsTeamsMeetingPolicy -Identity RestrictedUserPolicy Dans l’exemple présenté précédemment, la commande supprime la stratégie utilisateur restreinte de la liste des stratégies de l’organization 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 le organization. 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 sur SlimCore (Windows) Disponible sur WebRTC (Windows)
1080p Oui Non
Accélération matérielle sur le point de terminaison Oui Non
Vue Galerie 3x3 et 7x7 Oui Non
Qualité de service Oui Non
Suppression du bruit Oui Oui (AVD)
Isolation vocale Oui Non
CACHÉ Oui Oui (AVD et Omnissa)
Mode présentateur Oui Non
Teams Premium Oui
(En attente : filigrane, mairies, décorer mon arrière-plan)		 Non
Arrière-plans personnalisés de l’organisation Oui (licence Teams Premium requise) Non
Effet d’arrière-plan chargé par l’utilisateur Bientôt disponible Non
Zoom +/- Oui Non
Déviation du trafic multimédia, routage basé sur l’emplacement, connexion de l’opérateur Oui Non
Tableau de bord qualité des appels et centre d’administration Teams Oui Limité
Application publiée/Application distante Non Oui
Donner/Prendre le contrôle Oui Oui
Partage d’applications Oui Oui
e911 Oui Oui
Diffuser simultanément Oui Oui
Partager l’audio système Oui Oui
Sonnerie secondaire Oui Oui
Flou d’arrière-plan Oui Oui

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\Local\Microsoft\TeamsVDI\avd-default-<cloudname>\
  • C:\users\<user>\AppData\Local\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. Pour les clients légers plus anciens Windows 10 1809 (tels que Dell Wyse 5070 et modèles similaires), l’emplacement du dossier pour le profil SlimCore est C:\Users\<user>\AppData\Local\Packages\Microsoft.Teams.SlimCoreVdi.win-<architecture>.<version>_8wekyb3d8bbwe\LocalCache\.

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, les clients légers verrouillés sans profils itinérants), MsTeamsVdi.exe les recrée et télécharge 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 Administration. 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.

Remarque

Pour obtenir une liste mise à jour des packages SlimCore qui correspondent à leur nouvelle version de Teams correspondante, case activée ce tableau.

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.

  2. 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 Windows App : Microsoft.Teams.SlimCoreVdi.<platform>-<architecture>.msix.

  3. 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

  • AVD RemoteApps et Citrix Published Apps ne sont pas pris en charge pour l’instant.
  • La protection contre la capture d’écran (SCP) entraîne l’affichage de l’écran du présentateur sous la forme d’un écran noir avec uniquement le curseur de la souris au-dessus (comme le montre le côté récepteur).
  • 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.
  • L’aperçu automatique de l’appareil photo n’est pas pris en charge pour l’instant (sous Paramètres/Appareils, ou lors d’un appel lorsque vous sélectionnez la flèche vers le bas sur l’icône de l’appareil photo).
  • Dans la Panneau de configuration/Applications/Applications installées du point de terminaison, les utilisateurs voient plusieurs entrées « Microsoft Teams VDI » (une pour chaque package Slimcore installé).
  • Lors du partage d’écran plein écran, la fenêtre moniteur d’appel est visible pour les autres participants (sans contenu vidéo à l’intérieur).
  • Dans Citrix, les sessions de partage d’applications peuvent se figer pour les autres participants si le présentateur est sur VDA version 2402 et CWA pour Windows 2309.1 (ou versions ultérieures).
    • Le problème se produit lorsqu’un élément vidéo est détruit.
      • Par exemple, un participant désactive sa caméra au milieu de la session de partage d’application.
      • Si une personne active uniquement sa caméra, il n’y a aucun problème, car l’élément vidéo est créé, et non détruit.
      • Si le présentateur optimise le moniteur d’appels (ce qui détruit l’aperçu automatique de ce que le présentateur partage).
    • L’arrêt et le repartage de la fenêtre doivent résoudre le problème.
    • Ce problème a été résolu dans les nouvelles versions teams 24335.206.X.X ou ultérieures.

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 de processus De main 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.

  2. Les machines VDA doivent être redémarrés pour que la stratégie prenne effet.

Partage d’écran

Le partage d’écran sortant et le partage d’applications se comportent différemment dans l’infrastructure VDI optimisée par rapport au client de bureau Teams non optimisé. Par conséquent, ces activités nécessitent un encodage qui tire parti des ressources d’appareil de l’utilisateur (par exemple, processeur, GPU, RAM, réseau, etc.). Du point de vue du réseau, le partage s’effectue directement entre l’appareil de l’utilisateur et l’autre homologue ou serveur de conférence.

Lors d’un partage d’écran en mode plein écran, le moniteur d’appel Teams est capturé et visible par les autres participants (bien que les éléments vidéo à l’intérieur ne soient pas visibles et soient plutôt vus comme des carrés vides). Lors du partage d’application, seule l’application partagée est visible par les autres participants et le moniteur d’appel n’est pas capturé.

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 inférieures finissent par partager un écran noir à la place lorsque le module Protection des applications est installé et activé.

Protection de capture d’écran AVD et compatibilité de Microsoft Teams

Les utilisateurs dont la protection de capture d’écran (SCP) est activée ne peuvent pas partager leurs écrans ou applications. Les autres personnes à l’appel ne peuvent voir qu’un écran noir. Si vous souhaitez autoriser les utilisateurs à partager leur écran même si scp est activé, vous devez désactiver l’optimisation SlimCore dans la stratégie Du Centre Administration Teams (afin que l’utilisateur soit optimisé avec WebRTC) et définir la stratégie SCP sur Bloquer la capture d’écran sur le client.

Tableau de bord qualité des appels dans VDI

Le tableau de bord qualité des appels (CQD) permet aux professionnels de l’informatique d’utiliser des données agrégées pour identifier les problèmes de qualité des médias en comparant les statistiques des groupes d’utilisateurs afin d’identifier les tendances et les modèles. CQD n’est pas axé sur la résolution des problèmes d’appel individuels, mais sur l’identification des problèmes et des solutions qui s’appliquent à de nombreux utilisateurs.

Les informations utilisateur VDI sont désormais exposées via de nombreuses dimensions et filtres. Consultez cette page pour plus d’informations sur chaque dimension.

Remarque

Le nouveau modèle QER (Quality of Experience) est disponible dans les modèles de requête Power BI pour le téléchargement CQD. La version 8 inclut désormais des modèles permettant d’examiner les métriques axées sur le client VDI.

Principes de base des requêtes

Une requête/rapport CQD bien formé contient les trois paramètres suivants :

Voici quelques exemples de requête bien formée :

  1. « Afficher les flux médiocres [mesure] pour les utilisateurs VDI avec la nouvelle optimisation [Dimension] pour le mois dernier [filtre] »
  2. « Show me Poor Appsharing [Measurement] by Total Stream Count [Dimension] for Last Month AND where First OR Second Client VDI mode a été optimisé [Filtres] »

Vous pouvez également utiliser de nombreuses valeurs Dimension et Mesure comme filtres. Vous pouvez utiliser des filtres dans votre requête pour éliminer les informations de la même façon que vous sélectionneriez une dimension ou une mesure pour ajouter ou inclure des informations dans la requête.

Action d’UNION

Par défaut, les filtres vous permettent de filtrer des conditions avec l’opérateur AND. Toutefois, il existe des scénarios dans lesquels vous pouvez combiner plusieurs conditions de filtre pour obtenir un résultat similaire à une opération OR. Par exemple : pour obtenir tous les flux des utilisateurs VDI, UNION fournit une vue distincte du jeu de données fusionné. Pour utiliser UNION, insérez du texte commun dans le champ UNION dans les 2 conditions de filtre souhaitées dans UNION.

Emplacement de l’appelant et de l’appelé

CQD n’utilise pas de champs Appelant ou Appelé, à la place, il utilise First et Second , car il y a des étapes intermédiaires entre l’appelant et l’appelé.

  • La première est toujours le point de terminaison du serveur (par exemple, av MCU ou le serveur de processeur multimédia) si un serveur est impliqué dans le flux.
  • Le deuxième est toujours le point de terminaison du client, sauf s’il s’agit d’un flux serveur-serveur.

Si les deux points de terminaison sont du même type (par exemple, un appel de personne à personne), le premier et le deuxième point de terminaison sont définis en fonction de l’ordre interne de la catégorie d’agent utilisateur pour garantir la cohérence de la commande.

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 process Explorer :
    • 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, case activée 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 de mot clé vdiBRidgeEventsHandler fournit les journaux de la gestion des événements de connexion et de déconnexion vdiBridge, comme indiqué (onConnected event handling) 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 ». Une erreur de déploiement (également appelée install_error) est une erreur qui se produit lorsque le plug-in essayait de télécharger le package SlimCore MSIX à partir du CDN de Microsoft et de le configurer sur le point de terminaison à l’aide d’App Readiness Service pour AppX. Une erreur de chargement est une erreur qui se produit lorsque le plug-in a essayé de démarrer MsTeamsVdi.exe et d’établir un appel de procédure distante (RPC) vers celui-ci.

Le code enregistré ici doit être mappé à l’aide de cette table :

loadErrc 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 Gestionnaire de package Windows ne pouvez pas installer le package MSIX SlimCore. observateur d'événements pouvez 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 l’é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é (case activée avec process Explorer).
2001 Canal virtuel non disponible Erreur sur Citrix VDA WFAPI.
2003 16026 Les canaux virtuels personnalisés (MSTEAMS, MSTEAM1 et MSTEAM2) sont bloqués en raison d’une stratégie Citrix Studio Consultez la section Liste verte des canaux virtuels Citrix de cet article.
2005 16043 Teams s’exécute en tant qu’application publiée (Citrix) ou RemoteApp (AVD/Windows 365) Ce mode n’est actuellement pas pris en charge : Teams ne chargera pas SlimCore dans ce cas, et les utilisateurs seront toujours optimisés avec WebRTC.
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).
16389 E_FAIL signalées par le Gestionnaire de package Généralement identique au code d’erreur de chargement 5 (ERROR_ACCESS_DENIED). Probablement dû à la stratégie BlockNonAdminUserInstall lorsque l’utilisateur n’est pas un Administration. Pour plus d’informations, consultez ce lien.

Utilisation de 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 le observateur d'événements en cours d’exécution sur la machine virtuelle. Le 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 aux journaux > observateur d'événements (local) > des applications et des services Microsoft > Windows.

  2. Recherchez les journaux disponibles dans les catégories suivantes :

    • AppxPackagingOM > Microsoft-Windows-AppxPackaging/Operational
    • >AppXDeployment-Server Microsoft-Windows-AppXDeploymentServer/Operational

  3. 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 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\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\skylib
    • AppData\Local\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\media-stack
  • Sur le serveur :
    • AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs\skylib