Corregir la plantilla de Teams que crea los canales incorrectos después de un cambio en el grupo de Microsoft 365

Su plantilla de Teams puede crear los canales incorrectos después de cambiar el grupo de Microsoft 365 que respalda un equipo. Esto ocurre cuando la definición de la plantilla todavía apunta a la estructura del grupo anterior. En este artículo, aprenderá por qué se produce la discrepancia y cómo solucionarla usando el centro de administración de Teams y PowerShell.

La causa principal es que una plantilla de Teams almacena una instantánea de los nombres y la configuración de los canales. Cuando cambia el grupo de Microsoft 365, la plantilla no se actualiza automáticamente. Verá canales del grupo anterior aparecer en equipos nuevos, o faltarán canales que esperaba.

Revisaremos tres soluciones: editar la plantilla en el centro de administración, usar PowerShell para actualizar el JSON de la plantilla y eliminar la plantilla si no se puede reparar. También aprenderá cómo evitar este problema en el futuro.

Por qué una plantilla de Teams crea los canales incorrectos después de un cambio de grupo

Una plantilla de Teams es un archivo JSON que define la estructura inicial de un equipo. Incluye nombres de canales, tipos de canales y otra configuración. Cuando crea un equipo a partir de una plantilla, Teams copia ese JSON en el nuevo equipo. La plantilla no hace referencia al grupo de Microsoft 365 original por su ID. Solo contiene los nombres de canales y la configuración que se guardaron en el momento en que se creó o se editó por última vez la plantilla.

Cuando cambia el grupo de Microsoft 365 que respalda un equipo existente, está modificando la pertenencia, el nombre u otras propiedades del grupo. Este cambio no se propaga a la plantilla. La plantilla permanece congelada con la lista de canales anterior. Si luego crea un nuevo equipo a partir de esa plantilla, obtendrá los canales antiguos, no los del grupo modificado.

Otro escenario es cuando cambia la privacidad o la clasificación del grupo. La plantilla aún puede intentar crear canales que ya no están permitidos según la nueva configuración. Por ejemplo, si el grupo se vuelve privado, un canal que estaba marcado como público en la plantilla fallará o aparecerá incorrectamente.

La discrepancia no es un error. Es por diseño. Las plantillas son definiciones estáticas, no vínculos dinámicos. Para solucionar el problema, debe actualizar la plantilla misma para que coincida con la estructura de canales deseada.

Pasos para actualizar una plantilla de Teams después de un cambio en el grupo de Microsoft 365

Tiene tres métodos para corregir la plantilla. Elija el que se adapte a su situación. Use el centro de administración para ediciones simples, PowerShell para cambios masivos, o elimine y vuelva a crear la plantilla si no se puede reparar.

Método 1: Editar la plantilla en el centro de administración de Teams

1. Inicie sesión en el centro de administración de Teams
   Vaya a https://admin.teams.microsoft.com e inicie sesión con una cuenta que tenga el rol de administrador de Teams.
2. Abra la página Plantillas de equipo
   En la navegación izquierda, seleccione Aplicaciones de Teams y luego Plantillas de equipo.
3. Seleccione la plantilla que está creando canales incorrectos
   Haga clic en el nombre de la plantilla para abrir su página de detalles.
4. Haga clic en Editar
   En la esquina superior derecha de los detalles de la plantilla, haga clic en Editar.
5. Actualice la lista de canales
   Desplácese hasta la sección Canales. Elimine cualquier canal que pertenezca al grupo anterior. Agregue los canales correctos que deberían aparecer en los nuevos equipos. También puede cambiar los nombres y las descripciones de los canales.
6. Guarde la plantilla
   Haga clic en Guardar en la parte inferior de la página. La plantilla ahora está actualizada.

Este método es mejor cuando solo tiene unos pocos canales que cambiar. Es visual y no requiere conocimientos de scripting.

Método 2: Actualizar el JSON de la plantilla con PowerShell

Use PowerShell cuando tenga muchas plantillas que actualizar o cuando el centro de administración no exponga toda la configuración. Necesita el módulo de PowerShell de Teams versión 5.1 o posterior.

1. Conéctese a Microsoft Teams
   Abra PowerShell y ejecute Connect-MicrosoftTeams. Inicie sesión con una cuenta que tenga el rol de administrador de Teams.
2. Obtenga la definición actual de la plantilla
   Ejecute Get-CsTeamTemplate -OdataId "https://graph.microsoft.com/v1.0/teamsTemplates?$filter=displayName eq 'Your Template Name'". Reemplace el nombre de la plantilla por el nombre real de su plantilla.
3. Exporte el JSON de la plantilla a un archivo
   Ejecute Get-CsTeamTemplate -OdataId "..." | ConvertTo-Json -Depth 10 | Out-File template.json. Esto guarda la definición actual.
4. Edite el archivo JSON
   Abra template.json en un editor de texto como Visual Studio Code. Localice el arreglo channels. Modifique los nombres de los canales y elimine los que estén obsoletos. Guarde el archivo.
5. Actualice la plantilla
   Ejecute Set-CsTeamTemplate -OdataId "..." -Body (Get-Content template.json -Raw). Esto reemplaza la plantilla con su JSON editado.
6. Verifique la actualización
   Ejecute Get-CsTeamTemplate -OdataId "..." | ConvertTo-Json y compruebe que la lista de canales sea correcta.

PowerShell le brinda control total. También puede automatizar este proceso en varias plantillas con un script.

Método 3: Eliminar y volver a crear la plantilla

Si la plantilla está dañada o tiene mucha configuración obsoleta, elimínela y cree una nueva. Este es el enfoque más limpio.

1. Elimine la plantilla en el centro de administración
   Vaya a Aplicaciones de Teams > Plantillas de equipo. Seleccione la plantilla y haga clic en Eliminar.
2. Cree una nueva plantilla
   Haga clic en Agregar para crear una nueva plantilla. Elija un tipo de equipo que se adapte a sus necesidades.
3. Defina los canales correctos
   Agregue solo los canales que deberían aparecer en los nuevos equipos. Use los mismos nombres y tipos que el grupo de Microsoft 365 que cambió.
4. Guarde la nueva plantilla
   Haga clic en Crear o Aplicar para finalizar la plantilla.

Eliminar una plantilla no afecta a los equipos existentes que se crearon a partir de ella. Solo impide el uso futuro de la definición anterior.

Si Teams sigue creando los canales incorrectos después de la corrección

Teams muestra canales del grupo anterior incluso después de editar la plantilla

Esto puede ocurrir si editó la plantilla pero no la guardó correctamente. Vuelva a la plantilla en el centro de administración y compruebe la lista de canales. También verifique que está editando la plantilla correcta. Es posible que tenga varias plantillas con nombres similares.

Los nuevos equipos tienen canales faltantes que están en el grupo de Microsoft 365

Una plantilla solo puede incluir canales que estén definidos en el JSON de la plantilla. Si el grupo tiene canales que no están en la plantilla, no aparecerán. Agregue esos canales a la plantilla usando el centro de administración o PowerShell.

PowerShell devuelve un error al intentar actualizar la plantilla

El error más común es un formato JSON no válido. Valide su archivo JSON con una herramienta como JSONLint antes de ejecutar Set-CsTeamTemplate. Otra causa es que el ID de la plantilla es incorrecto. Use el OdataId exacto de Get-CsTeamTemplate.

Los usuarios no pueden ver la plantilla actualizada en el cliente de Teams

El cliente de Teams almacena en caché las listas de plantillas hasta 24 horas. Pida a los usuarios que cierren sesión y vuelvan a iniciarla, o espere un día. También puede borrar la caché de Teams eliminando la carpeta %appdata%\Microsoft\Teams, pero esto restablece toda la configuración local.

Edición de plantillas en el centro de administración vs PowerShell vs eliminar la plantilla

Elemento	Edición en el centro de administración	Actualización con PowerShell	Eliminar y volver a crear
Ideal para	Cambios pequeños en unos pocos canales	Actualizaciones masivas o configuración avanzada	Plantillas dañadas o muy obsoletas
Habilidad requerida	Navegación básica del centro de administración	Conocimientos de PowerShell y JSON	Navegación básica del centro de administración
Tiempo para completar	5 minutos	15 minutos, incluido el scripting	10 minutos
Riesgo de error	Bajo	Medio si el JSON tiene un formato incorrecto	Bajo
Conserva los equipos existentes	Sí	Sí	Sí

Los tres métodos conservan los equipos existentes. Solo cambia la definición de la plantilla. Elija el método que se adapte a su nivel de comodidad y a la cantidad de plantillas que necesita corregir.

Ahora puede actualizar una plantilla de Teams después de cambiar un grupo de Microsoft 365. Use el centro de administración para ediciones rápidas o PowerShell para un control preciso. Compruebe la lista de canales de la plantilla antes de crear un nuevo equipo para evitar sorpresas. Como sugerencia avanzada, use la API de Microsoft Graph para automatizar las actualizaciones de plantillas como parte de su proceso de cambio de grupo.