Nueva solución de VDI para Teams

• Se aplica a:

  Microsoft Teams

La nueva solución VDI para Teams es una nueva arquitectura para optimizar la entrega de cargas de trabajo multimedia en escritorios virtuales.

Importante

Para participar en la versión preliminar pública, los administradores deben mover los usuarios al canal de vista previa pública como se describe en este artículo.

Para los clientes de Citrix, póngase en contacto con su gestor de cuentas de Microsoft para registrarse en la versión preliminar pública.

Components

Componente	Rol	Actualización	Tamaño	Notas
Nuevo vdiBridge de Teams	Módulo de canal virtual del lado servidor.	Nueva versión con cada nueva versión de Teams.	Incluido con el nuevo Teams.
Canal virtual personalizado (VC)	VC personalizado propiedad de Microsoft Teams.	API estable: no hay actualizaciones previstas.		Compruebe la lista de permitidos del canal virtual de directiva de Citrix Studio.
Complemento	Vc dll del lado cliente. Responsable también de la descarga y limpieza de SlimCore.	No es frecuente (lo ideal es que no se actualicen).	Aproximadamente 200 KB.	Incluido con el cliente de ESCRITORIO remoto 1.2.5405.0 o la aplicación de Windows 1.3.252 o superior. Citrix CWA 2402 o posterior puede capturar e instalar el complemento.
SlimCore	Motor multimedia (específico del sistema operativo, no específico del proveedor de VDI).	Se actualiza automáticamente a una nueva versión con cada nueva versión de Teams.	Aproximadamente 50 MB.	Paquete MSIX hospedado en la red CDN pública de Microsoft

Requisitos del sistema

Requisito	Versión mínima
Nuevo Teams	24124.2315.2911.3357 (para Azure Virtual Desktop/Windows 365) 24152.408.2949.8308 (para Citrix)
Azure Virtual Desktop/Windows 365	Aplicación de Windows: 1.3.252 Cliente de Escritorio remoto: 1.2.5405.0
Citrix	VDA: 2203 LTSR CU3 o 2305 CR Citrix Workspace App: 2203 LTSR (cualquier CU), 2402 LTSR o 2302 CR
Punto de conexión	Windows 10 1809 (requisito mínimo de SlimCore) Los GPO no deben bloquear las instalaciones de MSIX (consulte Paso 3: almacenamiento provisional y registro de MSIX de SlimCore en el punto de conexión) CPU mínima: Intel Celeron (o equivalente) @ 1,10 GHz, 4 núcleos, RAM mínima: 4 GB

Optimización con la nueva solución de VDI para Teams

Paso 1: Confirmar los requisitos previos

1. Asegúrese de que tiene la nueva versión de Microsoft Teams 24124.2311.2896.3219 o posterior (para Azure Virtual Desktop/Windows 365) y 24152.408.2949.8308 o posterior para Citrix.
2. Habilite la nueva directiva de Teams si es necesario para un grupo de usuarios específico (está habilitada de forma predeterminada a nivel global de toda la organización).
3. Para Citrix, debe configurar la lista de permitidos del canal virtual como se describe en la sección de la lista de permitidos del canal Citrix Virtual de este artículo.

Paso 2: Instalación de complementos en el punto de conexión

1. Para Azure Virtual Desktop y Windows 365, MsTeamsPluginAvd.dll se incluye con el cliente de Escritorio remoto para Windows 1.2.5405.0 o con la aplicación de la Tienda de aplicaciones de Windows 1.3.252 o posterior.

• El complemento se encuentra en la misma ubicación de carpeta donde está instalado el cliente de Escritorio remoto. Será AppData\Local\Apps\Remote Desktop o C:\Archivos de programa (x86), según el modo en el que se haya instalado.
• Para la aplicación de la Tienda de aplicaciones de Windows, ya que está basada en MSIX, se encuentra en C:\Archivos de programa\WindowsApps. El acceso a esta carpeta está restringido.

1. Para Citrix CWA 2402 o versiones posteriores, MsTeamsPluginCitrix.dll puede instalarse:

• Uso de la interfaz de usuario al instalar CWA: en la página de complementos , seleccione la casilla Instalar el complemento VDI de Microsoft Teams y, a continuación, seleccione Instalar. Acepta el acuerdo de usuario que aparece y continúa con la instalación de Citrix Workspace App.

Nota

Citrix Workspace App 2402 solo presenta la interfaz de usuario de instalación de complementos en una nueva instalación. Para que las actualizaciones locales también presenten esta opción, se requiere Citrix Workspace App 2405 o superior.

• A través de la línea de comandos o scripts para dispositivos administrados con: C:\>CitrixWorkspaceApp.exe installMSTeamsPlugin
• Los administradores también pueden instalar manualmente el complemento encima de cualquier CWA compatible existente (consulte Requisitos del sistema) mediante herramientas como SCCM (usar el tipo de implementación de paquetes de la aplicación de Windows) o Intune (usar la aplicación Línea de negocio). Los administradores pueden usar msiexec con marcas adecuadas, como se describe en esta documentación.

Importante

Puede encontrar el vínculo de descarga del plugin MSI para los clientes de Citrix aquí.

El msi de complemento detecta automáticamente la carpeta de instalación de CWA y coloca MsTeamsPluginCitrix.dll en esa ubicación:

Tipo de usuario	Carpeta de instalación	Tipo de instalación
Administrador	64 bits: C:\Archivos de programa (x86)\Citrix\ICA Client 32 bits: C:\Program Files\Citrix\ICA Client	Instalación por sistema
Usuario	%USERPROFILE%\AppData\Local\Citrix\ICA Client	Instalación por usuario

• Los plugins no se pueden degradar, solo se pueden actualizar o reinstalar (reparar).
• Si no se encuentra ninguna CWA en el punto de conexión, la instalación se detiene.

Paso 3: Almacenamiento provisional y registro de MSIX de SlimCore en el punto de conexión

El complemento ejecuta este paso de forma silenciosa, sin la intervención del usuario o el administrador. El almacenamiento provisional y el registro dependen del App Readiness Service (ARS) en el punto de conexión. Es posible que la instalación del paquete MSIX esté bloqueada por claves del Registro establecidas por una directiva de grupo o una herramienta de terceros. Para obtener una lista completa de las claves del Registro aplicables, consulta Cómo funciona la directiva de grupo con aplicaciones empaquetadas: MSIX.

Las siguientes claves del Registro podrían bloquear la instalación del nuevo paquete MSIX del motor multimedia:

• BlockNonAdminUserInstall
• AllowAllTrustedApps
• AllowDevelopmentWithoutDevLicense

Importante

Si AllowAllTrustedApps está deshabilitado, se produce un error en la instalación del nuevo motor multimedia (MSIX). Este problema se ha corregido en la KB5031455 de actualización acumulativa de octubre de Windows:

• Windows 10: 26 de octubre de 2023: KB5031445 (compilación del SO 19045.3636)
• Windows 11: 26 de octubre de 2023: KB5031455 (compilación del SO 22621.2506)

Si esta actualización opcional de octubre no está disponible para la compilación del sistema operativo, la actualización de seguridad de noviembre también incluye la corrección.

Estas tres claves del Registro pueden encontrarse en cualquiera de las siguientes ubicaciones del dispositivo del usuario:

• HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock
• HKLM\SOFTWARE\Policies\Microsoft\Windows\Appx

Algunas directivas pueden cambiar estas claves del Registro y bloquear la instalación de aplicaciones en su organización porque los administradores establecen una directiva restrictiva. Algunas de las directivas de GPO conocidas que podrían impedir la instalación son las siguientes:

• Impedir que los usuarios que no sean administradores instalen aplicaciones de Windows empaquetadas.
• Permitir la instalación de todas las aplicaciones de confianza (deshabilitadas).

Nota

AppLocker o el Control de aplicaciones de Windows Defender también pueden impedir la instalación de paquetes MSIX.

Importante

Asegúrate de que no haya ningún bloqueo en la configuración ni en la directiva, o agrega una excepción para los paquetes MSIX de SlimCore en Directiva de seguridad local-> Directivas de control de aplicaciones -> AppLocker.

Comprobar que el punto final está optimizado

Una vez que cumpla todos los requisitos mínimos, el inicio de nuevos Equipos por primera vez seguirá estando en modo optimizado WebRTC de forma predeterminada.

Importante

Para experiencias de primera ejecución, se necesitan dos reinicios de aplicaciones para obtener la nueva optimización.

Puede comprobar en el cliente de Teams que está optimizado con la nueva arquitectura yendo a los puntos suspensivos (tres puntos ...) en la barra superior y seleccionando Configuración > acerca de. Los equipos y las versiones de cliente se muestran allí.

El complemento (MsTeamsPluginAvd.dll o MsTeamsPluginCitrix.dll) es responsable de descargar finalmente el motor multimedia, y SlimCore, que es un paquete MSIX. Se instala en modo silencioso sin privilegios de administrador o se reinicia en (por ejemplo, la ruta exacta varía):

C:\Program Files\WindowsApps\Microsoft.Teams.SlimCoreVdi.win-x64.2024.15_2024.15.1.5_x64__8wekyb3d8bbwe

El cliente de escritorio remoto descarga el paquete x64 o x86 SlimCore y Citrix CWA descarga un paquete x86. Esta carpeta está bloqueada, por lo que los usuarios no tienen acceso a ella. Los administradores pueden tomar posesión modificando las ACL, aunque no se recomienda realizar esta acción. En su lugar, use PowerShell para enumerar las aplicaciones MSIX en el punto de conexión:

PowerShellCopy

Get-AppxPackage Microsoft.Teams.SlimCore*

Importante

Microsoft almacena hasta diez versiones de SlimCoreVdi por motivos de compatibilidad, y en caso de que el usuario tenga acceso a diferentes entornos VDI (como persistente, donde los nuevos Equipos se actualizan automáticamente y no son persistentes, donde se deshabilitan las nuevas actualizaciones automáticas de Teams).

Si está optimizado, puede ver MsTeamsVdi.exe ejecutándose en el punto de conexión de Azure Virtual Desktop/W365 o Citrix.

Si habilita el panel inferior y cambia a la pestaña DLL, también puede ver el complemento que se carga. Esta acción es un paso de solución de problemas útil en caso de que no estés obteniendo la nueva optimización.

Itinerancia y conexiones de sesión

El nuevo Teams carga WebRTC o SlimCore en el momento del lanzamiento. Si las sesiones de escritorio virtual están desconectadas (sin sesión iniciada, Teams se deja ejecutándose en la máquina virtual), los nuevos Equipos no podrán cambiar las pilas de optimización a menos que se reinicien. Como resultado, los usuarios podrían estar en modo de reserva (no optimizado) si se desplazan entre diferentes dispositivos que no admiten la nueva arquitectura de optimización (por ejemplo, un dispositivo MAC que se usa en BYOD mientras trabaja desde casa y un cliente fino administrado por la empresa en la oficina).

Opciones de volver a conectar	La optimización actual es WebRTC	La optimización actual es SlimCore
Volver a conectar desde un punto de conexión sin MsTeamsPlugin	Optimización clásica de WebRTC	Fallback (SlimCore local)
Volver a conectar desde un punto de conexión con MsTeamsPlugin	Optimización clásica de WebRTC	Nueva optimización basada en SlimCore

Consideraciones de redes

Nota

MsTeamsVdi.exe es el proceso que realiza todas las conexiones de red TCP/UDP a los servidores de retransmisión/conferencia de Teams u otros compañeros.

El manifiesto MSIX de SlimCore agregará las siguientes reglas al Firewall: <Rule Direction="in" IPProtocol="TCP" Profile="all" /><Rule Direction="in" IPProtocol="UDP" Profile="all" />

Asegúrese de que el dispositivo del usuario tiene conectividad de red (UDP y TCP) con el id. de punto de conexión 11, 12, 47 y 127 descrito en url de Microsoft 365 e intervalos de direcciones IP.

ID	Categoría	Sala de emergencias	Direcciones	Puertos	Notas
11	Optimizar los datos necesarios	Sí	13.107.64.0/18, 52.112.0.0/14, 52.122.0.0/15, 2603:1063::/38	UDP: 3478, 3479, 3480 y 3481	Procesadores multimedia y Relé de transporte 3478 (STUN), 347 (audio), 3480 (vídeo), 3481 (pantalla compartida)
12	Permitir obligatorio	Sí	*.lync.com, *.teams.microsoft.com, teams.microsoft.com 13.107.64.0/18, 52.112.0.0/14, 52.122.0.0/15, 52.238.119.141/32, 52.244.160.207/32, 2603:1027::/48, 2603:1037::/48, 2603:1047::/48, 2603:1057::/48, 2603:1063::/38, 2620:1ec:6::/48, 2620:1ec:40::/42	TCP: 443, 80
47	Valor predeterminado necesario	No	*.office.net	TCP: 443, 80	Se usa para descargas de SlimCore y efectos de fondo
127	Valor predeterminado necesario	No	*.skype.com	TCP: 443, 80

Arquitectura de red

Un tutorial de la arquitectura en el diagrama:

1. Inicie nuevos equipos.
2. El cliente de Teams se autentica a los servicios de Teams. Las directivas de inquilino se insertan en el cliente de Teams y las configuraciones relevantes se retransmiten a la aplicación.
3. Teams detecta que se está ejecutando en un entorno de escritorio virtual y crea una instancia del servicio interno de vdibridge.
4. Teams abre un canal virtual seguro en el servidor.
5. El protocolo RDP o HDX lleva la solicitud al cliente de RD o a la aplicación Citrix Workspace que cargó previamente MsTeamsPlugin (componente de canal virtual del lado cliente).
6. Rd Client o Citrix Workspace app genera un nuevo proceso llamado MsTeamsVdi.exe, que es el nuevo motor multimedia (SlimCore) usado para la nueva optimización.
7. El motor multimedia SlimCore (en el cliente) y msteams.exe (en el escritorio virtual) ahora tienen un canal bidireccional y pueden iniciar el procesamiento de solicitudes multimedia.

Llamadas de usuario

8. El punto A hace clic en el botón de llamada. MsTeamsVdi.exe se comunica con los servicios de Microsoft Teams en Azure, estableciendo una ruta de señalización de un extremo a otro con el punto B. MsTeamsVdi.exe recopila una serie de parámetros de llamada admitidos (códecs, resoluciones, etc., lo que se conoce como una oferta de Protocolo de descripción de sesión (SDP). Estos parámetros de llamada se retransmiten a continuación mediante la ruta de señalización a los servicios de Microsoft Teams en Azure y desde allí al otro equipo del mismo nivel.
9. La oferta/respuesta SDP (negociación de paso único) tiene lugar a través del canal de señalización, y las comprobaciones de conectividad de ICE (NAT y cruces del firewall usando solicitudes de enlace STUN) completan. A continuación, los medios de protocolo de transporte seguro en tiempo real (SRTP) fluyen directamente entre MsTeamsVdi.exe y el otro par (o relés de transporte de Teams o servidores de conferencia).

En este artículo se describen bloques IP para señalización, medios, efectos de fondo y otras opciones.

Tipos de tráfico controlados por SlimCore en el punto de conexión

1. La conectividad de flujos de medios de Teams se implementa mediante el establecimiento de conectividad interactiva (ICE) IETF estándar para procedimientos de STUN y TURN.
2. Medios en tiempo real. Datos encapsulados dentro del Protocolo de transporte en tiempo real (RTP) que admite cargas de trabajo de audio, vídeo y pantalla compartida. En general, el tráfico multimedia es muy sensible a la latencia. Este tráfico debe tomar la ruta más directa posible y usar UDP frente a TCP como protocolo de capa de transporte, que es el mejor transporte para medios interactivos en tiempo real desde una perspectiva de calidad.

• Como último recurso, los medios pueden usar TCP/IP y también ser túnel dentro del protocolo HTTP, pero no se recomienda debido a las implicaciones de mala calidad.
• El flujo RTP se asegura mediante SRTP, en el que solo se cifra la carga útil.

1. Señalización. El vínculo de comunicación entre el punto de conexión y los servidores de Teams u otros clientes se usa para controlar las actividades (por ejemplo, cuando se inicia una llamada). La mayoría del tráfico de señalización usa UDP 3478 con reserva a HTTPS, aunque en algunos escenarios (por ejemplo, la conexión entre Microsoft 365 y un controlador de borde de sesión) usa el protocolo SIP. Es importante comprender que este tráfico es mucho menos sensible a la latencia, pero puede causar interrupciones del servicio o tiempos de espera de llamada si la latencia entre los puntos de conexión supera varios segundos.

Consumo de ancho de banda

Teams está concebido para ofrece las mejores posibilidades de uso compartido de audio, vídeo y contenido, independientemente de las condiciones de su red. Cuando el ancho de banda es insuficiente, Teams prioriza la calidad del audio en lugar de la calidad del vídeo. Cuando el ancho de banda no está limitado, Teams optimiza la calidad de los medios, incluido el audio de alta fidelidad, la resolución de vídeo de hasta 1080p y hasta 30 fps (fotogramas por segundo) para vídeo y contenido. Para obtener más información, lea Requisitos de ancho de banda

Calidad de los servicios (QoS)

Implemente la configuración de QoS para los puntos de conexión y dispositivos de red y determine cómo desea controlar el tráfico multimedia para las llamadas y reuniones.

• Como requisito previo, habilite QoS globalmente en el Centro de administración de Teams. Consulte Configurar QoS en el Centro de administración de Teams para obtener más información sobre cómo habilitar los marcadores insertar calidad de servicio (QoS) para la configuración del tráfico multimedia en tiempo real .

  Intervalos de puertos iniciales recomendados:

  Tipo de tráfico de medios	Rango de puertos de origen del cliente	Protocolo	Valor de DSCP	Clase DSCP
  Audio	50,000 - 50,019	TCP/UDP	46	Desvío rápido (EF)
  Vídeo	50,020 - 50,039	TCP/UDP	34	Desvío garantizado (AF41)
  Uso compartido de la pantalla o la aplicación	50.040 = 50.059	TCP/UDP	18	Desvío garantizado (AF41)

• Para obtener información sobre cómo configurar el marcado de DSCP para puntos de conexión de Windows, consulte Implementar QoS en clientes de Teams.

  Nota

  Cualquier marcado basado en puntos de conexión se debe aplicar a MsTeamsVdi.exe, el proceso que controla toda la descarga multimedia en el dispositivo del usuario.

• Para obtener información sobre la implementación de QoS para enrutadores, consulte la documentación del fabricante.

• La configuración de QoS en dispositivos de red puede incluir algunos o todos los elementos siguientes:

  • uso de listas de control de acceso (ACL) basadas en puertos
  • definición de las colas de QoS
  • definición de marcas dscp

Importante

Se recomienda implementar estas directivas de QoS mediante los puertos de origen del punto de conexión y una dirección IP de origen y destino de "cualquiera". Esto detectará el tráfico multimedia entrante y saliente en la red interna.

Tecnologías que no se recomiendan con Microsoft Teams en VDI

1. Red VPN. No se recomienda para el tráfico multimedia.
2. Shapers de paquetes. No se recomienda ningún tipo de rastreador de paquetes, inspección de paquetes, servidores proxy o dispositivos de formador de paquetes para el tráfico multimedia de Teams y puede degradar significativamente la calidad.

Lista de características con la nueva optimización

Característica	Disponible
1080p	Sí
Aceleración de hardware en el punto de conexión	Sí
Vista Galería 3x3 y 7x7	Sí
Calidad de servicio	Sí
Supresión de ruido	Sí
ESCONDIÓ	Sí
Modo Moderador	Sí
Teams Premium	Sí (Pendiente: Marca de agua, Ayuntamientos, Decorar mi fondo)
Efecto de fondo cargado por el usuario	Próximamente
Zoom +/-	Próximamente

Perfil de usuario de SlimCore en el punto de conexión

La nueva solución para VDI almacena datos específicos del usuario en el punto de conexión en las siguientes ubicaciones, según el proveedor:

• C:\users\<user>\AppData\Roaming\Microsoft\TeamsVDI\avd-default-<cloudname>\
• C:\users\<user>\AppData\Roaming\Microsoft\TeamsVDI\citrix-default-<cloudname>\

Importante

Los clientes ligeros bloqueados deben permitir que estas ubicaciones sean de lectura y escritura; de lo contrario, la nueva optimización podría fallar.

Los registros, las configuraciones y los modelos AI o ML (utilizados en la supresión del ruido, estimación del ancho de banda, etc.) se guardan en esta ubicación. Si estas carpetas se purgan después de que un usuario cierre sesión (por ejemplo, clientes ligeros bloqueados sin perfiles de itinerancia), MsTeamsVdi.exe las volverá a crear y descargará la configuración específica del usuario (aproximadamente 6 MB de datos).

Proceso de instalación y actualización de SlimCore en entornos thin client bloqueados (opcional)

De forma predeterminada, MsTeamsPlugin descarga e instala automáticamente la versión correcta del motor multimedia SlimCore sin la intervención del usuario o del administrador. Sin embargo, los clientes en entornos de red restringidos en la sucursal pueden optar por un proceso de distribución SlimCore alternativo, sin que sea necesario que el punto de conexión pueda capturar paquetes SlimCore mediante https desde la red CDN pública de Microsoft.

Importante

Si debe elegir este método, debe garantizar que:

1. La actualización automática de Teams está deshabilitada en el escritorio virtual.
2. Los paquetes de SlimCore se aprovisionan previamente en el almacenamiento local o en el recurso compartido de red del punto de conexión antes de actualizar nuevos equipos en el escritorio virtual. Cualquier versión más reciente de Teams solicitará una nueva versión coincidente de SlimCore y, si el complemento no lo encuentra, el usuario estará en modo de reserva (representación del lado servidor).

Esto se debe a que las nuevas versiones de Teams y SlimCore deben coincidir.

Pasos de configuración

1. En el punto de conexión del usuario (cliente ligero/cliente gordo), debe crear la siguiente clave del registro:

• Ubicación para Citrix: HKLM\SOFTWARE\WOW6432Node\Microsoft\Teams\MsTeamsPlugin
• Ubicación de Azure Virtual Desktop/W365: HKLM\SOFTWARE\Microsoft\Teams\MsTeamsPlugin
• Nombre: MsixUrlBase
• Tipo: REG_SZ
• Datos: ruta UNC de almacenamiento local o de almacenamiento de red, como file://C:/Temp o file://ComputerName/SharedFolder. La clave del registro define la dirección URL base.

2. Además, los administradores deben descargar la versión exacta del paquete MSIX de SlimCore desde la red CDN de Microsoft que coincida con la nueva versión de Teams que está planeando implementar en el futuro.

Importante

El paquete MSIX debe coincidir con la arquitectura o el valor de bits de Citrix Workspace App (solo x86) o de los clientes de Escritorio remoto o Windows App: Microsoft.Teams.SlimCoreVdi.<platform>-<architecture>.msix.

3. Coloque el MSIX en una carpeta específica con la versión dentro de la ubicación especificada en la clave del Registro para conservar la estructura. Por ejemplo, C:\Temp\2024.4.1.9\Microsoft.Teams.SlimCoreVdi.win-x86.msix o //ComputerName/SharedFolder/2024.4.1.9/.

Nota

Si el complemento no puede encontrar un paquete MSIX de SlimCore en el almacenamiento local o en la red, intenta descargarlo automáticamente desde la red CDN pública de Microsoft como reserva.

Problemas conocidos

• Azure RemoteApps y Citrix Published Apps no son compatibles en este momento.
• Las llamadas se reciben en Teams que se ejecutan en la máquina local que tiene un periférico HID conectado si un usuario inicia un escritorio virtual desde esa misma máquina local e inicia sesión en Teams.
• Si intenta unirse a una reunión justo después de iniciar nuevo Teams (por ejemplo, haciendo clic en un vínculo profundo de Teams en Outlook sin tener nuevos equipos en ejecución), la llamada podría anularse.

Lista de permitidos del canal virtual Citrix

La configuración de directiva de lista de permitidos del canal virtual en EL CVAD habilita el uso de una lista de permitidos que especifica qué canales virtuales se pueden abrir en una sesión ICA. Cuando se habilita, deben indicarse todos los procesos excepto los canales virtuales integrados de Citrix. Como resultado, se necesitan más entradas para que el nuevo cliente de Teams pueda conectarse al complemento del lado cliente (MsTeamsPluginCitrix.dll).

Con Citrix Virtual Apps y Desktops 2203 o posterior, la lista de canales virtuales permitidos está habilitada de forma predeterminada. Esta configuración predeterminada deniega el acceso a los nuevos canales virtuales personalizados de Teams, ya que la lista de permitidos no incluye el nuevo nombre del proceso principal de Teams.

El nuevo cliente de Teams requiere tres canales virtuales personalizados para funcionar: MSTEAMS, MSTEAM1 y MSTEAM2. ms-teams.exe accede a estos canales. Puede usar caracteres comodín para permitir el ms-teams.exe ejecutable y el canal virtual personalizado:

• MSTEAMS,C:\Archivos de programa\WindowsApps\MSTeams*8wekyb3d8bbwe\ms-teams.exe
• MSTEAM1,C:\Archivos de programa\WindowsApps\MSTeams*8wekyb3d8bbwe\ms-teams.exe
• MSTEAM2,C:\Archivos de programa\WindowsApps\MSTeams*8wekyb3d8bbwe\ms-teams.exe

1. La compatibilidad con caracteres comodín está disponible en:

• VDA 2206 CR.
• VDA 2203 LTSR desde CU2 en adelante.

2. Los equipos VDA deben reiniciarse para que la directiva surta efecto.

Compatibilidad con Citrix App Protection y Microsoft Teams

Los usuarios con Protección de aplicaciones habilitada pueden seguir compartiendo su pantalla y sus aplicaciones mientras usan la nueva optimización. El uso compartido requiere VDA versión 2402 o posterior y CWA para Windows 2309.1 o posterior. Los usuarios de versiones inferiores acabarán compartiendo una pantalla negra en su lugar cuando el módulo de Protección de aplicaciones esté instalado y habilitado.

Solución de problemas

• No está optimizado con SlimCore y, en su lugar, ve:
  "Azure Virtual Desktop Media Optimized"
  "Citrix HDX Optimized"

  • Los códigos de error 2000 ("Sin complemento") y 2001 ("Canal virtual no disponible") son las causas más probables.
  1. Asegúrese de que la "Lista de permitidos del canal virtual" esté configurada correctamente para permitir MSTEAMS, MSTEAM1 MSTEAM2.
  2. Asegúrese de que el punto de conexión tiene el complemento y que el cliente de VDI lo carga con el Explorador de procesos:
  • Ejecuta el explorador de procesos.
  • Habilite el panel inferior y cambie a la pestaña DLL.
  • En Azure Virtual Desktop, busque el proceso de msrdc.exe y asegúrese de que se carga la MsTeamsPluginAvd.dll.
  • En Citrix, busque el proceso de wfica32.exe y asegúrese de que se carga la MsTeamsPluginCitrix.dll.
  3. Reinicie la nueva aplicación de Teams. Requiere dos reinicios para pasar de WebRTC a SlimCore, cuando se detecta el complemento por primera vez.
  4. Si el problema continúa, consulte Visor de eventos en la máquina virtual para ver si hay errores relacionados con VDI de Microsoft Teams (nuevo Teams 24123.X.X.X o superior).

• No está optimizado con SlimCore y, en su lugar, verá: "Azure Virtual Desktop SlimCore Media Not Connected" o "Citrix SlimCore Media Not Connected".

  • Consulte la sección Solución de problemas de errores de implementación MSIX de SlimCoreVdi . Los errores relacionados con MSIX o AppX son los motivos más probables de este error.

Nuevos registros de Teams para VDI

Los registros de Teams se pueden recopilar seleccionando Ctrl+Alt+Mayús+1 mientras se ejecuta Teams en una máquina virtual. Esta acción genera una carpeta ZIP en la carpeta Descargas. En el archivo de .zip PROD-WebLogs-*, busque la carpeta Core.

Vdi_debug.txt es el archivo principal de información relacionada con VDI

Azure Virtual Desktop/W365	Citrix
"vdiConnectedState": {"connectedStack": "remote"}, "vdiVersionInfo": {"bridgeVersion": "2024.18.1.11", "remoteSlimcoreVersion": "2024.18.01.11", "nodeId": "1051a908af6b160e", "clientOsVersion": "10.0.22631", "rdClientVersion": "1.2.5405.0", "rdClientProductName": "Escritorio remoto de Microsoft®", "pluginVersion": "2024.14.01.1", "screenShareFallback": true}	"vdiConnectedState": {"connectedStack": "remote"}, "vdiVersionInfo": {"bridgeVersion": "2024.18.1.14", "remoteSlimcoreVersion": "2024.18.01.14", "nodeId": "ffffffff93eaee6a", "clientOsVersion": "10.0.22631", "rdClientVersion": "24.3.0.64", "rdClientProductName": "Citrix Workspace", "pluginVersion": "2024.15.01.3", "screenShareFallback": true}

• vdiConnectedState muestra la pila de llamadas activa actual.
  • connectedStack: remote indica que Teams se ha conectado correctamente al punto de conexión remoto a través del canal virtual. No significa necesariamente que la pila de llamadas se inicializa correctamente, por lo que el usuario aún puede encontrar errores relacionados con las llamadas, como no puede iniciar una llamada.
  • connectedStack: local indica que se ha producido un error en la conexión del canal virtual. El usuario está ahora en modo de reserva.
• vdiVersionInfo proporciona información útil para el cliente de Teams y el punto de conexión.
  • bridgeVersion está vinculada a la versión del cliente de escritorio de Teams que se ejecuta en la máquina virtual.
  • remoteSlimcroreVersion es la versión de SlimCore VDI que está disponible en el punto de conexión.
  • nodeId es un id. único vinculado al punto de conexión.
  • clientOsVersion es la versión del so para el punto de conexión.
  • rdClientVersion es la versión del cliente de escritorio remoto que se ejecuta en el punto de conexión, que se usa para conectarse a la máquina virtual.
  • rdClientProductName es el nombre del cliente de escritorio remoto que se ejecuta en el extremo.
  • pluginVersion es la versión del complemento que se integra en el cliente de escritorio remoto.

Diagnostics-logs.txt podría estar en weblogs\user(..)

Para investigar más problemas relacionados con la conexión VDI, el uso de la palabra clave vdiBRidgeEventsHandler proporciona los registros de los controles de eventos de conexión y de desconexión de vdiBridge, como se muestra (control de eventos onConnected) en el ejemplo siguiente de una conexión correcta con la nueva pila de optimización:

7432 2024-03-01T17:51:22.032Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - onConnected: end, currentStack=remote 7435 2024-03-01T17:51:22.032Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - new calling stack type set: currentStack=remote 7436 2024-03-01T17:51:22.032Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - deviceManagerService reloaded 7445 2024-03-01T17:51:22.031Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - calling stack reinit complete with nextStack=remote 7464 2024-03-01T17:51:21.785Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - starting calling stack reinit with nextStack=remote 7465 2024-03-01T17:51:21.785Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - SlimCore replacement complete, remote is now available 7467 2024-03-01T17:51:21.783Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - setVDIOptimizationModeOverride: from SlimCore to SlimCore 7468 2024-03-01T17:51:21.782Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - onConnected: isVersionMismatch=false, forceVersion=undefined, bridgeVersion=2024.5.1.11 7469 2024-03-01T17:51:21.782Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - cached local SlimCore for future (fallback), currentStack=local 7470 2024-03-01T17:51:21.782Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - onConnected: start, vendorType=1, remoteSlimcoreVersion=2024.05.01.11, platform=win-x86, loadErrc=1, deployErrc=24002, nodeId=ffffffffbd7d5e77 7471 2024-03-01T17:51:21.782Z Inf vdiBridgeEventsHandler: VDI Mode: slimcore - enqueueBridgeCallback: adding onConnected to queue, 0 bridge callbacks in queue, isBridgeCallbacksQueueProcessing=false

Error de conexión

Si hay un error de conexión, puede encontrar el código de error en la línea de registro que contiene "loadErrc" y "deployErrc". El código registrado aquí debe asignarse mediante esta tabla:

Código de error	deployErrc	Definición	Notas
0	0	Aceptar.	Código especial para mensajes de telemetría 'ConnectedNoPlugin'.
5	43	ERROR_ACCESS_DENIED	MsTeamsVdi.exe proceso no se realizó correctamente en el inicio. Es posible que se haya habilitado BlockNonAdminUserInstall.
404	3235	HTTP_STATUS_NOT_FOUND	Problema de publicación: El paquete MSIX de SlimCore no se encuentra en la red CDN.
1260	10083	ERROR_ACCESS_DISABLED_BY_POLICY	Este error normalmente significa que el Administrador de paquetes de Windows no puede instalar el paquete SlimCore MSIX. El Visor de eventos puede mostrar el código de error hexadecimal 0x800704EC. Las directivas de AppLocker pueden provocar este código de error. Puedes deshabilitar AppLocker o agregar una excepción para los paquetes SlimCoreVdi en la Directiva de seguridad local -> Directivas de control de aplicaciones -> AppLocker. Consulte "Paso 3" en "Optimización con la nueva solución VDI para Teams".
1460	11683	ERROR_TIMEOUT	MsTeamsVdi.exe proceso falló al iniciar (tiempo de espera de 60 segundos).
1722		RPC_S_SERVER_UNAVAILABLE	"El servidor RPC no está disponible" MsTeamsVdi.exe error relacionado.
2000	16002	Sin complemento	El punto de conexión no tiene MsTeamsPlugin o, si lo tiene, no se carga (consulte el Explorador de procesos).
2001		El canal virtual no está disponible	Error en Citrix VDA WFAPI.
3000	24002	No es necesaria la implementación de SlimCore	Este código no es realmente un error. Es un buen indicador de que el usuario está en la nueva arquitectura de optimización con SlimCore.
3001	24010	SlimCore ya cargado	Este código no es realmente un error. Es un buen indicador de que el usuario está en la nueva arquitectura de optimización con SlimCore.
3004	24035	Plugin irresponsivo	Intente reiniciar la sesión RDP o ICA.
3005	24043	Tiempo de espera del complemento durante la descarga	Error al descargar el MSIX en 2 minutos.
3007	24058	Cargar tiempo de espera	Se ha agotado el tiempo de espera de la descarga o instalación de SlimCore (internet lento o el servicio de disponibilidad de aplicaciones está ocupado).
4000		ERROR_WINS_INTERNAL	WINS encontró un error al procesar el comando.
15615	1951	ERROR_INSTALL_POLICY_FAILURE	Error relacionado con MSIX de SlimCore. Para instalar esta aplicación, necesitas una licencia de desarrollador de Windows o un sistema habilitado para la instalación de prueba. ¿La clave del registro AllowAllTrustedApps podría estar establecida en 0?
15616		ERROR_PACKAGE_UPDATING	Error relacionado con MSIX de SlimCore 'La aplicación no se puede iniciar porque se está actualizando'.
15700		APPMODEL_ERROR_NO_PACKAGE	El proceso no tiene identidad de paquete. No hay ningún alias para MsTeamsVdi en %LOCALAPPDATA%\Microsoft\WindowsApps. Los registros del Centro de opiniones son necesarios mientras se reproduce el error (asegúrate de seleccionar Plataforma para desarrolladores como categoría e Implementación de aplicaciones como subcategoría)

Uso del Visor de eventos en la máquina virtual para la solución de problemas

Cada evento de conexión o desconexión se registra en el Visor de eventos que se ejecuta en la máquina virtual. El Visor de eventos también puede mostrar errores relacionados con el cliente. Filtrar por origen (Microsoft Teams VDI) e Id. de evento (0). Encontrará códigos de error en la sección Registros de nuevos equipos para VDI .

Solución de problemas de errores de implementación de complementos

La información de diagnóstico puede encontrarse en los registros detallados de eventos del dispositivo del usuario. Después de la instalación, MsTeamsPluginCitrix.dll se escribe en la carpeta CWA. Solo para la plataforma Citrix, se crean las siguientes claves en el punto de conexión (no VM):

Clave	Tipo de clave	Nombre de clave	Valor de clave
HKLM\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ICA 3.0	String	VirtualDriverEx	MicrosoftTeamsVDI
HKLM\SOFTWARE\WOW6432Node\Citrix\ICAClient\Engine\Configuration\Advanced\Modules\MicrosoftTeamsVDI	String	DriverNameWin32	MsTeamsPluginCitrix.dll

Para depurar instalaciones, puede habilitar el registro del instalador, pero después debe usar msiexec manualmente y pasar marcas correctas. Por ejemplo, si el complemento no está instalado actualmente, se puede instalar con registros como este: msiexec.exe /i MsTeamsPluginCitrix.msi /l*vx installer.log.txt.

Solución de problemas de errores de implementación de MSIX de SlimCoreVdi

Asegúrese de revisar el registro y el almacenamiento provisional de MSIX de SlimCore en la sección del punto de conexión , ya que determinados GPO pueden impedir las instalaciones de MSIX.

La información de diagnóstico puede encontrarse en los registros detallados de eventos del dispositivo del usuario.

1. Ve a los registros > de servicios y aplicaciones del Visor de eventos (local) > de Microsoft > Windows.
2. Compruebe si hay registros disponibles en estas categorías:

• AppxPackagingOM > Microsoft-Windows-AppxPackaging/Operational
• >AppXDeployment-Server Microsoft-Windows-AppXDeploymentServer/Operational

1. Revise los registros en AppXDeployment-Server.

Error 15615

El error 15615 normalmente significa que el Administrador de paquetes de Windows no puede instalar el paquete MSIX con SlimCoreVdi.

• Asegúrese de que la firma digital de ese MSIX sea de confianza para el punto de conexión (vaya a Detalles de las firmas digitales > de Propiedades > MSIX>). Se trata de una firma válida de Microsoft apta para store, pero es posible que los clientes tengan algo especial configurado.
• Intente habilitar la directiva AllowAllTrustedApps.
• Intenta permitir la instalación de prueba de aplicaciones de orígenes de confianza que no sean de la tienda.
  • En Windows 10, esta configuración está habilitada de manera predeterminada, por lo que puedes modificarla aquí en caso de que esté deshabilitada: Actualización de configuración > y seguridad > para desarrolladores > Instalación de prueba de aplicaciones.
  • En Windows 11, esta configuración está habilitada de manera predeterminada: Configuración > Aplicaciones > avanzadas Configuración de > la aplicación Elegir dónde obtener aplicaciones > en cualquier lugar.

Colección de registros

El registro puede encontrarse en las siguientes ubicaciones:

• En el cliente:
  • AppData\Roaming\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\skylib
  • AppData\Roaming\Microsoft\TeamsVDI\<vdi_vendor>-default-<cloudname>\media-stack
• En el servidor:
  • AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams\Logs\skylib