Configurazione e risoluzione dei problemi di CVI per i team Microsoft

Introduzione

In questo documento viene descritto come configurare e risolvere i problemi di integrazione video Cisco (CVI) con l'integrazione di Microsoft Teams (MS Teams).

Prerequisiti

Requisiti

Cisco raccomanda la conoscenza dei seguenti argomenti:

• Configurazione generale di Webex Control Hub
• Configurazione generale di Office 365 (O365)
• Configurazione dell'amministratore Web degli endpoint
• configurazione di Windows Power Shell
• Configurazione di Webex Edge per dispositivi

Componenti usati

Le informazioni fornite in questo documento si basano sulle seguenti versioni software e hardware:

• Sito di amministrazione di Office 365.
• Cisco WebEx Control Hub con licenza A-MST-WX-CVI-ROOM.
• Windows Power Shell versione 5.1.
• DX70 con Webex Edge per dispositivi.

Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.

Premesse

Porte richieste

Porte necessarie per la segnalazione:

Porte necessarie per i supporti:

Tipi di dispositivi supportati per un pulsante da premere (OBTP)

• Webex Board, Room e Dispositivi da scrivania.
• Webex Room Kit e Room Phone.
• Cisco serie MX, SX e DX.

Configurazione

Configurazione dell'integrazione video in Control Hub

Passaggio 1. Accedi a https://admin.webex.com.

Passaggio 2. PerPer verificare se il sottodominio è impostato per gli indirizzi SIP (Session Initiation Protocol) di Webex, selezionare Impostazioni organizzazione > Indirizzo SIP per Cisco Webex Calling.

Nota:se non è impostato, rivedere il documento successivo Modifica l'indirizzo SIP Cisco Webex.

Passaggio 3. Passare a Servizi > Ibrido. Individuare la scheda di integrazione video per i team Microsoft, quindi selezionare Configura. (è richiesta una licenza aggiuntiva).

Avviso: a questo punto è necessaria una licenza A-MST-WX-CVI-ROOM per fare ulteriori progressi.

Passaggio 4. Nella schermata Video Integration Setup, selezionare Authorize (Autorizza).

Passaggio 5. Selezionare l'account con privilegi di amministratore globale tenant Microsoft e immettere le credenziali.

Nota: l'utente di Microsoft deve eseguire l'autenticazione almeno due volte separate. È consigliabile che i passaggi vengano eseguiti da un amministratore di Microsoft il cui account disponga dell'accesso amministrativo completo a Control Hub.

Passaggio 6. Al fine diConvalidare le autorizzazioni richieste, selezionare Accetto. Questa concessioneL'applicazione Webex Video Integration accede al tenant Microsoft. Viene eseguito un reindirizzamento alla schermata Control Hub Video Integration Setup.

Passaggio 7. Aprire una finestra di PowerShell nel computer e installare il modulo MicrosoftTeams PowerShell, se non è già installato con il comando successivo:

Install-Module MicrosoftTeams -AllowClobber

Passaggio 8. Importare il modulo MicrosoftTeams e connettersi al tenant Teams con il comando successivo:

Import-Module MicrosoftTeams
Connect-MicrosoftTeams

Passaggio 9. Verrà visualizzata una pagina di accesso a Microsoft. Immettere le credenziali per l'utente con privilegi di amministrazione Microsoft Teams per il tenant. Se il processo ha esito positivo, viene fornito un feedback sull'account e sul tenant con cui è stato eseguito l'accesso.

Passaggio 10. Passare alla schermata di configurazione di Video Integration in Control Hub, selezionare il pulsante Appunti per copiare il testo della sezione New-CsVideoInteropServiceProvider, dal primo e incollarla nella sessione di PowerShell e confermare. 

Passaggio 11. Selezionare la modalità di abilitazione dell'integrazione per gli utenti. Utilizzare gli esempi come riferimento per l'integrazione per tutti gli utenti o per utente, come illustrato negli esempi seguenti:

Tutti gli utenti:

Grant-CsTeamsVideoInteropServicePolicy -PolicyName 
 CiscoServiceProviderEnabled -Global

Per utente:

Grant-CsTeamsVideoInteropServicePolicy -PolicyName 
CiscoServiceProviderEnabled -Identity

Passaggio 12. Selezionare OK per completare l'installazione.

Nota: le modifiche di PowerShell al tenant Microsoft possono richiedere tempo per la propagazione nell'ambiente Microsoft 365. Microsoft indica che questa operazione può richiedere fino a 6 ore, anche se in genere richiede meno di 20 minuti.

Passaggio 13. Se al termine della configurazione si accede al testo del comando di PowerShell, passare a Control Hub > Ibrido > Servizi > Integrazione video e selezionare Modifica impostazioni.

Risoluzione dei problemi

Caso 1. Il modulo di installazione dei comandi non è stato riconosciuto in Windows Power Shell.

Quando il comando Install-Module è configurato in Windows PowerShell, la console non riconosce alcuna variazione rispetto al comando:

Passaggio 1. Con un account Windows Admin, aprire Windows PowerShell ed eseguire il comando Get-Command sulla console per verificare se Install-Module è elencato come comando valido.

Passaggio 2. Se non è elencato, eseguire il comando Get-Host e convalidare la versione corrente di PowerShell:

Passaggio 3. Se la versione corrente di PowerShell è precedente alla 5.0, eseguire l'aggiornamento a qualsiasi versione supportata indicata nel documento Microsoft successivo: versione di PowerShell supportata da Install-Module.

Passaggio 4. Dopo l'aggiornamento, verificare un'altra volta che la versione viene aggiornata con il comando Get-Host.

Passaggio 5. Eseguire il comando Install-Module MicrosoftTeams -AllowClobber e confermare con il comando Y per continuare il normale processo di installazione.

Caso 2. Modulo di installazione comandi non riconosciuto in Windows PowerShell.

Anche con la versione corretta di PowerShell, il processo di download può avere esito negativo con un errore simile a quello illustrato nell'immagine seguente:

Passaggio 1. Eliminare qualsiasi problema di raggiungibilità dal server all'URL (Uniform Resource Locator). Copiare l'URL specificato nella finestra di PowerShell e incollarlo in un browser Web per convalidare la visualizzazione del contenuto.

Passaggio 2. Se la raggiungibilità non è un problema, può indicare che il problema è correlato alla versione del protocollo TLS (Transport Layer Security). Microsoft ha dichiarato obsolete le versioni 1.0 e 1.1 di TLS come indicato nel documento successivo: Microsoft TLS 1.0 and 1.1 Disablement Notice.

Passaggio 3. Per modificare la versione predefinita di PowerShell TLS, eseguire il comando seguente:

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

Passaggio 4. Eseguire il comando Install-Module MicrosoftTeams -AllowClobber e confermare con il comando Y per tentare il normale processo di installazione.

Passaggio 5. Confermare la seconda selezione con il comando Y per avviare il processo di download.

Passaggio 6. Verificare che il modulo Microsoft Teams sia installato, con il comando Get-InstalledModule, e procedere con il processo di distribuzione.

Caso 3. La riunione è pianificata ma non è visualizzata nel dispositivo.

Quando si pianifica una riunione nei team MS, i dettagli vengono visualizzati nell'invito, ma l'endpoint non mostra la riunione. 

La cassetta postale di Device Room viene visualizzata nell'elenco degli inviti alla riunione dei team Microsoft. Alcuni dettagli non sono configurati correttamente.

Anche Webex Control Hub non visualizza le informazioni sulla riunione.

Passaggio 1. Passare a O365 admin site https : admin . microsoft . com e accedere con un account admin.

Passaggio 2. Passare a Utenti > Menu Utenti attivi.

Passaggio 3. Individuare l'account utente dell'organizzatore della riunione ed espanderne i dettagli.

Passaggio 4. Passare alla sezione Licenze e app all'interno dei dettagli utente per trovare le licenze assegnate.

Passaggio 5. La licenza Microsoft Teams Exploratory deve essere assegnata per ogni utente su Office 365. Se non viene assegnato, i dettagli della riunione dei team MS non vengono inviati al calendario del dispositivo in Webex Control Hub.

Passaggio 6. Assegnare la licenza e il test.

Caso 4. La licenza di MS Teams è assegnata, ma la riunione non è ancora visualizzata sul dispositivo.

Anche dopo aver installato le licenze appropriate, la riunione non viene ancora visualizzata sul calendario del dispositivo con lo stesso banner da Webex Control Hub:

Passaggio 1. Andare sul sito https://admin.webex.com

Passaggio 2. Passare a Gestione > Aree di lavoro per individuare il dispositivo interessato nell'elenco. 

Passaggio 3. Aprire i dettagli del dispositivo e individuare la sezione Calendario. Convalidare l'indirizzo e-mail configurato per il dispositivo.

L'indirizzo e-mail assegnato al dispositivo deve corrispondere al nome visualizzato dell'area di lavoro del dispositivo in Control Hub e al nome utente e all'indirizzo e-mail in Configurazione utente O365. Se queste informazioni non corrispondono, l'hub di controllo non è in grado di identificare e inoltrare la riunione al dispositivo appropriato.

Nota: per questo campo non viene fatta distinzione tra maiuscole e minuscole. Tuttavia, deve corrispondere esattamente a qualsiasi altra lettera o simbolo.

Verifica

Esempio con registri da uno scenario valido:

Quando tutto è pronto e completamente operativo, l'implementazione funziona correttamente in tre diverse prospettive:

Il Calendario del dispositivo sull'hub di Webex Control visualizza la riunione pianificata con dettagli su Inizio, Fine, Durata e Organizzatore:

Il dispositivo mostra il pulsante singolo da premere, insieme all'icona MS Teams sul touch panel:

È inoltre possibile verificare questa condizione nel file All.log dai log degli endpoint. Di seguito sono riportate le informazioni disponibili.

Contiene l'istruzione calendar.meeting.create e un TrackingID univoco. MSTEAMS è elencato come tipo di riunione:

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"

Viene eseguito il push di un evento di aggiornamento da Webex all'endpoint:

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