Inhalt

Einführung

Voraussetzungen

Anforderungen

Verwendete Komponenten

Hintergrundinformationen

Erforderliche Ports

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

Konfiguration

Einrichten der Videointegration im Control Hub

Fehlerbehebung

Überprüfung

Einführung

Dieses Dokument beschreibt die Konfiguration und Fehlerbehebung von Cisco Video Integration (CVI) mit Integration von Microsoft Teams (MS Teams).

Voraussetzungen

Anforderungen

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

- Allgemeine Konfiguration des WebEx Control Hub.

- Allgemeine Konfiguration von Office 365 (O365).

- Endpunkt-Webadmin-Konfiguration

- Konfiguration der Windows Power Shell.

- Konfiguration des WebEx Edge für Geräte

Verwendete Komponenten

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

- O365-Admin-Standort.

- Cisco WebEx Control Hub mit A-MST-WX-CVI-ROOMS-Lizenz

- 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 potenziellen Auswirkungen eines Befehls verstehen.

Hintergrundinformationen

Erforderliche Ports

Für die Signalisierung erforderliche Ports:

Für Medien erforderliche Ports:

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

- WebEx Board, Room und Desk-Geräte.

- WebEx Zimmerkit und Zimmertelefon.

- Cisco MX-, SX- und DX-Serien.

Konfiguration

Einrichten der Videointegration im Control Hub

Schritt 1: Anmelden bei https://admin.webex.com.

Schritt 2: In der ReihenfolgeUm 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.

Hinweis: Falls sie nicht festgelegt ist, lesen Sie das nächste Dokument Ändern der Cisco WebEx SIP-Adresse.

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

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

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

Schritt 5: Wählen Sie das Konto mit den Berechtigungen des globalen Microsoft Tenant-Administrators aus, und geben Sie die Anmeldeinformationen ein.

Hinweis: 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 vdie angeforderten Berechtigungen aktualisieren, wählen Sie Akzeptieren. Diese ZuschüsseWebEx Video Integration-Anwendung Zugriff auf Ihren Microsoft-Tenant. 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, wenn es nicht bereits mit dem nächsten Befehl installiert ist:

Install-Module MicrosoftTeams -AllowClobber

Schritt 8: Importieren Sie das MicrosoftTeams-Modul, und stellen Sie mit dem folgenden Befehl eine Verbindung zu Ihrem Team-Tenant her:

Import-Module MicrosoftTeams

Connect-MicrosoftTeams

Schritt 9: Eine Microsoft-Anmeldeseite wird angezeigt. Geben Sie die Anmeldeinformationen für den Benutzer mit den Administratorberechtigungen von Microsoft Teams für den Tenant ein. Wenn der Prozess erfolgreich ist, erhalten Sie Feedback zu dem Konto und dem Tenant, bei dem das Konto erfolgreich angemeldet wurde.

Schritt 10: Navigieren Sie zum Setup-Bildschirm für die Videointegration im Control Hub, und wählen Sie die Schaltfläche in der Zwischenablage aus, um den Text im New-CsVideoInteropServiceProvider-Abschnitt aus dem ersten Abschnitt zu kopieren. 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 jamie.smith@company.com

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

Hinweis: Die Weitergabe von PowerShell-Änderungen an Microsoft-Tenants in der Microsoft 365-Umgebung kann einige Zeit in Anspruch nehmen. Microsoft-Punkte können bis zu 6 Stunden in Anspruch nehmen, in der Regel jedoch weniger als 20 Minuten.

Schritt 13: Falls Sie nach Abschluss der Konfiguration auf den PowerShell-Befehlstext zugreifen, navigieren Sie zu Control Hub > Hybrid > Services > Video Integration und auswählen Einstellungen bearbeiten.

Fehlerbehebung

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

Wenn der Befehl Install-Module auf Windows PowerShell konfiguriert ist, wird von der Konsole keine Abweichung vom Befehl erkannt:

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 sie nicht aufgelistet ist, führen Sie den Befehl Get-Host aus und validieren Sie die aktuelle PowerShell-Version:

Schritt 3: Falls die aktuelle PowerShell-Version älter als 5.0 ist, aktualisieren Sie auf eine unterstützte Version, die im nächsten Microsoft-Dokument erwähnt wird: Install-Module Supported PowerShell-Version.

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

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

Fall 2. Command Install-Module wird in Windows PowerShell nicht erkannt.

Selbst mit der richtigen PowerShell-Version kann der Download-Prozess mit einem ähnlichen Fehler fehlschlagen, wie im nächsten Bild gezeigt:

Schritt 1: Entfernen 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 validieren.

Schritt 2: Wenn die Erreichbarkeit kein Problem darstellt, kann dies bedeuten, dass das Problem mit der Protokollversion von Transport Layer Security (TLS) zusammenhängt. Microsoft veraltete TLS-Versionen 1.0 und 1.1, wie im nächsten Dokument gezeigt: Hinweis zu Microsoft TLS 1.0 und 1.1.

Schritt 3: Führen Sie zum Ändern der TLS-Standardversion den folgenden Befehl aus:

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

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

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

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

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

Wenn Sie ein Meeting in MS-Teams ansetzen, werden Details in der Einladung angezeigt. Das Meeting wird jedoch nicht vom Endpunkt angezeigt.

Das Room-Postfach des Geräts wird in der Meeting-Einladung von Microsoft Teams angezeigt. Einige Details sind nicht korrekt konfiguriert.

WebEx Control Hub zeigt auch keine Meeting-Informationen an, wie im nächsten Bild gezeigt:

Schritt 1: Navigieren Sie zur O365-Admin-Site https://admin.microsoft.com, und melden Sie sich mit einem Administratorkonto an.

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

Schritt 3: Suchen Sie das Raumpostfach-Konto vom betreffenden Gerät aus, und erweitern Sie dessen Details.

Schritt 4: Navigieren Sie zum Abschnitt Lizenzen und Apps in den Mailbox-Benutzerdetails, um nach den zugewiesenen Lizenzen zu suchen.

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

Schritt 6: Weisen Sie die Lizenz zu, und testen Sie sie.

Fall 4. MS-Teams werden zwar Lizenzen zugewiesen, aber das Meeting wird immer noch nicht auf dem Gerät angezeigt.

Selbst nach der Installation der entsprechenden Lizenzen wird das Meeting noch nicht im Gerätekalender mit demselben Banner aus dem WebEx Control Hub angezeigt:

Schritt 1: Navigieren Sie zu admin.webex.com.

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

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

Die E-Mail-Adresse, die dem Gerät zugewiesen wurde, muss mit dem Workspace-Anzeigenamen des Geräts im Control Hub sowie Benutzername und E-Mail in der Konfiguration des O365 übereinstimmen. Falls diese Informationen nicht übereinstimmen, kann der Control Hub das Meeting nicht identifizieren und an das entsprechende Gerät weiterleiten.

Hinweis: In diesem Feld wird die Groß- und Kleinschreibung nicht unterschieden. Sie muss jedoch genau mit jedem anderen Buchstaben oder Symbol übereinstimmen.

Überprüfung

Beispiel mit Protokollen aus einem funktionierenden Szenario:

Wenn alles eingerichtet ist und vollständig betriebsbereit ist, können Sie die ordnungsgemäße Umsetzung in drei verschiedenen Perspektiven überprüfen:

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

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

Darüber hinaus kann dies in der All.log-Datei aus Endpunktprotokollen verifiziert werden, werden die folgenden Informationen angezeigt:

Sie enthält den Anweisungskalender.meeting.create und eine eindeutige TrackingID. MSTEAMS wird als Meeting-Typ aufgelistet:

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 Update-Ereignis von Webex wird an den Endpunkt gesendet:

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