Solucionar que la migración a nuevo Teams no se complete en azure virtual desktop

Cuando implementa el nuevo cliente de Microsoft Teams en Azure Virtual Desktop, la migración desde la aplicación clásica de Teams puede estancarse o no completarse. Ve el aviso de migración, pero el proceso nunca finaliza, lo que deja a los usuarios atascados en el cliente antiguo. Esto ocurre porque la migración de Teams en AVD depende de claves de registro específicas, permisos del perfil de usuario y el orden de los pasos de instalación. Este artículo explica la causa raíz y proporciona una solución paso a paso para forzar que la migración se complete de forma confiable.

Aprenderá a verificar el estado de la migración, corregir la configuración del registro y aplicar las directivas necesarias. Las soluciones a continuación funcionan tanto para grupos de hosts agrupados como personales en Azure Virtual Desktop. Después de aplicarlas, el nuevo cliente de Teams reemplazará a la aplicación clásica sin intervención del usuario.

Por qué falla la migración a Nuevo Teams en Azure Virtual Desktop

La migración de Teams clásico al nuevo cliente de Teams depende de un bootstrapper que se ejecuta durante el inicio de sesión del usuario. En Azure Virtual Desktop, este bootstrapper a menudo falla porque la imagen del grupo de hosts contiene una versión anterior del bootstrapper de Teams o porque el perfil de usuario carece de permisos de escritura en la carpeta de instalación de Teams. Otra causa común es la presencia de la clave de registro que fuerza que el cliente clásico de Teams siga siendo el predeterminado. Cuando esa clave está establecida, el nuevo cliente de Teams no puede tomar el control y la migración parece colgarse o nunca iniciarse.

El proceso de migración verifica varias condiciones antes de continuar. Comprueba que el usuario tenga las licencias correctas, que la red pueda alcanzar los servidores de descarga de Teams y que la directiva local permita ejecutar el bootstrapper. En AVD, el perfil de usuario predeterminado puede tener la aplicación Teams instalada por máquina, lo que complica la migración porque el nuevo cliente de Teams se instala por usuario. Esta discrepancia hace que la migración se detenga silenciosamente.

El papel del bootstrapper de Teams

El bootstrapper de Teams es un pequeño ejecutable que descarga e instala el nuevo cliente de Teams. Se ejecuta cuando un usuario inicia sesión y comprueba la versión actual de Teams. Si el bootstrapper está desactualizado, es posible que no reconozca el nuevo cliente de Teams y seguirá intentando instalar la versión clásica. En AVD, el bootstrapper a menudo se actualiza a través de la imagen, pero si la imagen no se actualiza, la migración fallará.

Permisos del perfil de usuario y la migración

El nuevo cliente de Teams se instala en la carpeta AppData del usuario. Si el perfil de usuario no es escribible o si el perfil es un perfil obligatorio, la instalación falla. En AVD, debe asegurarse de que el perfil de usuario tenga control total sobre la carpeta AppData\Local\Microsoft\Teams. De lo contrario, el proceso de migración no puede copiar los archivos necesarios.

Pasos para forzar que se complete la migración a Nuevo Teams

Los siguientes pasos se aplican tanto a las imágenes multisesión de Windows 10 como de Windows 11 utilizadas en Azure Virtual Desktop. Realícelos en la imagen maestra antes de capturarla, o en una sesión activa si está probando la solución.

1. Desinstale la aplicación clásica de Teams de la imagen
   Inicie sesión como administrador local. Abra Panel de control > Programas > Programas y características. Seleccione Microsoft Teams y haga clic en Desinstalar. Esto elimina la instalación por máquina que bloquea la migración.
2. Elimine la clave de registro de Teams que bloquea el cliente clásico
   Abra el Editor del Registro como administrador. Navegue a HKLM\SOFTWARE\Microsoft\Teams. Si el valor IsWAMDefault existe y está establecido en 1, cámbielo a 0. Si la clave no existe, créela como un valor DWORD con un valor de 0.
3. Instale el bootstrapper de Teams más reciente
   Descargue el bootstrapper de Teams desde el centro de administración de Microsoft 365 o use el vínculo directo https://go.microsoft.com/fwlink/?linkid=2196106. Ejecute el instalador con el comando msiexec /i teamsbootstrapper.msi. Esto instala el bootstrapper que activará la migración en el siguiente inicio de sesión.
4. Establezca la directiva de grupo para permitir actualizaciones automáticas
   Abra la Consola de administración de directivas de grupo. Navegue a Configuración del equipo > Plantillas administrativas > Microsoft Teams. Establezca la directiva “No actualizar Teams automáticamente” en Deshabilitada. Esto permite que el bootstrapper descargue el nuevo cliente de Teams sin ser bloqueado.
5. Verifique la migración en un usuario de prueba
   Inicie sesión con una cuenta de usuario de prueba. El nuevo cliente de Teams debería iniciarse automáticamente. Compruebe la versión seleccionando la imagen de perfil y luego Acerca de. La versión debe ser 1.6.00 o superior. Si el cliente clásico aún aparece, repita la comprobación del registro y confirme la instalación del bootstrapper.

Si la migración aún no se completa

Cuando la migración falla después de los pasos anteriores, el problema suele estar relacionado con el contenedor de perfil de FSLogix. El nuevo cliente de Teams almacena datos en el perfil de usuario, y si el contenedor de perfil no está configurado para admitir el nuevo cliente, la migración no puede escribir los archivos necesarios.

1. Compruebe la configuración del contenedor de perfil de FSLogix
   Abra el Editor del Registro en el host. Navegue a HKLM\SOFTWARE\FSLogix\Profiles. Asegúrese de que el valor VHDLocations esté establecido en una ruta de almacenamiento válida y que el valor Enabled esté establecido en 1.
2. Habilite los datos de Teams en el contenedor de perfil
   En la misma clave de registro, cree un nuevo valor DWORD llamado IncludeTeams y establézcalo en 1. Esto indica a FSLogix que incluya la carpeta de datos de Teams en el contenedor de perfil.
3. Reinicie la sesión y pruebe de nuevo
   Cierre sesión y vuelva a iniciarla. La migración ahora debería completarse porque el contenedor de perfil permite que el nuevo cliente de Teams escriba sus datos.

Si Teams aún tiene problemas después de la solución principal

Teams muestra una ventana en blanco después de la migración

Una ventana en blanco indica que el nuevo cliente de Teams no puede renderizar porque el runtime de WebView2 falta o está desactualizado. Instale el runtime de Microsoft Edge WebView2 más reciente desde el sitio web de Microsoft. Después de la instalación, reinicie el cliente de Teams.

El aviso de migración reaparece en cada inicio de sesión

Si el aviso de migración aparece repetidamente, el bootstrapper no detecta que el nuevo cliente de Teams está instalado. Compruebe la clave de registro HKLM\SOFTWARE\Microsoft\Teams\IsWAMDefault. Si está establecida en 1, cámbiela a 0. También verifique que el nuevo cliente de Teams esté instalado en la carpeta AppData del usuario, no en la carpeta del sistema.

Teams clásico se reinstala después de la migración

Esto ocurre cuando el proceso de aprovisionamiento de la imagen incluye un script que reinstala la aplicación clásica de Teams. Elimine ese script de la imagen o modifíquelo para omitir la instalación si el nuevo cliente de Teams está presente. También revise las tareas programadas en el Programador de tareas que puedan ejecutar el instalador de Teams al iniciar sesión.

Nuevo Teams de escritorio vs Teams clásico en AVD: diferencias clave

Elemento	Nuevo Teams de escritorio	Teams clásico de escritorio
Método de instalación	Por usuario, instalado en AppData	Por máquina, instalado en Program Files
Uso de recursos	Menor uso de memoria y CPU	Mayor consumo de recursos
Frecuencia de actualización	Actualizaciones automáticas mediante bootstrapper	Actualizaciones manuales a través del centro de administración
Compatibilidad de perfiles	Requiere la configuración IncludeTeams de FSLogix	Funciona con contenedores de perfil estándar
Desencadenante de migración	El bootstrapper se ejecuta al iniciar sesión	No aplicable

Ahora tiene los pasos para forzar que se complete la migración a Nuevo Teams en Azure Virtual Desktop. Comience limpiando la imagen, corrigiendo el registro e instalando el bootstrapper más reciente. A continuación, pruebe la migración con un solo usuario antes de implementarla en todo el grupo de hosts. Para problemas persistentes, compruebe la configuración del contenedor de perfil de FSLogix y la versión del runtime de WebView2.