Configuración y solución de problemas de CVI para equipos de Microsoft

Introducción

En este documento se describe cómo configurar y solucionar problemas de integración de video de Cisco (CVI) con la integración de Microsoft Teams (MS Teams).

Prerequisites

Requirements

Cisco recomienda que tenga conocimiento sobre estos temas:

• Configuración general de Webex Control Hub
• Configuración general de Office 365 (O365)
• Configuración de administración web de terminales
• configuración de Windows Power Shell
• Configuración de Webex Edge para dispositivos

Componentes Utilizados

La información que contiene este documento se basa en las siguientes versiones de software y hardware.

• Sitio de administración de O365
• Cisco WebEx Control Hub con licencia A-MST-WX-CVI-ROOMS
• Windows Power Shell versión 5.1
• DX70 con Webex Edge para dispositivos

La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.

Antecedentes

Puertos necesarios

Puertos necesarios para la señalización:

Puertos necesarios para los medios:

Tipos de dispositivos admitidos para que se presione un botón (OBTP)

• Dispositivos de mesa, sala y escritorio de Webex
• Kit de sala Webex y teléfono de sala
• Cisco serie MX, SX y DX

Configuración

Configuración de la integración de vídeo en Control Hub

Paso 1. Inicie sesión en Webex Control Hub.

Paso 2. Para verificar si el subdominio está configurado para las direcciones de protocolo de inicio de sesión (SIP) de Webex, navegue hasta Configuración de la organización > Dirección SIP para Cisco Webex Calling.

Nota: En caso de que no esté configurado, revise el siguiente documento, Cambiar la dirección SIP de Cisco Webex.

Paso 3. Navegue hastaServicios >Híbrido. Busque la tarjeta de integración de vídeo para Microsoft Teams y seleccione Configurar. (Se necesita una licencia adicional).

Advertencia: En este momento, se requiere la licencia A-MST-WX-CVI-ROOMS para poder avanzar más.

Paso 4. En la pantalla Video Integration Setup (Configuración de integración de vídeo), seleccione Authorize.

Paso 5. Seleccione la cuenta con los privilegios Microsoft Tenant Global Administrator e introduzca las credenciales.

Nota: El usuario de Microsoft debe autenticarse al menos dos veces por separado. Se recomienda que los pasos los realice un administrador de Microsoft cuya cuenta tenga acceso de administrador total al concentrador de control.

Paso 6. Para validar los permisos solicitados, seleccione Aceptar. Esto concede La aplicación Webex Video Integration accede a su arrendatario de Microsoft. Se redirige a la pantalla Control Hub Video Integration Setup (Configuración de integración de vídeo del concentrador de control).

Paso 7. Abra una ventana de PowerShell en el equipo e instale el módulo de Microsoft Teams PowerShell si aún no está instalado con el siguiente comando:

Install-Module MicrosoftTeams -AllowClobber

Paso 8. Importe el módulo Microsoft Teams y conéctese al arrendatario de Teams con el siguiente comando:

Import-Module MicrosoftTeams
Connect-MicrosoftTeams

Paso 9. Aparece una página de inicio de sesión de Microsoft. Introduzca las credenciales del usuario con privilegios de administración de Microsoft Teams para el arrendatario. Si el proceso es correcto, se proporciona información sobre la cuenta y el arrendatario ha iniciado sesión correctamente.

Paso 10. Navegue hasta la pantalla de configuración de Video Integration en Control Hub, seleccione el botón portapapeles para copiar el texto de la sección New-CsVideoInteropServiceProvider, desde la primera y pegarlo en la sesión de PowerShell y confirmarlo. 

Paso 11. Seleccione cómo desea habilitar la integración para los usuarios. Utilice los ejemplos como referencia para la integración de todos los usuarios o por usuario, como se muestra en los siguientes ejemplos:

Todos los usuarios:

Grant-CsTeamsVideoInteropServicePolicy -PolicyName 
 CiscoServiceProviderEnabled -Global

Por usuario:

Grant-CsTeamsVideoInteropServicePolicy -PolicyName 
CiscoServiceProviderEnabled -Identity

Paso 12. Seleccione Aceptar para completar la configuración.

Nota: Los cambios de PowerShell en el arrendatario de Microsoft pueden tardar en propagarse en el entorno de Microsoft 365. Microsoft afirma que esto puede tardar hasta 6 horas, aunque normalmente tarda menos de 20 minutos.

Paso 13. En caso de que no se haya completado el acceso al texto del comando de PowerShell después de la configuración, navegue hasta Control Hub > Hybrid > Services > Video Integration y seleccione Edit settings.

Troubleshoot

Caso 1. Command Install-Module no reconocido en Windows Power Shell

Cuando el comando Install-Module se configura en Windows PowerShell, la consola no reconoce ninguna variación del comando:

Paso 1. Con una cuenta de administrador de Windows, abra Windows PowerShell y ejecute el comando Get-Command en la consola para validar si Install-Module aparece como un comando válido.

Paso 2. En caso de que no aparezca en la lista, ejecute el comando Get-Host y valide la versión actual de PowerShell:

Paso 3. En caso de que la versión actual de PowerShell sea anterior a la 5.0, actualice a cualquier versión admitida mencionada en el siguiente documento de Microsoft: Install-Module Supported PowerShell version.

Paso 4. Después de la actualización, verifique una vez más que la versión se actualice ahora con el comando Get-Host.

Paso 5. Ejecute el comando Install-Module MicrosoftTeams -AllowClobber, y confirme con el comando Y para continuar con el proceso de instalación regular.

Caso 2. Command Install-Module no reconocido en Windows PowerShell

Incluso con la versión correcta de PowerShell, el proceso de descarga puede fallar con un error similar al que se muestra en la siguiente imagen:

Paso 1. Deseche cualquier problema de accesibilidad del servidor a la dirección URL (Localizador uniforme de recursos). Copie la dirección URL especificada en la ventana de PowerShell y péguela en un explorador web para validar que se muestra el contenido.

Paso 2. Si el alcance no es un problema, puede significar que el problema está relacionado con la versión del protocolo de seguridad de la capa de transporte (TLS). Microsoft desaprobó las versiones 1.0 y 1.1 de TLS, como se muestra en el siguiente documento: Microsoft TLS 1.0 y 1.1 Disablement Notice.

Paso 3. Para cambiar la versión predeterminada de PowerShell de TLS, ejecute el siguiente comando:

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

Paso 4. Ejecute el comando Install-Module MicrosoftTeams -AllowClobber, y confirme con el comando Y para intentar el proceso de instalación regular.

Paso 5. Confirme la segunda selección con el comando Y para iniciar el proceso de descarga.

Paso 6. Confirme que el módulo Microsoft Teams esté instalado con el comando Get-InstalledModule y continúe con el proceso de implementación.

Caso 3. La reunión está programada pero no se muestra en el dispositivo

Cuando se programa una reunión en Microsoft Teams, los detalles se muestran en la invitación; sin embargo, el terminal no muestra la reunión. 

El buzón de la sala de dispositivos aparece en la lista de la invitación a la reunión de Microsoft Teams; algunos detalles no están configurados correctamente.

Webex Control Hub tampoco muestra información de la reunión.

Paso 1. Navegue hasta O365 admin site https : admin. microsoft. com e inicie sesión con una cuenta de administrador.

Paso 2. Vaya al menú Users > Active Users.

Paso 3. Busque la cuenta de usuario de organizador de la reunión y expanda sus detalles.

Paso 4. Navegue hasta la sección Licencias y aplicaciones dentro de los detalles del usuario para encontrar las licencias asignadas a él.

Paso 5. Se debe asignar una licencia de Microsoft Teams Exploratory para cada usuario en O365. En caso de que no se asigne, los detalles de la reunión de Microsoft Teams no se envían al calendario del dispositivo en Webex Control Hub.

Paso 6. Asigne la licencia y realice la prueba.

Caso 4. La licencia de Microsoft Teams está asignada, pero la reunión sigue sin mostrarse en el dispositivo

Incluso después de haber instalado las licencias adecuadas, la reunión no se muestra todavía en el calendario del dispositivo con el mismo banner de Webex Control Hub:

Paso 1. Vaya a Webex Control Hub.

Paso 2. Navegue hasta Administración > Espacios de trabajo, para encontrar el dispositivo afectado enumerado. 

Paso 3. Abra los detalles del dispositivo y localice la sección Calendario. Valide la dirección de correo electrónico configurada para ese dispositivo.

La dirección de correo electrónico asignada al dispositivo debe coincidir con el nombre para mostrar del espacio de trabajo del dispositivo en el concentrador de control y con el nombre de usuario y el correo electrónico en la configuración de usuario de O365. En caso de que esta información no coincida, el centro de control no podrá identificar y reenviar la reunión al dispositivo adecuado.

Nota: Este campo no distingue entre mayúsculas y minúsculas. Sin embargo, debe coincidir exactamente con cualquier otra letra o símbolo.

Verificación

Ejemplo con registros de un escenario viable:

Cuando todo esté en su lugar y completamente operativo, puede validar que la implementación funciona correctamente desde tres perspectivas diferentes:

El calendario de dispositivos del hub de control Webex muestra la reunión programada con los detalles de Inicio, Fin, Duración y Organizador:

El dispositivo muestra el botón que hay que pulsar, junto con el icono de Microsoft Teams en el panel táctil:

Además, esto se puede verificar en el archivo All.log desde los registros de terminales. Puede ver la siguiente información:

Contiene la instrucción calendar.meeting.create y un identificador de seguimiento único. Microsoft Teams aparece como el tipo de reunión:

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 evento de actualización de Webex se envía al terminal:

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

Historial de revisiones

Revisión	Fecha de publicación	Comentarios
6.0	19-May-2026	Formato actualizado, vínculos comprobados, negrita y marca
5.0	07-May-2025	Requisitos de estilo actualizados y formato.
4.0	16-Apr-2024	SEO actualizado, texto alternativo y formato.
3.0	24-Feb-2023	Recertificación
1.0	06-Jul-2021	Versión inicial