CVI für Microsoft-Teams konfigurieren und Fehlerbehebung dafür durchführen

Einleitung

Dieses Dokument enthält eine Beschreibung der Konfiguration und Fehlerbehebung von Cisco Video Integration (CVI) bei der Integration von Microsoft Teams (MS Teams).

Voraussetzungen

Anforderungen

Cisco empfiehlt, dass Sie über Kenntnisse in folgenden Bereichen verfügen:

• Allgemeine Konfiguration des WebEx Control Hubs
• Allgemeine Konfiguration von Office 365 (O365)
• Endpunkt-Webadministratorkonfiguration
• Windows Power Shell-Konfiguration
• Konfiguration von WebEx Edge für Geräte

Verwendete Komponenten

Die Informationen in diesem Dokument basierend auf folgenden Software- und Hardware-Versionen:

• O365-Verwaltungsstandort
• Cisco WebEx Control Hub mit Lizenz für A-MST-WX-CVI-ROOMS
• Windows Power Shell Version 5.1
• DX70 mit WebEx Edge für Geräte

Die Informationen in diesem Dokument beziehen sich auf Geräte in einer speziell eingerichteten Testumgebung. Alle Geräte, die in diesem Dokument benutzt wurden, begannen mit einer gelöschten (Nichterfüllungs) Konfiguration. Wenn Ihr Netzwerk in Betrieb ist, stellen Sie sicher, dass Sie die möglichen Auswirkungen aller Befehle kennen.

Hintergrundinformationen

Erforderliche Ports

Zur Signalisierung erforderliche Ports:

Für Medien erforderliche Ports:

Unterstützte Gerätetypen für One Button to Push (OBTP)

• WebEx-Mainboard-, Raum- und Schreibtischgeräte
• WebEx Raumkit und Raumtelefon
• Cisco MX-, SX- und DX-Serie

Konfiguration

Einrichten der Videointegration im Control Hub

Schritt 1: Melden Sie sich beim WebEx Control Hub an.

Schritt 2: Um zu überprüfen, ob die Subdomäne für WebEx Session Initiation Protocol (SIP)-Adressen festgelegt ist, navigieren Sie zu Organization Settings > SIP Address for Cisco WebEx Calling (Organisationseinstellungen > SIP-Adresse für Cisco WebEx-Anrufe).

Anmerkung: Ist sie nicht festgelegt, lesen Sie das nächste Dokument, Change Your Cisco WebEx SIP Address (Cisco WebEx SIP-Adresse ändern).

Schritt 3: Navigieren Sie zuServices >Hybrid. Suchen Sie die Video Integration Card für Microsoft Teams, und wählen Sie Einrichten aus. (Zusätzliche Lizenz erforderlich).

Warnung: Zu diesem Zeitpunkt ist eine A-MST-WX-CVI-ROOMS-Lizenz erforderlich, um weitere Fortschritte zu erzielen.

Schritt 4: Wählen Sie im Bildschirm "Video Integration Setup" die Option Authorize (Autorisieren).

Schritt 5: Wählen Sie das Konto mit den Berechtigungen Microsoft Tenant Global Administrator aus, und geben Sie die Anmeldeinformationen ein.

Anmerkung: Der Microsoft-Benutzer muss sich mindestens zwei Mal authentifizieren. Es wird empfohlen, die Schritte von einem Microsoft-Administrator auszuführen, dessen Konto über vollständigen Administratorzugriff auf Control Hub verfügt.

Schritt 6: Um die angeforderten Berechtigungen zu validieren, wählen Sie Akzeptieren. Diese Zuschüsse Die WebEx Video Integration-Anwendung greift auf Ihren Microsoft-Tenant zu. Eine Umleitung zum Bildschirm "Control Hub Video Integration Setup" erfolgt.

Schritt 7. Öffnen Sie ein PowerShell-Fenster auf Ihrem Computer, und installieren Sie das MicrosoftTeams PowerShell-Modul, falls es nicht bereits mit dem nächsten Befehl installiert wurde:

Install-Module MicrosoftTeams -AllowClobber

Schritt 8: Importieren Sie das MicrosoftTeams-Modul, und stellen Sie mit dem nächsten Befehl eine Verbindung mit dem Team-Tenant her:

Import-Module MicrosoftTeams
Connect-MicrosoftTeams

Schritt 9: Eine Microsoft-Anmeldeseite wird angezeigt. Geben Sie die Anmeldeinformationen für den Benutzer mit Microsoft Teams-Administratorberechtigungen für den Tenant ein. Wenn der Prozess erfolgreich verläuft, wird Feedback zum Konto gegeben, und der Tenant wird erfolgreich angemeldet.

Schritt 10. Navigieren Sie zum Setup-Bildschirm für die Videointegration im Control Hub, wählen Sie die Zwischenablage-Schaltfläche, um den Text des Abschnitts New-CsVideoInteropServiceProvider vom ersten in die PowerShell-Sitzung einfügen und bestätigen. 

Schritt 11: Wählen Sie aus, wie die Integration für Ihre Benutzer aktiviert werden soll. Verwenden Sie die Beispiele als Referenz für die Integration für alle Benutzer oder pro Benutzer, wie in den folgenden Beispielen gezeigt:

Alle Benutzer:

Grant-CsTeamsVideoInteropServicePolicy -PolicyName 
 CiscoServiceProviderEnabled -Global

Pro Benutzer:

Grant-CsTeamsVideoInteropServicePolicy -PolicyName 
CiscoServiceProviderEnabled -Identity

Schritt 12: Wählen Sie OK, um die Einrichtung abzuschließen.

Anmerkung: Die Übertragung von PowerShell-Änderungen an Microsoft Tenant kann in der Microsoft 365-Umgebung einige Zeit in Anspruch nehmen. Microsoft sagt, dass dies bis zu 6 Stunden dauern kann, obwohl es in der Regel weniger als 20 Minuten dauert.

Schritt 13: Wenn Sie nach Abschluss der Konfiguration nicht auf den PowerShell-Befehlstext zugreifen können, navigieren Sie zu Control Hub > Hybrid > Services > Video Integration, und wählen Sie Einstellungen bearbeiten aus.

Fehlerbehebung

Fall 1: Command Install-Modul wird in Windows Power Shell nicht erkannt

Wenn der Befehl Install-Module unter Windows PowerShell konfiguriert ist, erkennt die Konsole keine Abweichung vom Befehl:

Schritt 1: Öffnen Sie mit einem Windows-Administratorkonto Windows PowerShell, und führen Sie den Befehl Get-Command auf der Konsole aus, um zu überprüfen, ob Install-Module als gültiger Befehl aufgeführt ist.

Schritt 2. Falls er nicht aufgeführt ist, führen Sie den Befehl Get-Host aus und validieren Sie die aktuelle PowerShell-Version:

Schritt 3: Falls die aktuelle Version von PowerShell älter als 5.0 ist, aktualisieren Sie auf eine der unterstützten Versionen, die im nächsten Microsoft-Dokument "Install-Module Supported PowerShell version" erwähnt werden.

Schritt 4: Überprüfen Sie nach dem Upgrade noch einmal, ob die Version mit dem Befehl Get-Host aktualisiert wurde.

Schritt 5. Führen Sie den Befehl Install-Module MicrosoftTeams -AllowClobber aus, und bestätigen Sie ihn mit Y-Befehl, um mit dem regulären Installationsprozess fortzufahren.

Fall 2. Command Install-Modul in Windows PowerShell nicht erkannt

Selbst bei der richtigen PowerShell-Version kann der Download mit einem ähnlichen Fehler wie im folgenden Bild fehlschlagen:

Schritt 1: Verwerfen Sie alle Probleme mit der Erreichbarkeit vom Server zum Uniform Resource Locator (URL). Kopieren Sie die im PowerShell-Fenster angegebene URL, und fügen Sie sie in einen Webbrowser ein, um den Inhalt zu überprüfen.

Schritt 2: Wenn die Erreichbarkeit kein Problem darstellt, kann dies bedeuten, dass sich das Problem auf die TLS-Protokollversion (Transport Layer Security) bezieht. Microsoft hat die TLS-Versionen 1.0 und 1.1 nicht mehr unterstützt, wie im folgenden Dokument dargestellt: Microsoft TLS 1.0 und 1.1 Disablement Notice.

Schritt 3: Führen Sie den folgenden Befehl aus, um die PowerShell-Standardversion von TLS zu ändern:

[Net.ServicePointManager]::SecurityProtocol = Net.SecurityProtocolType]::Tls12

Schritt 4. Führen Sie den Befehl Install-Module MicrosoftTeams -AllowClobber aus, und bestätigen Sie ihn mit Y-Befehl, um den regulären Installationsvorgang zu starten.

Schritt 5. Bestätigen Sie die zweite Auswahl mit Y Befehl, um den Download-Prozess zu starten.

Schritt 6: Bestätigen Sie, dass das Microsoft Teams-Modul mit dem Befehl Get-InstalledModule installiert ist, und fahren Sie mit dem Bereitstellungsprozess fort.

Fall 3: Meeting ist geplant, wird aber nicht auf dem Gerät angezeigt

Wenn Sie ein Meeting in MS Teams planen, werden Details innerhalb der Einladung angezeigt. Das Meeting wird jedoch nicht auf dem Endpunkt angezeigt. 

Das Postfach im Geräteraum wird in der Microsoft Teams-Meeting-Einladung aufgeführt. Einige Details sind nicht richtig konfiguriert.

Meeting-Informationen werden im WebEx Control Hub ebenfalls nicht angezeigt.

Schritt 1: Navigieren Sie zur O365-Admin-Site https: Administrator Microsoft . und melden Sie sich mit einem Administratorkonto an.

Schritt 2: Navigieren Sie zum Menü Benutzer > Aktive Benutzer.

Schritt 3: Suchen Sie nach dem Meeting-Organisator-Benutzerkonto, und erweitern Sie dessen Details.

Schritt 4: Navigieren Sie in den Benutzerdetails zum Abschnitt "Lizenzen und Apps", um die zugewiesenen Lizenzen zu finden.

Schritt 5: Die Microsoft Teams Exploratory-Lizenz muss jedem Benutzer auf O365 zugewiesen werden. Falls dies nicht zugewiesen wird, werden die MS Teams-Meeting-Details nicht an den Gerätekalender auf dem WebEx Control Hub gesendet.

Schritt 6: Zuweisen der Lizenz und des Tests

Fall 4: MS Teams-Lizenz ist zugewiesen, Meeting wird jedoch immer noch nicht auf dem Gerät angezeigt

Selbst wenn die erforderlichen Lizenzen vorhanden sind, wird das Meeting noch nicht im Gerätekalender mit demselben Banner vom WebEx Control Hub angezeigt:

Schritt 1: Navigieren Sie zum WebEx Control Hub.

Schritt 2: Navigieren Sie zu Management > Workspaces, um das betroffene Gerät zu finden. 

Schritt 3. Öffnen Sie die Gerätedetails, und suchen Sie nach dem Abschnitt Kalender. Validieren Sie die für das Gerät konfigurierte E-Mail-Adresse.

Die dem Gerät zugewiesene E-Mail-Adresse muss mit dem Anzeigenamen des Arbeitsbereichs auf dem Control Hub und mit dem Benutzernamen und der E-Mail-Adresse in der O365-Benutzerkonfiguration übereinstimmen. Stimmen diese Informationen nicht überein, kann der Control Hub das Meeting nicht identifizieren und an das entsprechende Gerät weiterleiten.

Anmerkung: In diesem Feld wird nicht zwischen Groß- und Kleinschreibung unterschieden. Es muss jedoch mit jedem anderen Buchstaben oder Symbol übereinstimmen.

Überprüfung

Beispiel mit Protokollen aus einem realisierbaren Szenario:

Wenn alles eingerichtet und vollständig betriebsbereit ist, können Sie überprüfen, ob die Implementierung aus drei unterschiedlichen Perspektiven ordnungsgemäß funktioniert:

Der Gerätekalender auf dem WebEx Control Hub zeigt das geplante Meeting mit Details zu Beginn, Ende, Dauer und Organisator-Meeting an:

Das Gerät zeigt den One Button to Push (Eine Taste drücken) zusammen mit dem MS Teams-Symbol auf dem Bedienfeld an:

Darüber hinaus kann dies in der Datei All.log aus Endpunktprotokollen überprüft werden. Sie können die folgenden Informationen sehen:

Sie enthält die Anweisung calendar.meeting.create und eine eindeutige TrackingID. MSTEAMS wird als Meeting-Typ aufgeführt:

2021-07-02T15:51:49.571-05:00 appl[2073]: Wx2 I: NotificationChannel: calendar.meeting.create, trackingid ccc_d0965d59-34ea-437e-9c09-c621e871e873
2021-07-02T15:51:49.572-05:00 appl[2073]: Wx2[3]: CalendarClientImpl::on_meeting_updated_event
2021-07-02T15:51:49.573-05:00 appl[2073]: Wx2[1]: Inserting new meeting - organizer='7ad83eb6-549d-4282-86a4-bf3c05e4b6f3' start='2021-07-02T21:00:00.000Z' id='8fd64402-f665-6bd3-bf15-be436bbe2c97' meetingJoinType='MSTEAMS' meetingJoinURI=true meetingJoinURL=true webexURI=false spaceURI=false callURI=false"
new meeting - organizer='7ad83eb6-549d-4282-86a4-bf3c05e4b6f3' start='2021-07-02T21:00:00.000Z' id='8fd64402-f665-6bd3-bf15-be436bbe2c97' meetingJoinType='MSTEAMS' meetingJoinURI=true meetingJoinURL=true webexURI=false spaceURI=false callURI=false"

Ein Aktualisierungsereignis von WebEx wird an den Endpunkt weitergeleitet:

2021-07-02T15:51:49.579-05:00 appl[2073]: Wx2[5]: Creating new Meeting (id=2)
2021-07-02T15:51:49.579-05:00 appl[2073]: Wx2[5]: Attaching CalendarEvent (id=8fd64402-f665-6bd3-bf15-be436bbe2c97) to Meeting (id=2)
2021-07-02T15:51:49.579-05:00 appl[2073]: Wx2 I: Wx2MeetingsHandlerImpl::meetings_updated: num meetings=1