Solución de problemas de instalación y actualización de Microsoft Teams en WindowsTroubleshoot Microsoft Teams installation and update issues on Windows

Este artículo le proporciona instrucciones sobre cómo diagnosticar y solucionar problemas de instalación y actualización de la aplicación cliente de escritorio de Teams que se ejecuta en Windows.This article provides guidance for how to diagnose and troubleshoot installation and update issues for the Teams desktop client app running on Windows.

Comprobar si Teams se ha actualizado correctamenteCheck whether Teams is updated successfully

Siga estos pasos para comprobar si una actualización de Teams se ha instalado correctamente.Follow these steps to check whether a Teams update is successfully installed.

  1. En Teams, seleccione su imagen de perfil y, después, haga clic en Acerca de > Versión.In Teams, select your profile picture, and then click About > Version.
  2. En el mismo menú, haga clic en Buscar actualizaciones.On the same menu, click Check for updates.
  3. Espere a que el mensaje emergente de la parte superior de la aplicación indique que es necesario "actualizar" Teams.Wait for the banner at the top of the app to indicate that a “refresh” of Teams is needed. El vínculo debería mostrarse un minuto más tarde, ya que este proceso descarga la nueva versión de Teams.The link should be shown about a minute later as this process downloads the new version of Teams. El mensaje emergente también le permite saber si ya está ejecutando la última versión en cuyo caso, no es necesario realizar ninguna actualización.The banner also lets you know if you’re already running the latest version in which case, no update is necessary.
  4. Haga clic en el vínculo de actualización en el mensaje emergente.Click the refresh link in the banner.
  5. Espere a que se reinicie Teams y, después, repita el paso 1 para ver si la aplicación se actualiza.Wait until Teams restarts, and then repeat step 1 to see whether the app is updated.

Si ve un mensaje de error o si el número de versión es igual que en el paso 4, el proceso de actualización no se realizó correctamente.If you see a failure message or if the version number is the same as in step 4, the update process failed.

Solución de problemas de instalación y actualizaciónTroubleshoot installation and update issues

Solución de problemas de instalaciónTroubleshoot installation issues

Cuando se instala Teams, el programa de instalación de Teams registra la secuencia de eventos en %LocalAppData%\SquirrelTemp\SquirrelSetup.log.When Teams is installed, the Teams installer logs the sequence of events to %LocalAppData%\SquirrelTemp\SquirrelSetup.log. Lo primero que hay que buscar es un mensaje de error o una pila de llamadas cerca del final del registro.The first thing to look for is an error message or a call stack near the end of the log. Tenga en cuenta que las pilas de llamadas al comienzo del registro pueden no significar que existe un problema de instalación.Note that call stacks at the beginning of the log may not mean that an installation issue exists. Puede ser más fácil comparar el registro con el registro de una instalación correcta (incluso en otro equipo) para ver lo que se espera.It can be easier to compare your log against the log from a successful installation (even on another machine) to see what's expected.

Si SquirrelSetup.log no indica la causa o si necesita más información para solucionar el problema, vea Recopilar y analizar los registros del sistema y de la aplicación.If SquirrelSetup.log doesn't indicate the cause or if you need more information to troubleshoot the issue, see Collect and analyze application and system logs.

Solución de problemas de actualizaciónTroubleshoot update issues

Cuando Teams se instala correctamente, la ubicación del registro cambia de %LocalAppData%\SquirrelTemp a %AppData%\Microsoft\Teams.When Teams is successfully installed, the log location switches from %LocalAppData%\SquirrelTemp to %AppData%\Microsoft\Teams. En esta ubicación, hay dos archivos de registro interesantes, SquirrelSetup.log y logs.txt.At this location, there are two log files of interest, SquirrelSetup.log and logs.txt.

  • El archivo SquirrelSetup.log en esta ubicación está escrito por Update.exe, que es un archivo ejecutable que se aplica a la aplicación Teams.The SquirrelSetup.log file at this location is written by Update.exe, which is an executable that services the Teams app.
  • El archivo Logs.txt se usa en la aplicación Teams (especialmente en Teams.exe) para registrar eventos de aplicación importantes.The Logs.txt file is used by the Teams app (specifically Teams.exe) to record significant application events. Es probable que contenga información de error.It will likely contain failure information.

Estos archivos de registro contienen información de identificación personal (PII), por lo que no se envían a Microsoft.These log files contain personally identifiable information (PII) and so they're not sent to Microsoft.

Teams puede iniciar automáticamente el proceso de actualización (según la directiva) o los usuarios pueden buscar las actualizaciones manualmente yendo a su imagen de perfil > Buscar actualizaciones.Teams can automatically start the update process (depending on the policy) or users can manually check for updates by going to their profile picture > Check for updates. Ambos métodos usan la siguiente secuencia de eventos.Both methods use the following sequence of events.

  1. Busque actualizaciones.Check for updates. Teams realiza una solicitud web e incluye la versión actual de la aplicación y la información sobre el anillo de implementación.Teams makes a web request and includes the current app version and deployment ring information. El objetivo de este paso es obtener el vínculo de descarga.The goal of this step is to get the download link. Un error en este paso se registra en Logs.txt.A failure at this step is logged in Logs.txt.
  2. Descargue la actualización.Download update. Teams descarga la actualización mediante el vínculo de descarga obtenido en el paso 1.Teams downloads the update by using the download link obtained from step 1. Una vez completada la descarga, Teams llama a Update.exe para preparar la descarga.When the download is complete, Teams calls Update.exe to stage the download. Los errores de descarga también se registran en Logs.txt.A download failure is also logged in Logs.txt.
  3. Prepare la actualización.Stage the update. El contenido descargado se verifica y se desempaqueta en una carpeta intermedia, %LocalAppData%\Microsoft\Teams\stage, que se lleva a cabo mediante Update.exe.The downloaded content is verified and unpacked into an intermediate folder, %LocalAppData%\Microsoft\Teams\stage), which is done by Update.exe. Los errores de este paso se registran en SquirrelTemp.log.Failures at this step are logged in SquirrelTemp.log.
  4. Instale la actualización.Install the update. Hay varias formas de iniciar Teams.There are multiple ways to start Teams. El sistema inicia automáticamente Teams cuando un usuario inicia sesión o cuando inicie Teams mediante un acceso directo.The system automatically starts Teams when a user logs in or you can start Teams through a shortcut. En este paso, Update.exe comprueba la presencia de la carpeta provisional, vuelve a comprobar el contenido y realiza operaciones de archivo para quitar la aplicación de la fase de preparación.In this step, Update.exe checks for the presence of the staging folder, verifies the content again, and performs file operations to un-stage the app. Se realiza una copia de seguridad de la antigua carpeta de la aplicación que estaba en %LocalAppData%\Microsoft\Teams\current en %LocalAppData%\Microsoft\Teams\previous y se cambia el nombre de la carpeta provisional a "actual".The old application folder in %LocalAppData%\Microsoft\Teams\current is backed up to %LocalAppData%\Microsoft\Teams\previous and the stage folder is renamed to "current". Los errores de este paso se registran en SquirrelTemp.log.Failures at this step are logged in SquirrelTemp.log.

Si SquirrelTemp.log o Logs.txt no contienen información suficiente para determinar la causa subyacente y necesita más información para solucionar el problema, vaya a Recopilar y analizar los registros del sistema y de la aplicación.If SquirrelTemp.log or Logs.txt don't contain sufficient information to determine the underlying cause and you need more information to troubleshoot the issue, go to Collect and analyze application and system logs.

Recopilar y analizar los registros del sistema y de la aplicaciónCollect and analyze application and system logs

En esta sección, se describe cómo recopilar y analizar los registros del sistema y de la aplicación para obtener información más completa para solucionar el problema.This section describes how to collect and analyze application and system logs to get more comprehensive information to troubleshoot the issue. Use las herramientas de Sysinternals para completar estos pasos.You'll use Sysinternals tools to complete these steps. Para obtener más información, vea Windows Sysinternals.To learn more, see Windows Sysinternals.

Recopilar registrosCollect logs

  1. Descargue las herramientas de Sysinternals.Download the Sysinternals tools.

  2. Extraiga el archivo zip en la carpeta %TEMP% de la unidad local.Extract the zip file to the %TEMP% folder on your local drive.

  3. Abra un símbolo del sistema con privilegios elevados y, después, haga lo siguiente:Open an elevated command prompt, and then do the following:

    1. Ejecute lo siguiente para ir a la carpeta TEMP:Run the following to go to your TEMP folder:

      cd /d %TEMP%
      
    2. Copie los registros de la aplicación y de configuración.Copy the setup and application logs. Tenga en cuenta que, en función del momento del error, es posible que algunos de estos registros no estén presentes.Note that depending on the point of failure, some of these logs may not be present.

      copy %LocalAppData%\SquirrelTemp\SquirrelSetup.log SquirrelSetup.log
      copy %AppData%\Microsoft\Teams\logs.txt logs.txt
      copy %LocalAppData%\Microsoft\Teams\SquirrelSetup.log SquirrelSetup_Teams.log
      
    3. Ejecute lo siguiente para capturar los controladores abiertos.Run the following to capture the open handles.

      handle > handles.txt
      
    4. Ejecute lo siguiente para capturar los archivos dll abiertos.Run the following to capture the opened DLLs.

      listdlls -v Teams > dlls.txt
      
    5. Ejecute lo siguiente para capturar los controladores que se están ejecutando.Run the following to capture the drivers that are running.

      driverquery /v > driverquery.txt
      
    6. Ejecute lo siguiente para capturar las listas de control de acceso (ACL) de la carpeta Teams.Run the following to capture the access control lists (ACLs) of the Teams folder.

      icacls %LOCALAPPDATA%\Microsoft\Teams /save icacls.txt /T
      

Analizar registros (para usuarios avanzados)Analyze logs (for advanced users)

Una actualización no correcta puede provocar un comportamiento de la aplicación imprevisible.A failed update can result in unpredictable app behavior. Por ejemplo, es posible que los usuarios no puedan cerrar Teams, que tengan una versión obsoleta o que no puedan iniciar el programa.For example, users may be unable to exit Teams, have a stale version of Teams, or can't start Teams. Si experimenta un problema durante una actualización, el primer sitio en el que buscar la causa es SquirrelTemp.log.If you experience an issue during an update, the first place to look to find the cause is SquirrelTemp.log. Aquí se muestran los diferentes tipos de errores de actualización, enumerados del más común al menos común, y cómo analizarlos y solucionarlos mediante registros.Here are the different types of update failures, listed from most common to least common, and how to analyze and troubleshoot them using logs.

No se pueden cerrar TeamsUnable to exit Teams

Cuando Teams determina que necesita actualizarse a una versión más reciente, descarga y prepara la aplicación nueva y, después, espera la oportunidad de reiniciarse la próxima vez que el equipo esté inactivo.As Teams determines that it needs to update itself to a newer version, it downloads and stages the new app, and then waits for an opportunity to restart itself the next time the machine is idle. Un problema habitual durante este proceso ocurre cuando otro proceso o un controlador del sistema de archivos bloquea el proceso de Teams.exe, lo que impide el cierre de Teams.exe.A common issue during this process is when another process or a file system driver locks up the Teams.exe process, which prevents Teams.exe from exiting. Por lo tanto, la aplicación Teams no puede reemplazarse por la aplicación recién descargada y preparada.As a result, the Teams app can't be replaced by the newly-downloaded and staged app.

Sugerencias para la solución de problemas:Troubleshooting tips:

  • Para confirmar que es el problema que está experimentando, cierre Teams (haga clic con el botón derecho en Teams en la barra de tareas y, después, haga clic en Cerrar).To confirm that is the issue that you're experiencing, quit Teams (right-click Teams on the task bar, and then click Quit). A continuación, abra el Administrador de tareas en Windows para ver si aún se está ejecutando una instancia de Teams.Then, open Task Manager in Windows to see whether an instance of Teams is still running.
  • Si no se encuentra en el equipo que está experimentando este problema, inspeccione el SquirrelTemp.log recopilado en el equipo donde se produce y busque una entrada "Programa: no se puede finalizar el proceso en el registro".If you’re not on the computer that's having this issue, inspect the SquirrelTemp.log collected from the computer that's experiencing this issue and look for a "Program: Unable to terminate the process in the log" entry.
  • Para determinar qué impide cerrar Teams.exe, mire los registros Dlls.txt y Handles.txt.To determine what's preventing Teams.exe from exiting, look at the Dlls.txt and Handles.txt logs. Estos son los procesos que impidieron el cierre de Teams.These tell you the processes that prevented Teams from exiting.
  • Otra culpable que puede impedir el cierre de Teams es el controlador de filtro del sistema de archivos en el modo kernel.Another culprit that can prevent Teams from exiting is the kernel-mode file system filter driver. Use la herramienta SysInternals, ProcDump, para recopilar el volcado del proceso en modo kernel al ejecutar procdump -mk <pid>, donde es el ID. del proceso obtenido del Administrador de tareas.Use the SysInternals tool, ProcDump, to collect the kernel-mode process dump by running procdump -mk <pid>, where is the process ID obtained from Task Manager. También puede inspeccionar el archivo de registro Driverquery.txt para ver los controladores de filtro activos que pueden interferir con Teams.You can also inspect the Driverquery.txt log file to see the active filter drivers that may interfere with Teams.
  • Para recuperarse de este estado, reinicie el equipo.To recover from this state, restart the computer.

Permisos de archivosFile permissions

Teams crea una serie de subcarpetas y archivos en el perfil de usuario durante el proceso de instalación y actualización.Teams creates a number of subfolders and files in the user's profile throughout the installation and update process. Dado que la aplicación y el actualizador se ejecutan como un usuario sin privilegios elevados, deben concederse permisos de lectura y escritura en las carpetas siguientes:Because the app and the updater runs as a non-elevated user, read and write permissions must be granted on the following folders:

CarpetaFolder Usada porUsed by
%LocalAppData%\SquirrelTemp%LocalAppData%\SquirrelTemp Instalador de Teams (por ejemplo, Teams_Windows_x64.exe) durante la fase de instalaciónTeams installer (for example, Teams_Windows_x64.exe) during installation phase
%LocalAppData%\Microsoft\Teams%LocalAppData%\Microsoft\Teams Actualizador de Teams (Update.exe) para extraer y preparar el paquete de la aplicación durante el proceso de actualizaciónTeams updater (Update.exe) to extract and stage the app package during update process
%AppData%\Microsoft\Teams%AppData%\Microsoft\Teams Aplicación de Teams (Teams.exe) para guardar la configuración, los estados de la aplicación y el paquete de actualización descargado (preconfigurado)Teams app (Teams.exe) to save settings, app states, and the (pre-staged) downloaded update package

Si se deniega el acceso a Teams porque no puede escribir en un archivo, puede que otra aplicación de software interfiera o que una entrada del descriptor de seguridad limite el acceso de escritura a una carpeta.If Teams is denied access because it can't write to a file, another software application may be interfering or a security descriptor entry may be limiting write access to a folder.

Sugerencias para la solución de problemas:Troubleshooting tips:

  • Busque la evidencia "acceso denegado" en SquirrelTemp.log o Logs.txt.Look for "access denied" evidence in SquirrelTemp.log or Logs.txt. Compruebe estos archivos para ver si se ha intentado escribir en un archivo con errores.Check these files to see whether there was an attempt to write to a file that failed.
  • Abra Icacls.txt y busque la entrada de control de acceso (ACE) efectiva que bloquea las operaciones de escritura de un usuario que no es administrador. Normalmente, se encuentra en una de las entradas DACL.Open Icacls.txt and look for the effective access control entry (ACE) that blocks write operations by a user who is not an admin. Typically, this is in one of the DACL entries. Para obtener más información, vea la Documentación de icacls.For more information, see the icacls documentation.

Archivo dañadoFile corrupted

En algunos casos, el software de cifrado puede cambiar archivos en la carpeta %LocalAppData%\Microsoft\Teams, lo que puede impedir iniciar Teams.In some cases, encryption software can change files in the %LocalAppData%\Microsoft\Teams folder, which can prevent Teams from starting. Esto puede ocurrir en cualquier momento, incluso cuando la aplicación no se actualiza.This can happen at any time, even when the app isn't being updated. Por desgracia, cuando un archivo está dañado, la única forma de recuperarse desde este estado es desinstalar y volver a instalar Teams.Unfortunately, when a file is corrupted, the only way to recover from this state is to uninstall and re-install Teams.

Nota

Si no puede determinar la causa subyacente del problema utilizando cualquiera de estos pasos, es posible que quiera probar una sesión del Monitor de procesos.If you can't determine the underlying cause of the issue by using any of these steps, you may want to try a Process Monitor session. Monitor de procesos es una herramienta de Sysinternals que registra el acceso al registro y al sistema de archivos.Process Monitor is a Sysinternals tool that records access to the registry and file system.