Información general sobre la herramienta de evaluación de migración de SharePointOverview of the SharePoint Migration Assessment Tool

La herramienta de evaluación de migración de SharePoint es un ejecutable sencillo de línea de comandos que examina el contenido de la granja de SharePoint para ayudar a identificar el impacto de la migración del servidor a SharePoint con Microsoft 365.The SharePoint Migration Assessment Tool is a simple command line executable that scans the contents of your SharePoint farm to help identify the impact of migrating your server to SharePoint with Microsoft 365.

Como la herramienta está diseñada para ejecutarse sin afectar al entorno, puede observar que la herramienta requiere de uno a dos días para completar un análisis del entorno.As the tool is designed to run without impacting your environment, you may observe the tool requires one to two days to complete a scan of your environment. Durante este tiempo, la herramienta informa del progreso en la ventana de la consola.During this time, the tool reports progress in the console window. Una vez finalizado el examen, puede buscar archivos de salida en el directorio de registros.After the scan is complete, you can find output files in the Logs directory. Aquí puede encontrar el Resumen y una información más detallada sobre los escenarios que podrían verse afectados por la migración.This is where you can find the summary and more detailed insights into the scenarios that could be impacted by migration.

Nota

Para descargar la herramienta de migración de SharePoint, vaya a descargar la herramienta de evaluación de migración de SharePoint .To download the SharePoint Migration Tool, go to Download the SharePoint Migration Assessment Tool

Nota

Para mejorar la calidad de los productos y servicios de Microsoft, la herramienta informará a Microsoft de la información estadística anónima.To improve the quality of Microsoft products and services, the tool will report anonymous statistical information back to Microsoft. Opcionalmente, puede identificar la organización cuando se le solicite al final del análisis.Optionally, you can identify your organization when prompted at the end of the scan. Si la herramienta no puede conectarse a Internet para informar de esta información, la herramienta seguirá funcionando como se esperaba.If the tool is not able to connect to the internet to report this information, the tool will still function as otherwise expected.

Modos de la herramienta de evaluación de migración de SharePointModes in SharePoint Migration Assessment Tool

La herramienta ofrece dos modos: evaluación y asignación de identidad.The tool offers two modes: Assessment and Identity Mapping.

EvaluaciónAssessment

Este es el modo predeterminado.This is the default mode. Si ejecuta SMAT.exe, se ejecutará la evaluación.If you run SMAT.exe, the assessment will run. El proceso de evaluación ejecuta los análisis de la granja de servidores de SharePoint y el contenido asociado que busca problemas que se sabe que causan problemas a los clientes que migran a SharePoint.The assessment process runs scans against the SharePoint farm and associated content looking for issues that have been known to cause issues for customers migrating into SharePoint. Para obtener más información acerca de los exámenes disponibles, consulte herramienta de evaluación de la migración de SharePoint: Guía básica de informes de análisisFor more info about the scans that are available, see SharePoint Migration Assessment Tool: Scan Reports Roadmap

Asignación de identidadIdentity Mapping

La asignación de identidad permite generar un informe de todas las identidades de usuario y grupo que tienen acceso a su entorno de SharePoint e intenta asignar esas identidades a identidades de grupo y usuario de Azure AD.Identity Mapping lets you to generate a report of all the user and group identities that have access to your SharePoint environment and attempts to map those identities to Azure AD user and group identities.

Este proceso es muy importante para la migración.This process is very important to migration. Si las identidades no se han configurado correctamente antes de la migración, puede provocar que los usuarios pierdan el acceso al contenido y que la información sea incorrecta en el sitio.If identities are not properly set up prior to migration, it can result in users losing access to content as well as information being incorrect in the site. Por ejemplo, los campos creado por y modificado no mostrarán la identidad correcta después de la migración.For example, the Created By and Modified fields will not show the correct identity post migration.

Para obtener más información sobre la asignación de identidad, consulte herramienta de asignación de identidades de migración de SharePoint.For more info about Identity Mapping, see SharePoint Migration Identity Mapping Tool.

Requisitos previosPrerequisites

La herramienta se ha creado para ejecutarse desde una granja de servidores de SharePoint 2010 o 2013.The tool is built to be run from within a SharePoint 2010 or 2013 farm.

  • Para ejecutar la herramienta, todos los archivos deben extraerse de cualquier paquete comprimido antes de la ejecución.To run the tool, all files must be extracted from any compressed package before execution.

  • La herramienta debe ejecutarse como la cuenta de servicio de la granja de servidores.The tool must run as the Farm service account. Una cuenta de administrador de la granja de servidores es aceptable siempre que se haya concedido a la cuenta acceso de lectura a todas las aplicaciones Web.A farm administrator account is acceptable as long as the account has been given read access to all web applications. La cuenta también necesita permisos explícitos de control total en las dos operaciones | Administradores y compartir | Permisos en la aplicación de servicio de perfiles de usuario.The account also needs explicit Full Control permissions on both Operations | Administrators and Sharing | Permissions on the User Profile Service Application. Hay una serie de comprobaciones para asegurarse de que la cuenta tiene permisos suficientes antes de examinar el entorno.There are a series of checks to ensure the account has enough permissions prior to scanning the environment.

  • La herramienta solo admite versiones en Inglés de SharePoint.The tool only supports English versions of SharePoint.

Archivos de configuraciónConfig files

Puede modificar dos archivos de configuración para SMAT.You can modify two config files for SMAT.

SiteSkipList.csv se instala en el mismo directorio que SMAT.exe.SiteSkipList.csv is installed in same directory as SMAT.exe. Agregar sitios a este CSV le dirá a SMAT que no incluya estos sitios en el resultado del informe.Adding sites to this CSV will tell SMAT not to include these sites in the report output. Para obtener ejemplos sobre cómo agregar sitios a la lista de omisión, consulte SiteSkipList.csv.For examples about how to add sites to the skip list, see SiteSkipList.csv.

ScanDef.jsen está instalado en el mismo directorio que SMAT.ScanDef.json is installed in the same directory as the SMAT. Puede usar ScanDef.jspara habilitar o deshabilitar los análisis individuales para SMAT.You can use ScanDef.json to enable or disable individual scans for SMAT. Este archivo contiene configuraciones para la evaluación tanto en SharePoint 2010 como en 2013, así como para la asignación de identidades.This file contains configurations for assessment on both SharePoint 2010 and 2013 as well as Identity Mapping.

Para deshabilitar un análisis, busque la entrada en el ScanDef.jsen archivo y establezca habilitado en falso.To disable a scan, locate the entry in the ScanDef.json file, and set Enabled to false. Esto es útil si hay un análisis que no le interesa a su empresa.This is useful if there is a scan that your business doesn't care about. La deshabilitación del análisis reduce el tiempo de ejecución general de SMAT.Disabling the scan reduces the overall execution time of SMAT.

A continuación, se deshabilita el análisis de alertas.The following disables the Alerts scan.

{"Name": "Alerts", "type": "AlertsScanner", "SupportedVersions": ["2010", "2013", "2016"], "ReportCategoryType": "SPSite", "Enabled": false}{ "Name": "Alerts", "Type": "AlertsScanner", "SupportedVersions": [ "2010", "2013", "2016" ], "ReportCategoryType": "SPSite", "Enabled": false }

El SupportedVersion informa a SMAT las versiones de SharePoint a las que se aplica un análisis determinado.The SupportedVersion informs SMAT which versions of SharePoint a given scan applies to. Por ejemplo, SharePoint 2010 no tenía complementos de SharePoint, por lo que el explorador de aplicaciones no muestra 2010 como una versión compatible.For example, SharePoint 2010 did not have SharePoint Add-ins, so the Apps scanner does not list 2010 as a supported version.

{"Name": "apps", "type": "AppsScanner", "SupportedVersions": ["2013", "2016"], "ReportCategoryType": "SPSite", "Enabled": true}{ "Name": "Apps", "Type": "AppsScanner", "SupportedVersions": [ "2013", "2016" ], "ReportCategoryType": "SPSite", "Enabled": true }

Algunos exámenes tienen opciones de configuración adicionales.Some scans have additional configuration options. Se pueden configurar en el ScanDef.jsen el archivo.These are configurable in the ScanDef.json file. No todos los exámenes tienen propiedades configurables.Not all scans have configurable properties. Sin embargo, si un examen tiene una propiedad, hay un valor predeterminado configurado en el ScanDef.jsen el archivo que se puede modificar.However, if a scan does have a property, there is a default configured in the ScanDef.json file that can be modified. Por ejemplo, el análisis de SiteTemplateLanguage tiene un filtro para excluir los sitios en inglés [configuración regional 1033].For example, the SiteTemplateLanguage scan has a filter to exclude English sites [locale 1033]. Si su equipo tiene dudas sobre la migración de sitios en inglés, puede modificar el filtro para que incluya estos sitios:If your team has concerns about migrating English sites, you could modify the filter to include those sites:

{"Nombre": "SiteTemplateLanguage", "tipo": "SiteTemplateLanguageScanner", "SupportedVersions": ["2010", "2013", "2016"], "propiedad": {"ExcludedLanguages": ""}, "ReportCategoryType": "SPSite", "Enabled": true}{ "Name": "SiteTemplateLanguage", "Type": "SiteTemplateLanguageScanner", "SupportedVersions": [ "2010", "2013", "2016" ], "Property": { "ExcludedLanguages": "" }, "ReportCategoryType": "SPSite", "Enabled": true }

Si quita o daña la ScanDef.jsen el archivo, se utilizará una configuración predeterminada incrustada en el ejecutable de SMAT.exe en su lugar.If you remove or corrupt the ScanDef.json file, a default configuration that is embedded in the SMAT.exe executable will be used instead. Esto se indica en el archivo SMAT. log.This is noted in the SMAT.log file. Si realiza un cambio para deshabilitar un análisis o una propiedad y observa que el cambio no se ha seleccionado al ejecutar SMAT.exe, mire los detalles en el archivo SMAT. log.If you make a change to disable a scan or a property and notice the change is not picked up when you run SMAT.exe, look in the SMAT.log file for details.

EjecuciónExecution

Ejecutar smat.exe desde la ubicación de los archivos extraídos.Run smat.exe from the extracted files location. Para ver todos los parámetros disponibles, ejecute: smat.exe/help.To see all the available parameters, run: smat.exe /help.

SMAT.exe es un programa de iniciador que determina sus intenciones en función de los parámetros que se han pasado y, a continuación, carga la aplicación adecuada para realizar el trabajo solicitado.SMAT.exe is a launcher program that determines your intentions based on the parameters passed in, and then loads the appropriate application to do the work requested. En las cubiertas, hay tres ejecutables que son responsables de hacer el trabajo:Under the covers, there are three executables that are responsible for doing the work:

  • SMAT2010.exe: realiza una evaluación en entornos de SharePoint 2010.SMAT2010.exe - Performs assessment on SharePoint 2010 environments.

  • SMAT2013.exe: realiza una evaluación en entornos de SharePoint 2013.SMAT2013.exe - Performs assessment on SharePoint 2013 environments.

  • SMIT.exe: realiza trabajos de asignación de identidades para entornos de SharePoint 2010 y 2013.SMIT.exe - Performs identity mapping work for both SharePoint 2010 and 2013 environments.

Al ejecutar SMAT.exe para realizar la evaluación desde PowerShell.exe, se producen las siguientes acciones.When running SMAT.exe to perform assessment from PowerShell.exe, the following actions occur. La ventana de PowerShell que ejecuta SMAT.exe inicia la aplicación para realizar el trabajo.The PowerShell window running SMAT.exe launches the app to perform the work. Después de cargar la aplicación de trabajo, el programa Loader de SMAT.exe finaliza y devuelve el control al operador.After the working app is loaded, the SMAT.exe loader program terminates, and returns control to the operator. La herramienta que realiza el trabajo se ejecuta en su propia ventana hasta que se completa.The tool performing the work runs in its own window until it completes.

Archivos de registroLog files

Es posible que vea hasta tres archivos de registro en el directorio de salida.You may see up to three log files in the output directory.

  • SMAT. log : este archivo contiene todo el registro de la ejecución de la herramienta.SMAT.log - This file contains all the logging from the tool execution. Esto contendrá 3 niveles de registro.This will contain 3 levels of logging. Información, ADVERTENCIA y errores.Information, Warning, and Errors. La información ayuda a realizar un seguimiento del progreso y solucionar problemas.Information help track down progress and troubleshooting issues. Las advertencias suelen ser condiciones de error esperadas.Warnings are typically expected error conditions. Los errores son condiciones inesperadas que nuestras herramientas no pudieron determinar si serán un bloqueador para avanzar.Errors are unexpected conditions that our tooling was unable to determine if they will be a blocker to moving forward. Es necesario revisarlos.These need to be reviewed.

  • SMAT_Errors. log : solo contiene los eventos de error.SMAT_Errors.log - This contains only the Error events. Si falta este archivo después de que se complete la herramienta, significa que no se han encontrado errores.If this file is missing after the tooling completes, it indicates there were no errors found.

  • SMATTelemetry. log : contiene el registro de las herramientas de carga de telemetría.SMATTelemetry.log - This contains logging for the telemetry upload tooling. Los problemas que se detallan aquí no afectan a la generación de informes.Any issues in here do not impact generating your reports.

Automatizar la evaluaciónAutomating assessment

Si tiene la necesidad de programar el proceso de evaluación, puede hacerlo ejecutando el archivo EXE específico.If you have the need to schedule the assessment process, you can do so by running the specific EXE. Por ejemplo, si desea configurar una tarea programada en una granja de servidores de SharePoint 2010 para su evaluación, deberá apuntar la tarea programada a SMAT2010.exe.For example, if you want to setup a scheduled task on a SharePoint 2010 farm for assessment, you would point the scheduled task to SMAT2010.exe. Si deseara escribir un script de PowerShell que ejecutara la evaluación en SharePoint 2013, apuntaría al script a SMAT2013.exe.If you wanted to write a PowerShell script that ran assessment on SharePoint 2013, you would point the script to SMAT2013.exe.

Cualquier escenario de scripting debe usar el modificador-q para ejecutar el EXE en modo silencioso.Any scripting scenario must use the -q switch to run the EXE in quiet mode. Este modo no produce ningún resultado en la consola y evita todo lo que pueda solicitarle al operador una entrada.This mode does not output anything to the console and avoids anything that would prompt the operator for input.

En este momento, el archivo ejecutable para la asignación de identidad [SMIT.exe] no admite el scripting.At this time, the executable for Identity Mapping [SMIT.exe] does not support scripting. Este proceso solicita las credenciales a Azure como mínimo y puede pedir credenciales para conectarse a Active Directory.This process prompts for credentials to Azure at a minimum and may prompt for credentials to connect to Active Directory. Si intenta crear una secuencia de comandos con este archivo ejecutable, se bloquea y no se completa nunca cuando el programa solicita las credenciales.If you attempt to script against this executable, it hangs and never completes when the program prompts for credentials.

Más informaciónMore info

Para descargar la herramienta de migración de SharePoint y obtener más información sobre cómo solucionar los problemas identificados en los informes de evaluación, consulteTo download the SharePoint Migration Tool, and for more info about how to address issues identified in the assessment reports, see