Produktdokumentation
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
PDF anzeigen

Microsoft Teams überwachen, Fehler beheben und unterstützen

April 1, 2026
Beitrag von: 
C C

Teams überwachen

Dieser Abschnitt enthält Richtlinien zur Überwachung der Microsoft Teams-Optimierung mit HDX. Wenn Sie im optimierten Modus arbeiten und HdxRtcEngine.exe auf dem Clientgerät ausgeführt wird, läuft ein Prozess auf dem VDA namens WebSocketAgent.exe in der Sitzung. Verwenden Sie den Activity Manager in Director, um die Anwendung anzuzeigen.

Teams im Activity Manager überwachen

Der Optimierungsstatus von Microsoft Teams kann in Director auf der Seite Benutzerdetails > Bereich Sitzungsdetails > Feld MS Teams Optimization angezeigt werden. Die Optimierung von Microsoft Teams ist entscheidend für eine bessere Benutzererfahrung, wie z. B. klare Audio- und Videowiedergabe. Diese Funktion ist ab VDA-Version 2311 verfügbar. Unterstützte Versionen der Citrix Workspace™-App sind in der Optimierung für Microsoft Teams aufgeführt. Director zeigt den Status der Microsoft Teams-Optimierung nur an, wenn Microsoft Teams als veröffentlichte App oder innerhalb eines veröffentlichten Desktops ausgeführt wird.

Weitere Informationen finden Sie unter Microsoft Teams-Optimierungsstatus.

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

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

Fehlerbehebung

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

Auf dem Virtual Delivery Agent

Es gibt vier Dienste, die von BCR_x64.msi installiert werden. Nur zwei sind für die Microsoft Teams-Umleitung im VDA verantwortlich.

Vier von der Browserinhaltsumleitung installierte Dienste

  • Citrix HDX Teams Redirection Service stellt den in Microsoft Teams verwendeten virtuellen Kanal her. Der Dienst basiert auf CtxSvcHost.exe.

  • Citrix HDX HTML5 Video Redirection Service wird als WebSocketService.exe ausgeführt und lauscht auf 127.0.0.1:9002 TCP. WebSocketService.exe erfüllt zwei Hauptfunktionen:

    1. TLS-Terminierung für sichere WebSockets empfängt eine sichere WebSocket-Verbindung von vdiCitrixPeerConnection.js, einer Komponente innerhalb der Microsoft Teams-App. Sie können dies mit dem Process Monitor verfolgen. Weitere Informationen zu Zertifikaten finden Sie im Abschnitt TLS und HTML5-Videoumleitung sowie Browserinhaltsumleitung.

    Einige Antiviren- und Desktop-Sicherheitssoftware beeinträchtigt die ordnungsgemäße Funktion von WebSocketService.exe und seinen Zertifikaten. Obwohl der Citrix HDX HTML5 Video Redirection-Dienst in der services.msc-Konsole ausgeführt werden könnte, befindet sich der localhost 127.0.0.1:9002 TCP-Socket, wie in netstat zu sehen, nie im Listening-Modus. Der Versuch, den Dienst neu zu starten, führt dazu, dass er hängen bleibt (“Wird beendet…”). Stellen Sie sicher, dass Sie die entsprechenden Ausschlüsse für den WebSocketService.exe-Prozess anwenden.

    Prozessmonitor

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

    WebSocketAgent.exe-Dienst

    Sie können netstat verwenden, um zu überprüfen, ob der WebSocketService.exe-Dienst im VDA in einem aktiven Listening-Zustand ist.

    Führen Sie netstat -anob -p tcp in einem als Administrator ausgeführten Eingabeaufforderungsfenster aus:

    Netstat-Beispiel ausführen

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

    Erfolgreiches Netstat-Beispiel

Wichtig:

WebSocketService.exe lauscht an zwei TCP-Sockets, 127.0.0.1:9001 und 127.0.0.1:9002. Port 9001 wird für die Browserinhaltsumleitung und HTML5-Videoumleitung verwendet. Port 9002 wird für die Microsoft Teams-Umleitung verwendet. Stellen Sie sicher, dass im Windows-Betriebssystem des VDA keine Proxykonfigurationen vorhanden sind, die eine direkte Kommunikation zwischen Teams.exe und WebSocketService.exe verhindern könnten. Manchmal, wenn Sie einen expliziten Proxy in Internet Explorer 11 (Internetoptionen > Verbindungen > LAN-Einstellungen > Proxyserver) konfigurieren, können Verbindungen über einen zugewiesenen Proxyserver geleitet werden. Vergewissern Sie sich, dass Proxyserver für lokale Adressen umgehen aktiviert ist, wenn Sie eine manuelle und explizite Proxyeinstellung verwenden.

Dienstspeicherorte und Beschreibungen

Dienst Pfad zur ausführbaren Datei im Windows Server-Betriebssystem Anmelden als Beschreibung
Citrix HTML5 Video Redirection Service “C:\Program Files (x86)\Citrix\System32\WebSocketService.exe” /service Lokales Systemkonto Stellt mehreren HDX Multimedia-Diensten das anfängliche Framework zur Verfügung, das für die Medienumleitung zwischen dem virtuellen Desktop und dem Endpunktgerät erforderlich ist.
Citrix HDX Browser Redirection Service “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g BrowserRedirSvcs Dieses Konto (lokaler Dienst) Bietet Browserinhaltsumleitung zwischen dem Endpunktgerät und dem virtuellen Desktop.
Citrix Port Forwarding Service “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g PortFwdSvcs Dieses Konto (lokaler Dienst) Bietet Portweiterleitung zwischen dem Endpunktgerät und dem virtuellen Desktop für die Browserinhaltsumleitung.
Citrix HDX Teams Redirection Service “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g TeamsSvcs Lokales Systemkonto Bietet 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 oder HdxRtcEngine.exe. Dies geschieht, wenn Microsoft Teams im VDA gestartet wird und der Benutzer versucht, Anrufe zu tätigen oder auf die Peripheriegeräte in der Selbstvorschau zuzugreifen. Wenn Sie diesen Dienst nicht sehen, überprüfen Sie Folgendes:

  1. Stellen Sie sicher, dass Sie mindestens die Workspace-App Version 1905 für Windows installiert haben. Sehen Sie HdxTeams.exe oder HdxRtcEngine.exe und die webrpc.dll-Binärdateien im Installationspfad der Workspace-App?
  2. Wenn Sie Schritt 1 überprüft haben, führen Sie Folgendes aus, um zu prüfen, ob HdxTeams.exe oder HdxRtcEngine.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 Redirection Service.
    4. Trennen Sie die ICA®-Sitzung.
    5. Verbinden Sie die ICA-Sitzung.
    6. Starten Sie den Citrix HDX Teams Redirection Service.
    7. Starten Sie den Citrix HDX HTML5 Video Redirection Service neu.
    8. Starten Sie Microsoft Teams auf dem VDA.
  3. Wenn HdxTeams.exe oder HdxRtcEngine.exe auf dem Client-Endpunkt immer noch nicht gestartet wird, gehen Sie wie folgt vor:
    1. Starten Sie den VDA neu.
    2. Starten Sie den Client-Endpunkt neu.

Support

Citrix und Microsoft unterstützen gemeinsam die Bereitstellung von Microsoft Teams aus 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 Support-Ticket bei dem Anbieter, dessen Code Sie als Ursache des Problems vermuten. Das heißt, Microsoft für Teams oder Citrix für die Optimierungskomponenten. Citrix oder Microsoft nimmt das Ticket entgegen, priorisiert das Problem und eskaliert es bei Bedarf. Sie müssen nicht das Support-Team jedes Unternehmens kontaktieren.

Wenn Sie ein Problem haben, empfehlen wir Ihnen, 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.

Protokolle sammeln

HDX-Media-Engine-Protokolle finden Sie auf dem Computer des Benutzers (nicht auf dem VDA). Stellen Sie bei Problemen sicher, dass Sie die Protokolle Ihrem Supportfall beifügen.

Windows-Protokolle:

Sie finden Windows-Protokolle unter %TEMP% im Ordner HDXTeams (AppData/Local/Temp/HDXTeams oder AppData/Local/Temp/HdxRtcEngine). Suchen Sie nach einer .txt-Datei namens webrpc_Day_Month_timestamp_Year.txt. Wenn Sie neuere Versionen der Citrix Workspace-App verwenden, z. B. Citrix Workspace-App 2009.5 oder höher, speichern Sie die Protokolle unter AppData\Local\Temp\HdxRtcEngine.

Jede Sitzung erstellt einen separaten Ordner für Protokolle.

Mac-Protokolle:

  1. VDWEBRTC-Protokoll – zeichnet die Ausführung des virtuellen Kanals auf.

    Speicherort:/Users/<User Name>/Library/Logs/Citrix Workspace/CitrixViewer_<Y_M_D_H_M_S>.txt

  2. HdxRtcEngine-Protokoll – zeichnet die Ausführung der Prozesse auf HdxRtcEngine auf.

    Speicherort: $TMPDIR/hdxrtcengine/<W_M_D_H_M_S_Y>/hdxrtcengine.log

    Das HdxRtcEngine-Protokoll ist standardmäßig aktiviert.

  3. Webrpc-Protokolle – sind die wichtigsten Protokolle, die die Ausführung des Abschlusses der Webrtc-Bibliothek aufzeichnen.

    Speicherort: /Users/<USERNAME>/Library/Logs/HdxRtcEngine/<W_M_D_H_M_S_Y>/webrpc.log

Linux-Protokolle:

Sie finden Linux-Protokolle in den Ordnern /tmp/webrpc/<aktuelles Datum>/ und /tmp/hdxrtcengine/<aktuelles Datum>/. Webrtc-Protokoll: /tmp/webrpc/<aktuelles Datum>/webrtc.log Kernel-Protokoll: /var/log/syslog

ICE/STUN/TURN/-Protokolle:

Beim Aufbau eines Anrufs sind diese vier ICE-Phasen erforderlich:

  • Kandidatenerfassung
  • Kandidatenaustausch
  • Konnektivitätsprüfungen (STUN-Bindungsanfragen)
  • Kandidatenförderung

In den HdxRtcEngine.exe-Protokollen sind die folgenden Einträge die relevanten Interactive Connectivity Establishment (ICE)-Einträge. Diese Einträge müssen vorhanden sein, damit ein Anrufaufbau erfolgreich ist. Siehe das folgende Beispiel-Snippet für die Erfassungsphase:

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

<!--NeedCopy-->

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

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

Wenn Sie auf ein Problem stoßen und es konsistent reproduzieren können, empfehlen wir Ihnen, in Microsoft Teams auf Hilfe > Problem melden zu klicken. Protokolle werden zwischen Citrix und Microsoft geteilt, um technische Probleme zu beheben, wenn Sie einen Fall bei Microsoft eröffnet haben. Das Erfassen von CDF-Traces vor der Kontaktaufnahme mit dem Citrix Support ist ebenfalls vorteilhaft. Weitere Informationen finden Sie im Knowledge Center-Artikel CDFcontrol.

Empfehlungen zum Sammeln von CDF-Traces finden Sie im Knowledge Center-Artikel Empfehlungen zum Sammeln der CDF-Traces.

VDA-seitige CDF-Traces – Aktivieren Sie die folgenden CDF-Trace-Anbieter:

VDA-seitige CDF-Traces

Workspace-App-seitige CDF-Traces – Aktivieren Sie die folgenden CDF-Trace-Anbieter:

Workspace-App-seitige CDF-Traces

  • IcaClient_DriversVd_TeamsRedir (optional)
  • IcaClient_Multimedia_HdxTeams (erfordert Citrix Workspace-App 2012 oder höher)
Microsoft Teams überwachen, Fehler beheben und unterstützen
April 1, 2026
Beitrag von: 
C C
April 1, 2026
Beitrag von: 
C C

In diesem Artikel

Feedback zur Site | Your privacy choices footer linkIhre Datenschutzauswahl | Datenschutz und rechtliche Bestimmungen | Cookie-Einstellungen | Einstellungen für die Zustimmung | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.