Configuration et dépannage de CVI pour Microsoft Teams

Introduction

Ce document décrit comment configurer et dépanner l’intégration de Cisco Video Integration (CVI) avec l’intégration de Microsoft Teams (MS Teams).

Conditions préalables

Exigences

Cisco vous recommande de prendre connaissance des rubriques suivantes :

• Configuration générale de Webex Control Hub
• Configuration générale d'Office 365 (O365)
• Configuration de l'administrateur Web du terminal
• Configuration de Windows Power Shell
• Configuration de Webex Edge pour les périphériques

Composants utilisés

Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :

• Site d'administration O365
• Cisco WebEx Control Hub avec licence A-MST-WX-CVI-ROOMS
• Windows Power Shell version 5.1
• DX70 avec Webex Edge pour périphériques

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.

Informations générales

Ports requis

Ports requis pour la signalisation :

Ports requis pour les supports :

Types de périphériques pris en charge pour un seul bouton à enfoncer (OBTP)

• Périphériques WebEx Board, Room et Desktop
• Kit de salle Webex et téléphone de salle
• Gammes Cisco MX, SX et DX

Configuration

Configuration de l'intégration vidéo dans le Control Hub

Étape 1. Connexion au Webex Control Hub.

Étape 2. Pour vérifier si le sous-domaine est défini pour les adresses SIP (Session Initiation Protocol) Webex, accédez à Paramètres de l’organisation >Adresse SIP pour les appels Cisco Webex.

Remarque : Si ce n'est pas le cas, consultez le document suivant, Modifier votre adresse SIP Cisco Webex.

Étape 3. Accédez à Services >Hybrid. Recherchez la carte d'intégration vidéo pour Microsoft Teams, puis sélectionnez Configurer. (Une licence supplémentaire est requise).

Avertissement : À ce stade, une licence A-MST-WX-CVI-ROOMS est requise pour progresser.

Étape 4. Dans l'écran Video Integration Setup (Configuration de l'intégration vidéo), sélectionnez Authorize.

Étape 5. Sélectionnez le compte avec les privilèges Microsoft Tenant Global Administrator et entrez les informations d'identification.

Remarque : L'utilisateur Microsoft doit s'authentifier au moins deux fois. Il est recommandé que les étapes soient effectuées par un administrateur Microsoft dont le compte dispose d'un accès administrateur complet au Control Hub.

Étape 6. Afin de valider les autorisations demandées, sélectionnez Accept. Ces subventions L'application Webex Video Integration accède à votre locataire Microsoft. Une redirection vers l'écran Configuration de l'intégration vidéo du Control Hub a lieu.

Étape 7. Ouvrez une fenêtre PowerShell sur votre ordinateur et installez le module Microsoft Teams PowerShell s'il n'est pas déjà installé avec la commande suivante :

Install-Module MicrosoftTeams -AllowClobber

Étape 8. Importez le module Microsoft Teams et connectez-vous à votre client Teams à l'aide de la commande suivante :

Import-Module MicrosoftTeams
Connect-MicrosoftTeams

Étape 9. Une page de connexion Microsoft s’affiche. Entrez les informations d'identification de l'utilisateur disposant de privilèges d'administration Microsoft Teams pour le service partagé. Si le processus réussit, des commentaires sont fournis sur le compte et le locataire est correctement connecté.

Étape 10. Accédez à l'écran de configuration Video Integration dans Control Hub, sélectionnez le bouton Presse-papiers afin de copier le texte de la section New-CsVideoInteropServiceProvider, à partir de la première et collez-la dans la session PowerShell et confirmez. 

Étape 11. Sélectionnez le mode d'activation de l'intégration pour vos utilisateurs. Utilisez les exemples comme référence pour l'intégration de tous les utilisateurs ou par utilisateur, comme indiqué dans les exemples suivants :

Tous les utilisateurs:

Grant-CsTeamsVideoInteropServicePolicy -PolicyName 
 CiscoServiceProviderEnabled -Global

Par utilisateur :

Grant-CsTeamsVideoInteropServicePolicy -PolicyName 
CiscoServiceProviderEnabled -Identity

Étape 12. Sélectionnez Ok pour terminer la configuration.

Remarque : Les modifications PowerShell apportées au service partagé Microsoft peuvent prendre du temps à se propager dans l'environnement Microsoft 365. Microsoft indique que cette opération peut prendre jusqu'à 6 heures, bien qu'elle prenne généralement moins de 20 minutes.

Étape 13. Si l’accès au texte de la commande PowerShell après la configuration n’est pas terminé, accédez à Control Hub > Hybrid > Services > Video Integration et sélectionnez Edit settings.

Dépannage

Cas 1. Commande Install-Module non reconnue dans Windows Power Shell

Lorsque la commande Install-Module est configurée sur Windows PowerShell, aucune variante de la commande n'est reconnue par la console :

Étape 1. Avec un compte d'administrateur Windows, ouvrez Windows PowerShell et exécutez la commande Get-Command sur la console afin de valider si Install-Module est répertorié en tant que commande valide.

Étape 2. S’il n’est pas répertorié, exécutez la commande Get-Host et validez la version actuelle de PowerShell :

Étape 3. Si la version actuelle de PowerShell est antérieure à la version 5.0, effectuez une mise à niveau vers toute version prise en charge mentionnée dans le document Microsoft suivant : Install-Module Supported PowerShell version.

Étape 4. Après la mise à niveau, vérifiez une fois de plus que la version est maintenant mise à jour avec la commande Get-Host.

Étape 5. Exécutez la commande Install-Module MicrosoftTeams -AllowClobber, et confirmez avec la commande Y afin de poursuivre le processus d'installation normal.

Cas 2. Commande Install-Module non reconnue dans Windows PowerShell

Même avec la version PowerShell correcte, le processus de téléchargement peut échouer avec une erreur similaire à celle illustrée dans l'image suivante :

Étape 1 : élimination de tout problème d’accessibilité du serveur à l’URL (Uniform Resource Locator) Copiez l'URL spécifiée dans la fenêtre PowerShell et collez-la dans un navigateur Web afin de valider le contenu affiché.

Étape 2. Si l’accessibilité n’est pas un problème, cela peut signifier que le problème est lié à la version du protocole TLS (Transport Layer Security). Microsoft a déconseillé TLS versions 1.0 et 1.1 comme indiqué dans le document suivant : Microsoft TLS 1.0 et 1.1 Disablement Notice.

Étape 3. Afin de modifier la version PowerShell par défaut de TLS, exécutez la commande suivante :

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

Étape 4. Exécutez la commande Install-Module MicrosoftTeams -AllowClobber, et confirmez avec la commande Y afin de tenter le processus d'installation normal.

Étape 5. Confirmez la deuxième sélection avec la commande Y afin de démarrer le processus de téléchargement.

Étape 6. Confirmez que le module Microsoft Teams est installé à l'aide de la commande Get-InstalledModule, et poursuivez le processus de déploiement.

Cas 3. La téléconférence est planifiée mais n'est pas affichée sur le périphérique

Lorsque vous réservez une téléconférence sur Microsoft Teams, les détails sont affichés dans l'invitation, mais le point de terminaison n'affiche pas la téléconférence. 

La boîte aux lettres de la salle des périphériques apparaît dans l'invitation à la téléconférence Microsoft Teams. Certains détails ne sont pas configurés correctement.

Webex Control Hub n'affiche pas non plus les informations de téléconférence.

Étape 1. Accédez au site d’administration O365 https : admin. microsoft . et connectez-vous avec un compte d'administrateur.

Étape 2. Accédez au menu Utilisateurs > Utilisateurs actifs.

Étape 3. Localisez le compte utilisateur de l'organisateur de la téléconférence et développez ses détails.

Étape 4. Accédez à la section Licences et applications dans les détails de l'utilisateur afin de trouver les licences qui lui sont attribuées.

Étape 5. La licence Microsoft Teams Exploratory doit être attribuée à chaque utilisateur sur O365. Si ce n'est pas le cas, les détails de la réunion Microsoft Teams ne sont pas envoyés au calendrier du périphérique sur Webex Control Hub.

Étape 6. Attribution de la licence et test

Cas 4. La licence Microsoft Teams est attribuée, mais la téléconférence n'est toujours pas affichée sur le périphérique

Même une fois que les licences appropriées sont en place, la réunion n'est pas encore affichée dans le calendrier du périphérique avec la même bannière du Webex Control Hub :

Étape 1. Accédez à Webex Control Hub.

Étape 2. Accédez à Management > Workspaces, afin de trouver le périphérique affecté répertorié. 

Étape 3. Ouvrez les détails du périphérique et localisez la section Calendrier. Validez l'adresse e-mail configurée pour ce périphérique.

L'adresse e-mail attribuée au périphérique doit correspondre au nom d'affichage de l'espace de travail du périphérique sur le Control Hub, et au nom d'utilisateur et à l'adresse e-mail de la configuration utilisateur O365. Si ces informations ne correspondent pas, le Control Hub ne peut pas identifier et transférer la téléconférence au périphérique approprié.

Remarque : Ce champ ne respecte pas la casse. Cependant, il doit correspondre exactement à n'importe quelle autre lettre ou symbole.

Vérifier

Exemple avec les journaux d'un scénario viable :

Lorsque tout est en place et pleinement opérationnel, vous pouvez confirmer que la mise en oeuvre fonctionne correctement selon trois perspectives différentes :

Le calendrier du périphérique sur le concentrateur Webex Control affiche la téléconférence planifiée avec les détails de début, de fin, de durée et de l'organisateur :

L'écran Device (Périphérique) affiche le bouton One (Un bouton à appuyer), ainsi que l'icône Microsoft Teams (Équipes Microsoft) sur le panneau tactile :

En outre, cela peut être vérifié dans le fichier All.log à partir des journaux de point de terminaison. Vous pouvez voir les informations suivantes :

Il contient l'instruction calendar.meeting.create et un TrackingID unique. Microsoft Teams est répertorié en tant que type de téléconférence :

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"

Un événement de mise à jour de Webex est envoyé au point d'extrémité :

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

Historique de révision

Révision	Date de publication	Commentaires
6.0	19-May-2026	Mise en forme mise à jour, liens cochés, caractères gras et personnalisation
5.0	07-May-2025	Exigences de style et mise en forme mises à jour.
4.0	16-Apr-2024	Mise à jour SEO, Texte de remplacement et Mise en forme.
3.0	24-Feb-2023	Recertification
1.0	06-Jul-2021	Première publication