Optimierung für Microsoft Teams

Wichtig:

Die Optimierung für Microsoft Teams erfordert mindestens Microsoft Teams Version 1.2.00.31357.

Citrix bietet eine Optimierung für die Verwendung der Desktopversion von Microsoft Teams in Citrix Virtual Apps and Desktops und der Citrix Workspace-App. Standardmäßig werden alle erforderlichen Komponenten in die Citrix Workspace-App und den Virtual Delivery Agent (VDA) gepackt.

Die Optimierung für Microsoft Teams enthält VDA-seitige HDX-Dienste und -API, die als Schnittstelle mit der von Microsoft Teams gehosteten App zum Empfangen von Befehlen fungieren. Diese Komponenten öffnen einen virtuellen Steuerungskanal (CTXMTOP) zur Media Engine der Citrix Workspace-App. Multimedia wird vom Endpunkt decodiert und lokal wiedergegeben. Im invertierten Seamlessmodus wird das lokale Citrix Workspace-App-Fenster an die von Microsoft Teams gehostete App zurückgegeben.

Authentifizierung und Signalisierung erfolgen nativ in der von Microsoft Teams gehosteten App, genau wie die anderen Microsoft Teams-Dienste (zum Beispiel Chat oder Teamarbeit). Die Audio-/Videoumleitung hat auf sie keine Auswirkungen.

CTXMTOP ist ein virtueller Command-and-Control-Kanal. Dies bedeutet, dass Medien nicht zwischen der Citrix Workspace-App und dem VDA ausgetauscht werden.

Nur Clientabruf und Clientwiedergabe sind verfügbar.

In diesem Video wird gezeigt, wie Microsoft Teams in einer virtuellen Citrix Umgebung funktioniert.

Demo: Optimierung für Microsoft Teams

Installation von Microsoft Teams

WARNUNG:

Eine unsachgemäße Bearbeitung der Registrierung kann schwerwiegende Probleme verursachen und eine Neuinstallation des Betriebssystems erforderlich machen. Citrix übernimmt keine Garantie dafür, dass Probleme, die auf eine unsachgemäße Verwendung des Registrierungs-Editors zurückzuführen sind, behoben werden können. Die Verwendung des Registrierungs-Editors geschieht daher auf eigene Gefahr. Machen Sie auf jeden Fall ein Backup der Registrierung, bevor Sie sie bearbeiten.

Wir empfehlen, die Richtlinien zur maschinenweiten Installation von Microsoft Teams zu befolgen und nicht das EXE-Installationsprogramm zu verwenden, mit dem Teams Appdata in installiert wird. Installieren Sie die Software stattdessen an der Befehlszeile mit dem Flag ALLUSER=1 unter C:\Program Files (x86)\Microsoft\Teams. Die Teams-Anwendung wird dann nicht automatisch aktualisiert, sobald eine neue Version vorhanden ist. Dieser Modus wird für nicht persistente Umgebungen empfohlen. Weitere Informationen finden Sie unter Installieren von Microsoft Teams mithilfe eines MSI-Pakets (Abschnitt zur VDI-Installation).

Wenn Sie dedizierte persistente VDI-Umgebungen verwenden und die Teams-Anwendung automatisch aktualisieren und pro Benutzer unter Appdata/Local installieren möchten, verwenden Sie das EXE-Installationsprogramm oder das MSI ohne ALLUSER =1.

Wenn Sie Citrix App Layering zum Verwalten von VDA- und Microsoft Teams-Installationen auf verschiedenen Ebenen verwenden, stellen Sie diesen Registrierungsschlüssel unter Windows bereit, bevor Sie Teams mit ALLUSER = 1installieren:

HKEY_LOCAL_MACHINE\SOFTWARE\Citrix

Oder

HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix

Erstellen Sie einen leeren Registrierungsschlüssel mit dem NamenPortICA (belassen Sie die Standardeinstellungen für Name, Typ und Daten).

Empfehlungen zur Profilverwaltung

Wenn das Flag ALLUSER =1 an der Befehlszeile an das MSI übergeben wird, wird die Teams-App unter C:\Program Files installiert (~300 MB). Die App verwendet AppData\Local für Protokolle und AppData\Roaming\Microsoft\Teams für benutzerspezifische Konfigurationen, das Zwischenspeichern von Elementen der Benutzeroberfläche usw.

Systemanforderungen

Mindestversion – VDA 1906.2:

Unterstützte Betriebssysteme:

  • Windows 10 64-Bit, Mindestversionen 1607 bis 1903.
  • Windows Server 2019, 2016 und 2012 R2, Standard und Datacenter Edition

Anforderungen:

  • BCR_x64.msi: Das MSI mit dem Microsoft Teams-Optimierungscode. Es startet automatisch von der GUI. Wenn Sie die Befehlszeilenschnittstelle für die VDA-Installation verwenden, schließen Sie es nicht aus.

Empfohlene Version – Citrix Workspace-App 1911 für Windows, Mindestversion – Citrix Workspace-App 1907 für Windows:

  • Windows 7, 8 und 10, 32-Bit- und 64-Bit-Editionen (inkl. Embedded Edition)
  • Windows 10 IoT Enterprise 2016 LTSB (v1607) und 2019 LTSC (v1809)
  • Endpunkt: Dual-Core-CPU (ca. 2,2–2,4 GHz), die 720p-HD-Auflösung für Peer-to-Peer-Videokonferenzen unterstützt.
  • Dual- oder Quad-Core-CPUs mit niedrigerem Basistakt (~1,5 GHz), ausgestattet mit Intel Turbo Boost oder AMD Turbo Core für eine Steigerung bis mindestens 2,4 GHz.
  • HP Thin Clients-geprüft: t630/t640, t730/t740, mt45.
  • Dell Thin Clients-geprüft: 5070, 5470 Mobile TC.
  • Eine vollständige Liste aller geprüften Endpunkte finden Sie unter Thin Clients.
  • Die Citrix Workspace-App benötigt mindestens 600 MB freien Speicherplatz und 1 GB RAM.
  • Mindestanforderungen für Microsoft .NET Framework ist Version 4.6.2. Die Citrix Workspace-App lädt .NET Framework automatisch herunter und installiert es, wenn es nicht vorhanden ist.

Aktivieren der Optimierung für Microsoft Teams

Verwenden Sie die unter Microsoft Teams-Umleitungsrichtlinie beschriebene Studio-Richtlinie (Standardeinstellung Ein), um die Optimierung für Microsoft Teams zu aktivieren. Zusätzlich zu der Aktivierung dieser Richtlinie überprüft HDX, ob die Version der Citrix Workspace-App der Mindestversion entspricht. Wenn Sie die Richtlinie aktiviert haben und die Version der Citrix Workspace-App unterstützt wird, wird der Registrierungsschlüssel HKEY_CURRENT_USER\Software\Citrix\HDXMediaStream\MSTeamsRedirSupport auf dem VDA automatisch auf 1 festgelegt. Microsoft Teams liest den Schlüssel zum Laden im VDI-Modus.

Wenn Sie auf Info > Version klicken, wird Optimiert für Citrix angezeigt:

Legende "Optimiert für Citrix"

Wenn Optimiert für Citrix nicht angezeigt wird, klicken Sie mit der rechten Maustaste auf das Symbol für den Infobereich, um Teams zu beenden und neu starten.

Netzwerkanforderungen

Microsoft Teams benötigt Medienprozessor-Server unter Office 365 für Besprechungen oder Anrufe mit mehreren Teilnehmern. Microsoft Teams benötigt Office 365-Transport-Relays für folgende Szenarios:

  • Zwei Peers in einem Point-to-Point-Anruf ohne direkte Verbindung
  • Ein Teilnehmer ohne direkte Verbindung zum Medienprozessor

Daher hängt die Anrufgüte von der Integrität des Netzwerks zwischen dem Peer und der Office 365-Cloud ab.

Wir empfehlen eine Analyse der Umgebung auf Risiken und Anforderungen bezüglich der gesamten Sprach- und Videobereitstellung über die Cloud. Verwenden Sie das Skype for Business Network Assessment Tool, um zu prüfen, ob Ihr Netzwerk sich für Microsoft Teams eignet. Supportinformationen finden Sie in Abschnitt Support.

Zusammenfassung der wichtigsten Netzwerkempfehlungen für den Datenverkehr mit RTP (Realtime Transport Protocol):

  • Stellen Sie von der Zweigstelle eine möglichst direkte Verbindung zum Office 365-Netzwerk her.
  • Wenn Sie folgende Funktionen in der Zweigstelle verwenden, muss der RTP/UDP Teams-Verkehr ungehindert erfolgen. HdxTeams.exe berücksichtigt keine expliziten Proxys, die auf dem Endpunkt konfiguriert sind.
    • Proxyserver umgehen
    • Netzwerk-SSL abfangen
    • DPI-Geräte (Deep Packet Inspection)
    • VPN-Hairpins (nach Möglichkeit Split-Tunneling verwenden)
  • Sie müssen ausreichend Bandbreite einplanen und bereitstellen.
  • Überprüfen Sie Qualität und Konnektivität des Netzwerks für jede Zweigstelle.

Die WebRTC Media Engine in der Workspace-App (HdxTeams.exe) verwendet das Protokoll SRTP (Secure Real-Time Transport Protocol) für Multimediastreams, die an den Client ausgelagert werden. SRTP bietet Vertraulichkeit und Authentifizierung für RTP. Es verwendet symmetrische Schlüssel (128 Bit) zum Verschlüsseln von Medien und Steuerungsmeldungen und nutzt die AES-Verschlüsselung im Counter Modus.

Folgende Metriken werden für eine positive Benutzererfahrung empfohlen:

Metrik Endpunkt zu Office 365
Latenz (ein Weg) < 50 ms
Latenz (RTT) < 100 ms
Paketverlust < 1 % während eines Intervalls von 15 s
Paket-Interarrival-Jitter <30 ms während eines Intervalls von 15 s

Weitere Informationen finden Sie unter Vorbereiten des Netzwerks für Microsoft Teams.

Bezüglich Bandbreitenanforderungen kann die Optimierung für Microsoft Teams eine Vielzahl von Codecs für Audio (OPUS/G.722/PCM G711) und Video (H264/VP9) verwenden.

Die Peers handeln diese Codecs während der Einrichtung des Anrufs über SDP (Session Description Protocol) aus. Mindestempfehlungen von Citrix:

Typ Bandbreite Codec
Audio (bidirektional) ~ 90 KBit/s G.722
Audio (bidirektional) ~ 60 KBit/s Opus*
Video (bidirektional) ~ 700 KBit/s H264 360p bei 30 F/s 16:9
Video (bidirektional) ~ 2500 KBit/s VP9 720p bei 30 F/s 16:9
Bildschirmfreigabe ~ 300 kBit/s H264 1080p bei 15 F/s

* Opus unterstützt die Codierung mit konstanter und variabler Bitrate von 6 KBit/s bis 510 KBit/s.

Opus und VP9 sind die bevorzugten Codecs für Peer-to-Peer-Anrufe zwischen zwei optimierten VDI-Benutzern.

G.722 und H264 sind die bevorzugten Codecs für einen VDI-Benutzer, der einer Besprechung beitritt.

Anrufeinrichtung und Medienflusspfad

Wenn möglich, versucht die HDX Media Engine in der Citrix Workspace-App (HdxTeams.exe), eine direkte Netzwerkverbindung mit SRTP über UDP in einem Peer-to-Peer-Anruf herzustellen. Wenn die UDP-Ports blockiert sind, fällt die Media Engine auf TCP 443 zurück.

Die HDX Media Engine unterstützt ICE, STUN (Session Traversal Utilities for NAT) und TURN (Traversal Using Relays around NAT) für die Kandidatendiscovery und den Verbindungsaufbau.

Wenn der Benutzer einem Anruf oder einer Besprechung mit mehreren Teilnehmern beitritt und kein direkter Pfad zwischen zwei Peers oder zwischen einem Peer und einem Konferenzserver vorliegt, verwendet HdxTeams.exe einen Transport-Relay-Server von Microsoft Teams in Office 365, um den anderen Peer oder den Medienprozessor (den Host der Besprechung) zu erreichen. Der Clientcomputer des Benutzers muss auf zwei Office 365-Subnetz-IP-Adressbereiche und 4 UDP-Ports zugreifen können. Weitere Informationen finden Sie im Architekturdiagramm im Abschnitt “Einrichten von Anrufen” weiter unten und unter Office 365-URLs und IP-Adressbereich ID 11.

ID Kategorie Adressen Zielports
11 Optimieren erforderlich 13.107.64.0/18, 52.112.0.0/14 UDP: 3478, 3479, 3480, 3481, TCP: 443 (Fallback)

Diese Bereiche enthalten Transport-Relays und Medienprozessoren. Teams Transport-Relays bieten die Funktionen STUN und TURN, sie sind aber keine ICE-Endpunkte. Teams Transport-Relays beenden auch keine Medien und führen keine Transcodierung durch. Relays können als Bridge zwischen TCP (wenn HdxTeams.exe TCP verwendet) und UDP fungieren, wenn sie den Datenverkehr an andere Peers oder Medienprozessoren weiterleiten.

HdxTeams.exe kontaktiert das nächstgelegene Microsoft Teams Transport-Relay in der Office 365-Cloud. HdxTeams.exe verwendet Anycast-IP und Port 3478-3481 UDP (verschiedene UDP-Ports pro Workload, wobei Multiplexing möglich ist) oder 443 TCP TLSv1.2 für Fallbacks. Die Anrufqualität hängt vom zugrunde liegenden Netzwerkprotokoll ab. Da UDP über TCP immer empfehlenswert ist, sollten Sie Ihre Netzwerke so gestalten, dass UDP-Datenverkehr in der Zweigstelle möglich ist.

Wenn Teams im optimierten Modus geladen ist und HdxTeams.exe auf dem Endpunkt ausgeführt wird, können ICE-Fehler (Interactive Connectivity Establishment) zum Fehlschlagen des Anrufs oder zu einseitigem Audio/Video führen. Wenn ein Anruf nicht zustande kommt oder der Medienfluss keinen vollen Duplexmodus bietet, sollten Sie zuerst die Wireshark-Trace auf dem Endpunkt prüfen. Weitere Informationen zum Sammeln von ICE-Kandidaten finden Sie unter “Sammeln von Protokollen” im Abschnitt Support.

Hinweis:

Wenn die Endpunkte keinen Internetzugang haben, können Benutzer unter Umständen dennoch einen Peer-to-Peer-Anruf tätigen, wenn sie sich in demselben LAN befinden. Besprechungen schlagen fehl. In diesem Fall gibt es ein Timeout von 30 Sekunden, bevor der Anruf eingerichtet wird.

Einrichten von Anrufen

Dieses Architekturdiagramm dient als visuelle Referenz für die Flusssequenz bei einem Anruf. Die entsprechenden Schritte sind im Diagramm angegeben.

Architektur:

Funktionsweise der Optimierung für Microsoft Teams

  1. Starten Sie Microsoft Teams.
  2. Teams authentifiziert sich bei O365. Mandantenrichtlinien werden an den Teams-Client übertragen, und relevante TURN- und Signalkanalinformationen werden an die App weitergeleitet.
  3. Teams erkennt, dass es in einem VDA ausgeführt wird, und sendet API-Aufrufe an die Citrix JavaScript-API.
  4. Citrix JavaScript in Teams öffnet eine sichere WebSocket-Verbindung zu WebSocketService.exe, das auf dem VDA (127.0.0.1:9002) ausgeführt wird. Dies generiert WebSocketAgent.exe in der Benutzersitzung.
  5. WebSocketAgent.exe instanziiert einen generischen virtuellen Kanal, indem es den Citrix HDX-Teams-Umleitungsdienst (CtxSvcHost.exe) aufruft.
  6. Die HDX-Engine der Citrix Workspace-App (wfica32.exe) erzeugt einen neuen Prozess namens HdxTeams.exe. Dies ist die neue WebRTC-Engine, die für die Teamoptimierung verwendet wird.
  7. HdxTeams.exe und Teams.exe verfügen über einen 2-Wege-Pfad für virtuelle Kanäle und beginnen mit der Verarbeitung von Multimediaanfragen.

    —–Benutzeranrufe——

  8. Peer A klickt auf die Anruftaste. Teams.exe kommuniziert mit den Teams-Diensten in Office 365, die einen End-to-End-Signalpfad mit Peer B einrichten. Teams schickt eine Anfrage an HdxTeams zu diversen unterstützten Anrufparametern (Codecs, Auflösungen usw.). Dies wird auch als Angebot des Protokolls SDP (Session Description Protocol) bezeichnet. Die Anrufparameter werden dann über den Signalpfad an die Teams-Dienste in Office 365 und von dort an den anderen Peer weitergeleitet.
  9. SDP-Angebot/Antwort (Single-Pass-Verfahren) erfolgt über den Signalkanal, und die ICE-Konnektivitätsprüfungen werden abgeschlossen (Netzwerkadressübersetzung und Firewalldurchquerung durch Bindungsanfragen für STUN (Session Traversal Utilities for NAT)). Anschließend erfolgt der Medienfluss per SRTP (Secure Real-Time Transport Protocol) direkt zwischen HdxTeams.exe und dem anderen Peer (oder Office 365-Konferenzservern im Falle einer Besprechung).

Überlegungen zu Firewalls

Wenn Benutzer zum ersten Mal einen optimierten Anruf mit dem Microsoft Teams-Client initiieren, wird möglicherweise eine Warnung mit den Windows-Firewalleinstellungen angezeigt. In der Warnung werden Benutzer aufgefordert, die Kommunikation für HdxTeams.exe (HDX Overlay Teams) zuzulassen.

Firewall-Warnung

Die folgenden vier Einträge werden unter Eingehende Regeln in der Konsole Windows Defender Firewall > Erweiterte Sicherheit hinzugefügt. Sie können auf Wunsch restriktivere Regeln anwenden.

Eingehende Firewall-Regeln

Citrix SD-WAN: optimierte Netzwerkkonnektivität für Microsoft Teams

Eine optimale Audio- und Videoqualität erfordert eine Netzwerkverbindung zur Office 365-Cloud mit geringer Latenz, wenig Jitter und geringem Paketverlust. Wenn Citrix Workspace App-Benutzer in Zweigstellen für den Microsoft Teams-RTP-Datenverkehr (Audio/Video) einen Backhaul zum Datencenter benötigen, bevor sie ins Internet gehen, kann dies zu übermäßiger Latenz und zur Überlastung von WAN-Verbindungen führen. Citrix SD-WAN optimiert die Konnektivität für Microsoft Teams gemäß den Netzwerkverbindungsprinzipien für Microsoft Office 365. Citrix SD-WAN verwendet die Microsoft REST-basierte Office 365-IP-Adresse samt Webdienst und naheliegender DNS, um den Microsoft Teams-Datenverkehr zu identifizieren, zu kategorisieren und zu steuern.

Breitband-Internetverbindungen von Unternehmen verzeichnen immer wieder Paketverluste, exzessiven Jitter und Ausfälle.

Citrix SD-WAN bietet zwei Lösungen, um die Audio-/Videoqualität in Microsoft Teams auch bei variabler oder verschlechterter Netzwerkintegrität zu erhalten.

  • Wenn Sie Microsoft Azure verwenden, bietet ein in Azure VNET bereitgestelltes virtuelles Gerät (Citrix SD-WAN-VPX) erweiterte Möglichkeiten zur Konnektivitätsoptimierung. Dazu gehören ein Seamless-Link-Failover und “Packet Racing” für Audiopakete.
  • Alternativ können Citrix SD-WAN-Kunden sich über den Citrix Cloud Direct-Dienst mit Office 365 verbinden. Dieser Dienst bietet eine zuverlässige und sichere Bereitstellung für den gesamten Datenverkehr ins Internet.

Bei guter Qualität der Internetverbindung der Zweigstelle reicht es möglicherweise aus, die Latenz zu minimieren, indem der Microsoft Teams-Datenverkehr direkt vom Citrix SD-WAN-Zweigstellengerät zur nächstgelegenen Office 365-Frontdoor geleitet wird. Weitere Informationen finden Sie unter Citrix SD-WAN Office 365-Optimierung.

Citrix SD-WAN

Katalogansicht und aktive Sprecher in Microsoft Teams

In Besprechungen oder Gruppenanrufen wird nur ein eingehender Videostream unterstützt. Wenn mehrere Teilnehmer ihr Video senden, wird stets nur das Video des aktiven Sprechers angezeigt. Wenn ein Sprecher als aktiv erkannt wurde, kann es einen Moment dauern, bis der Videofeed angezeigt wird.

Bildschirmfreigabe in Microsoft Teams

Microsoft Teams verwendet die videobasierte Bildschirmfreigabe (VBSS), um den freigegebenen Desktop mit Videocodecs wie H264 zu codieren und einen High-Definition-Stream zu erstellen. Bei der HDX-Optimierung wird die eingehende Bildschirmfreigabe als Videostream behandelt. Wenn Sie sich in einem laufenden Videoanruf befinden und der andere Peer seinen Desktop freigibt, wird der Videofeed der ersten Kamera angehalten und stattdessen der Videofeed der Bildschirmfreigabe angezeigt. Der Peer muss die Kamerafreigabe dann manuell fortsetzen.

Die ausgehende Bildschirmfreigabe ist ebenfalls optimiert und in die Citrix Workspace-App (Version 1907 oder höher) ausgelagert. In diesem Fall erfasst und überträgt HdxTeams.exe nur das Fenster des Citrix Desktop Viewer (CDViewer.exe). Wenn Sie eine lokale Anwendung freigeben möchten, die auf Ihrem Clientcomputer ausgeführt wird, können Sie sie über CDViewer legen, und sie wird ebenfalls erfasst.

Multimonitoranzeige: Wenn CDViewer im Vollbildmodus ausgeführt wird und die Anzeige sich über mehrere Monitore erstreckt, wird nur der primäre Monitor freigegeben. Benutzer müssen die gewünschte Anwendung im virtuellen Desktops auf den primären Monitor ziehen, damit der andere Gesprächsteilnehmer sie sehen kann.

Bildschirmfreigabe

Hinweis:

Wenn Sie Teams als eigenständige Seamlessanwendung veröffentlichen, erfasst die Bildschirmfreigabe den lokalen Desktop Ihres physischen Endpunkts in der Citrix Workspace-App (ab Version 1909).

Peripheriegeräte in Microsoft Teams

Wenn die Optimierung für Microsoft Teams aktiv ist, greift die Citrix Workspace-App auf die Peripheriegeräte (Headset, Mikrofon, Kameras, Lautsprecher usw.) zu. Anschließend werden die Peripheriegeräte ordnungsgemäß in der Benutzeroberfläche von Microsoft Teams (Einstellungen > Geräte) enumeriert.

Optimierungsmodus für Microsoft Teams

Microsoft Teams greift nicht direkt auf die Geräte zu. Stattdessen verwendet es HdxTeams.exe, um die Medien zu erfassen, aufzuzeichnen und zu verarbeiten. Microsoft Teams listet die Geräte auf, die der Benutzer auswählen kann.

Empfehlungen:

  • Microsoft Teams-zertifizierte Headsets mit integrierter Echounterdrückung. Bei Konfigurationen mit mehreren Peripheriegeräten, bei denen sich Mikrofon und Lautsprecher in separaten Geräten befinden, kann es zu einem Echo kommen. Dies können zum Beispiel eine Webcam mit integriertem Mikrofon und ein Bildschirm mit Lautsprechern sein. Wenn Sie externe Lautsprecher verwenden, stellen Sie sie so weit wie möglich entfernt vom Mikrofon und von jeder Oberfläche, die den Ton auf das Mikrofon lenken könnte, auf.
  • Microsoft Teams-zertifizierte Kameras, auch wenn Skype for Business-zertifizierte Peripheriegeräte mit Microsoft Teams kompatibel sind.
  • Eine Entlastung des Hauptprozessors durch Onboard-H.264-Codierung der Webcams (UVC 1.1 und 1.5) kann HdxTeams.exe nicht nutzen.

Hinweis:

HdxTeams.exe unterstützt nur diese spezifischen Audiogeräteformate (Kanäle, Bit-Tiefe und Abtastrate):

  • Wiedergabegeräte: bis zu 2 Kanäle, 16 Bit, Frequenzen bis 48.000 Hz
  • Aufnahmegeräte: bis zu 3 Kanäle, 16 Bit, Frequenzen bis 48.000 Hz

Wenn ein Lautsprecher oder Mikrofon nicht mit den erwarteten Einstellungen übereinstimmt, schlägt die Geräteaufzählung in Teams fehl und unter Einstellungen > Geräte wird Keine angezeigt. Um dieses Problem zu umgehen, öffnen Sie in der Systemsteuerung die Option Sound (mmsys.cpl), wählen das Wiedergabe- oder Aufnahmegerät, gehen zu Eigenschaften > Erweitert und wählen einen unterstützten Modus. Alternativ können Sie das spezifische Gerät auch deaktivieren.

Die HDX-Technologien können für die Zuordnung von Peripheriegeräten eine der folgenden Methoden verwenden:

  • Optimierung für Microsoft Teams (empfohlener Modus).
  • Wenn Microsoft Teams nicht im optimierten VDI-Modus geladen werden kann, verwendet der VDA ältere HDX-Technologien Webcamumleitung und Audio- und Mikrofonumleitung des Clients. Im nicht optimierten Modus werden die Peripheriegeräte dem VDA zugeordnet. Die Peripheriegeräte werden in der Microsoft Teams-App so angezeigt, als wären sie lokal an den virtuellen Desktop angeschlossen.

    Um festzustellen, ob Sie sich im optimierten oder nicht optimierten Modus befinden, sehen Sie sich auf der Registerkarte Einstellungen > Geräte in Teams den Kameranamen an. Wenn Microsoft Teams im nicht optimierten Modus geladen werden, starten ältere HDX-Technologien. Der Webcam-Name hat das Suffix Citrix HDX, wie in der folgenden Grafik dargestellt. Die Lautsprecher- und Mikrofongerätenamen können sich geringfügig vom optimierten Modus unterscheiden (oder gekürzt angezeigt werden).

Deoptimierungsmodus für Microsoft Teams

Wenn ältere HDX-Technologien verwendet werden, werden die Audio-, Video- und Bildschirmfreigabeverarbeitung von Microsoft Teams nicht auf die WebRTC Media Engine der Citrix Workspace-App des Endpunkts übertragen. Stattdessen verwenden HDX-Technologien serverseitiges Rendering. Erwarten Sie einen hohen CPU-Verbrauch auf dem VDA, wenn Sie Video einschalten. Die Echtzeitaudioleistung ist möglicherweise nicht optimal.

Bekannte Einschränkungen

  • Katalogansicht - nur aktiver Sprecher.
  • HID-Schaltflächen - “Antworten” und “Anruf beenden” werden nicht unterstützt. Der Lautstärkeregler (lauter/leiser) wird unterstützt.
  • Wenn Sie während des Anrufs die periphere Ein- und Ausgabe wechseln (unter Einstellungen > Geräte), kann der Ton für eine Sekunde gestört sein.
  • Bei einer Bildschirmfreigabe im Multimonitormodus wird nur der Hauptmonitor freigegeben.

Überwachen von Teams

Dieser Abschnitt enthält Richtlinien zum Überwachen der Microsoft Teams-Optimierung mit HDX. Wenn der Benutzer im optimierten Modus ausgeführt wird und auf dem Clientcomputer HdxTeams.exe ausgeführt wird, wird in der Sitzung der VDA-Prozess WebSocketAgent.exe ausgeführt. Verwenden Sie den Aktivitätsmanager in Director, um die Anwendung anzuzeigen.

Überwachen von Teams im Aktivitätsmanager

Mit dem VDA (Mindestversion 1912) können Sie in Teams aktive Anrufe mit Citrix HDX Monitor (Mindestversion 3.11) überwachen. Das ISO-Image von Citrix Virtual Apps and Desktops enthält die neueste Version von hdxmonitor.msi im Ordner layout\image-full\Support\HDX Monitor.

Weitere Informationen finden Sie im Knowledge Center-Artikel CTX253754 unter Monitoring.

Problembehandlung

Dieser Abschnitt enthält Tipps zur Behandlung von Problemen, die bei der Verwendung der Optimierung für Microsoft Teams auftreten können. Weitere Informationen finden Sie in CTX253754.

Virtual Delivery Agent

Von BCR_x64.msi werden vier Dienste installiert. Nur zwei sind für die Microsoft Teams- Umleitung auf dem VDA verantwortlich.

Vier von der Browserinhaltsumleitung installierte Dienste

  • Citrix HDX Teams Redirection Service richtet den virtuellen Kanal ein, der in Microsoft Teams verwendet wird. Der Dienst basiert auf CtxSvcHost.exe.

  • Citrix HDX HTML5 Video Redirection Service wird als WebSocketService.exe ausgeführt und überwacht 127.0.0.1:9002 TCP. WebSocketService.exe führt zwei Hauptfunktionen aus:

    i. TLS termination for secure WebSockets empfängt eine sichere WebSocket-Verbindung von vdiCitrixPeerConnection.js, einer Komponente in der Microsoft Teams-App. Sie können sie mit der Prozessüberwachung verfolgen. Weitere Informationen zu Zertifikaten finden Sie im Abschnitt “TLS- und HTML5-Videoumleitung und Browserinhaltsumleitung” unter Kommunikation zwischen Controller und VDA.

    Einige Antiviren- und Desktop-Sicherheitsprogramme beeinträchtigen die Funktion von WebSocketService.exe und zugehörigen Zertifikaten. Während der eigentliche Dienst (Citrix HDX HTML5-Videoumleitung) in der Konsole von services.msc möglicherweise ausgeführt wird, ist der Localhost-TCP-Socket 127.0.0.1:9002 nie im Listener-Modus, wie in netstat zu sehen ist. Beim versuchten Neustart des Diensts hört er auf zu reagieren (“Stopping…”). Stellen Sie sicher, dass Sie die richtigen Ausschlussbedingungen für den Prozess WebScoketService.exe verwenden.

    Prozessüberwachung

    ii. Benutzersitzungszuordnung. Wenn die Anwendung Microsoft Teams startet, startet WebSocketService.exe den Prozess WebSocketAgent.exe in der Benutzersitzung auf dem VDA. WebSocketService.exe wird in Sitzung 0 als LocalSystem-Konto ausgeführt.

    WebSocketAgent.exe-Dienst

    Sie können mit netstat überprüfen, ob der WebSocketService.exe-Dienst auf dem VDA aktiv überwacht.

    Führen Sie mit erhöhten Rechten an der Eingabeaufforderung netstat -anob -p tcp aus:

    Beispiel für das Ausführen von netstat

    Bei einer erfolgreichen Verbindung ändert sich der Status in ESTABLISHED:

    Beispiel für Erfolg bei netstat

Wichtig:

WebSocketService.exe überwacht die beiden TCP-Sockets 127.0.0.1:9001 und 127.0.0.1:9002. Port 9001 wird für die Browserinhaltsumleitung und die HTML5-Videoumleitung verwendet. Port 9002 wird für die Microsoft Teams-Umleitung verwendet. Stellen Sie sicher, dass das Windows-Betriebssystem des VDA keine Proxykonfigurationen enthält, die eine direkte Kommunikation zwischen Teams.exe und WebSocketService.exe verhindern. Wenn Sie einen expliziten Proxy in Internet Explorer 11 konfigurieren (Internetoptionen > Verbindungen > LAN-Einstellungen > Proxyserver), können Verbindungen eventuell über einen zugewiesenen Proxyserver laufen. Stellen Sie sicher, dass Proxyserver für lokale Adressen umgehen aktiviert ist, wenn Sie eine manuelle und explizite Proxyeinstellung verwenden.

Speicherorte und Beschreibung der Dienste

Service Pfad zur ausführbaren Datei Anmelden als Beschreibung
Citrix HTML5-Videoumleitungsdienst “C:\Programme (x86)\Citrix\System32\WebSocketService.exe” /service Lokales Systemkonto Bietet mehrere HDX Multimedia-Dienste mit dem Framework, das für die Durchführung der Medienumleitung zwischen dem virtuellen Desktop und dem Endgerät erforderlich ist.
Citrix HDX-Browserumleitungsdienst “C:\Programme (x86)\Citrix\System32\CtxSvcHost.exe” -g BrowserRedirSvcs Dieses Konto (lokaler Dienst) Ermöglicht die Browserinhaltsumleitung zwischen dem Endpunktgerät und dem virtuellen Desktop.
Citrix Portweiterleitungsdienst “C:\Programme (x86)\Citrix\System32\CtxSvcHost.exe” -g PortFwdSvcs Dieses Konto (lokaler Dienst) Ermöglicht die Portweiterleitung zwischen dem Endpunktgerät und dem virtuellen Desktop für die Browserinhaltsumleitung.
Citrix HDX-Teams-Umleitungsdienst “C:\Programme (x86)\Citrix\System32\CtxSvcHost.exe” -g TeamsSvcs Lokales Systemkonto Ermöglicht die Microsoft Teams-Umleitung zwischen dem Endpunktgerät und dem virtuellen Desktop.

Citrix Workspace-App

Auf dem Endpunkt des Benutzers instanziiert die Citrix Workspace-App für Windows einen neuen Dienst namens HdxTeams.exe. Dies geschieht, wenn Microsoft Teams auf dem VDA gestartet wird und der Benutzer versucht, in der Eigenvorschau einen Anruf zu tätigen oder auf Peripheriegeräte zuzugreifen. Wenn dieser Dienst nicht angezeigt wird, überprüfen Sie Folgendes:

  1. Die Workspace-App Version 1905 für Windows wurde installiert. Enthält der Installationspfad der Workspace-App HDXTeams.exe und die webrpc.dll-Binärdateien?
  2. Wenn Sie Schritt 1 überprüft haben, gehen Sie folgendermaßen vor, um zu prüfen, ob HDXTeams.exe gestartet wird.
    1. Beenden Sie Microsoft Teams auf dem VDA.
    2. Starten Sie services.msc auf dem VDA.
    3. Beenden Sie den Citrix HDX-Teams-Umleitungsdienst.
    4. Trennen Sie die ICA-Sitzung.
    5. Verbinden Sie die ICA-Sitzung.
    6. Starten Sie den Citrix HDX-Teams-Umleitungsdienst.
    7. Starten Sie den Citrix HDX HTML5-Videoumleitungsdienst neu.
    8. Starten Sie Microsoft Teams auf dem VDA.
  3. Wird HDXTeams.exe auf dem Clientendpunkt immer noch nicht gestartet, gehen Sie wie folgt vor:
    1. Starten Sie den VDA neu.
    2. Starten Sie den Clientendpunkt neu.

Support

Citrix und Microsoft unterstützen gemeinsam die Bereitstellung von Microsoft Teams über Citrix Virtual Apps and Desktops mithilfe der Optimierung für Microsoft Teams. Diese gemeinsame Unterstützung ist das Ergebnis einer engen Zusammenarbeit zwischen den beiden Unternehmen. Wenn Sie gültige Supportverträge haben und ein Problem mit dieser Lösung auftritt, öffnen Sie ein Supportticket bei dem Anbieter, in dessen Code Sie die Ursache des Problems vermuten. Das heißt, Microsoft für Teams und Citrix für die Optimierungskomponenten.

Citrix oder Microsoft erhält das Ticket, untersucht das Problem und übergibt es an das zuständige Team. Sie müssen sich nicht an das Supportteam beider Unternehmen wenden.

Bei Problemen empfehlen wir, in der Teams-Benutzeroberfläche auf Hilfe > Problem melden zu klicken. VDA-seitige Protokolle werden automatisch zwischen Citrix und Microsoft geteilt, um technische Probleme schneller zu beheben.

Sammeln von Protokollen

Protokolle für HDXTeams.exe finden Sie auf der Benutzermaschine im Ordner HDXTeams (AppData/Local/Temp/HDXTeams). Suchen Sie die TXT-Datei webrpc_Day_Month_timestamp_Year.txt.

Beim Einrichten eines Anrufs sind folgende vier ICE-Phasen erforderlich:

  • Sammeln der Kandidaten
  • Austausch der Kandidaten
  • Konnektivitätsprüfungen (STUN-Bind-Anforderungen)
  • Einstufung der Kandidaten

In den Protokollen für HdxTeams.exe sind die folgenden Einträge für ICE (Interactive Connectivity Establishment) relevant: Diese Einträge müssen vorhanden sein, damit ein Anruf erfolgreich eingerichtet wird (siehe Beispielausschnitt für Sammelphase):

RPCStubs Info: -> device id = \\?\display#int3470#4&1835d135&0&uid13424#{65e8773d-8f56-11d0-a3b9-00a0c9223196}{bf89b5a5-61f7-4127-a279-e187013d7caf} label = Microsoft Camera Front groupId =

webrtcapi.RTCPeerConnection Info: createOffer. audio = 1 video = 1
webrtcapi.RTCPeerConnection Info: setLocalDescription.
>>> begin:sdp
[…]

webrtcapi.RTCPeerConnection Info: OnSignalingChange. signaling state = HaveLocalOffer

webrtcapi.RTCPeerConnection Info: OnIceGatheringChange. state = Gathering

[…]
>>> begin:sdp
candidate:840548147 1 udp 2122194687 10.108.124.215 56927 typ host generation 0 ufrag oVk6 network-id 1
<<< end:sdp
[…]
>>> begin:sdp
candidate:1938109490 1 udp 24911871 52.114.xxx.xxx 52786 typ relay raddr 73.205.xxx.x rport 25651 generation 0 ufrag dDML network-id 1 network-cost 10
<<< end:sdp
[…]
>>> begin:sdp
candidate:4271145120 1 udp 1685987071 66.xxx.xxx.xxx 55839 typ srflx raddr 10.108.124.215 rport 55839 generation 0 ufrag uAVH network-id 1
<<< end:sdp
[…]

webrtcapi.RTCPeerConnection Info: OnIceGatheringChange. state = Complete webrtcapi.RTCPeerConnection Info: setRemoteDescription.
>>> begin:sdp
[…]

webrtcapi.RTCPeerConnection Info: OnSignalingChange. signaling state = HaveRemotelOffer

Wenn mehrere ICE-Kandidaten vorhanden sind, lautet die Reihenfolge der Präferenz:

  1. Host
  2. Peer reflexiv
  3. Server reflexiv
  4. Transport-Relay

Wenn ein Problem auftritt und Sie es reproduzieren können, empfehlen wir, in Teams auf Hilfe > Problem melden zu klicken. Protokolle werden zwischen Citrix und Microsoft geteilt, um technische Probleme zu beheben, wenn Sie einen Supportfall bei Microsoft öffnen. Das Aufzeichnen von CDF-Traces vor der Kontaktaufnahme mit dem Citrix Support ist ebenfalls von Vorteil. Weitere Informationen finden Sie im Knowledge Center-Artikel CDFcontrol.

Empfehlungen zur Erzeugung von CDF-Tracingberichten finden Sie im Knowledge Center-Artikel Recommendations for Collecting the CDF Traces.

VDA-seitige CDF-Tracingberichte – aktivieren Sie die folgenden CDF-Trace-Anbieter:

VDA-seitige CDF-Tracingberichte

Workspace-App-seitige CDF-Tracingberichte – aktivieren Sie die folgenden CDF-Trace-Anbieter:

Workspace-App-seitige CDF-Tracingberichte