Información general sobre la herramienta de evaluación de migración de SharePoint

  • Artículo

La herramienta de evaluación de la migración de SharePoint es una herramienta ejecutable de línea de comandos sencilla. Examina el contenido de la granja de servidores de SharePoint para ayudar a identificar el impacto de migrar el servidor a SharePoint con Microsoft 365.

La herramienta está diseñada para ejecutarse sin afectar al entorno, por lo que es posible que observe que la herramienta requiere de uno a dos días para completar un examen del entorno. Durante este tiempo, la herramienta notifica el progreso en la ventana de la consola. Una vez finalizado el examen, los archivos de salida se encuentran en el directorio Registros. Aquí es donde puede encontrar el resumen y información más detallada sobre los escenarios que podrían verse afectados por la migración.

Nota:

Para descargar la Herramienta de evaluación de migración de SharePoint, vea Descargar la herramienta de evaluación de migración de SharePoint.

Nota:

Para mejorar la calidad de los productos y servicios de Microsoft, la herramienta informa a Microsoft de información estadística anónima. Opcionalmente, puede identificar su organización cuando se le solicite al final del examen. Si la herramienta no se puede conectar a Internet para informar de esta información, la herramienta seguirá funcionando según lo esperado.

Requisitos previos

La herramienta se compila para ejecutarse desde una granja de servidores de SharePoint 2010, 2013 o 2016 y tiene estos requisitos previos:

  • Para ejecutar la herramienta, todos los archivos deben extraerse de cualquier paquete comprimido antes de la ejecución.

  • La herramienta debe ejecutarse como la cuenta de servicio de granja de servidores. Una cuenta de administrador de granja de servidores es aceptable siempre que se le haya concedido acceso de lectura a todas las aplicaciones web. La cuenta también necesita permisos explícitos de control total enlos administradoresde operaciones> ypermisosde uso compartido> en la aplicación de servicio de perfil de usuario. Hay una serie de comprobaciones para asegurarse de que la cuenta tiene permisos suficientes antes de analizar el entorno.

  • La herramienta solo admite versiones en inglés de SharePoint.

Archivos de configuración

Puede modificar dos archivos de configuración para SMAT:

  • SiteSkipList.csv se instala en el mismo directorio que SMAT.exe. Agregar sitios a este CSV indica a SMAT que no incluya estos sitios en la salida del informe. Para obtener ejemplos sobre cómo agregar sitios a la lista de omisión, consulte SiteSkipList.csv.

  • ScanDef.json se instala en el mismo directorio que el SMAT. Puede usar ScanDef.json para habilitar o deshabilitar exámenes individuales de SMAT. Este archivo contiene configuraciones para la evaluación en SharePoint 2010 y 2013.

Para deshabilitar un examen, busque la entrada en el archivo ScanDef.json y establezca Habilitado en false. Esto es útil si hay un examen que no le importa a su empresa. Deshabilitar el examen reduce el tiempo de ejecución general de SMAT.

A continuación se deshabilita el examen alertas.

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

SupportedVersion informa a SMAT a qué versiones de SharePoint se aplica un examen específico. Por ejemplo, SharePoint 2010 no tenía complementos de SharePoint, por lo que el analizador de aplicaciones no muestra 2010 como una versión compatible.

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

Algunos exámenes tienen opciones de configuración adicionales. Se pueden configurar en el archivo ScanDef.json. No todos los exámenes tienen propiedades configurables. Sin embargo, si un examen tiene una propiedad, hay una propiedad predeterminada configurada en el archivo ScanDef.json que se puede modificar. Por ejemplo, el examen SiteTemplateLanguage tiene un filtro para excluir sitios en inglés [configuración regional 1033]. Si su equipo tiene dudas sobre la migración de sitios en inglés, puede modificar el filtro para incluir esos sitios:

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

Si quita o daña el archivo ScanDef.json, se usará una configuración predeterminada incrustada en el archivo ejecutable SMAT.exe. Esto se indica en el archivo SMAT.log. Si deshabilita un examen o cambia una propiedad y observa que el cambio no se selecciona al ejecutar SMAT.exe, busque más información en el archivo SMAT.log.

Ejecución

Ejecute smat.exe desde la ubicación de los archivos extraídos. Para ver todos los parámetros disponibles, ejecute: smat.exe /help.

SMAT.exe es un programa iniciador que determina sus intenciones en función de los parámetros pasados y, a continuación, carga la aplicación adecuada para realizar el trabajo solicitado. En segundo plano, hay tres archivos ejecutables que son responsables de realizar el trabajo:

  • SMAT2010.exe : realiza una evaluación en entornos de SharePoint 2010.

  • SMAT2013.exe : realiza una evaluación en entornos de SharePoint 2013.

  • SMIT.exe : realiza el trabajo de asignación de identidades para entornos de SharePoint 2010 y 2013.

Nota:

SMIT deja de funcionar después del 30 de junio de 2023 debido al desuso del servicio Graph de Azure AD. Para obtener más información sobre el anuncio más reciente, consulte Importante: Retirada de Azure AD Graph y Desuso del módulo de PowerShell. Al ejecutar SMAT.exe para realizar una evaluación desde PowerShell.exe, se producen las siguientes acciones. La ventana de PowerShell que ejecuta SMAT.exe inicia la aplicación para realizar el trabajo. Una vez cargada la aplicación de trabajo, finaliza el programa de cargador de SMAT.exe y devuelve el control al operador. La herramienta que realiza el trabajo se ejecuta en su propia ventana hasta que se completa.

Archivos de registro

Es posible que vea hasta tres archivos de registro en el directorio de salida:

  • SMAT.log : este archivo contiene todo el registro de la ejecución de la herramienta. Contiene tres niveles de registro: Información, Advertencia y Errores. La información ayuda a realizar un seguimiento del progreso y solucionar problemas. Normalmente, las advertencias son condiciones de error esperadas. Los errores son condiciones inesperadas que nuestras herramientas no pudieron determinar si serán un bloqueador para avanzar. Estos deben revisarse.

  • SMAT_Errors.log : solo contiene los eventos Error. Si falta este archivo una vez completadas las herramientas, indica que no se encontró ningún error.

  • SMATTelemetry.log : contiene el registro de las herramientas de carga de telemetría. Los problemas que se produzcan aquí no afectan a la generación de informes.

Automatización de la evaluación

Si necesita programar el proceso de evaluación, puede hacerlo ejecutando el archivo .exe específico. Por ejemplo, si desea configurar una tarea programada en una granja de SharePoint 2010 para su evaluación, señalaría la tarea programada a SMAT2010.exe. Si desea escribir un script de PowerShell que haya ejecutado la evaluación en SharePoint 2013, apuntaría el script a SMAT2013.exe.

Cualquier escenario de scripting debe usar el -q modificador para ejecutar el archivo .exe en modo silencioso. Este modo no proporciona ninguna salida a la consola y evita cualquier cosa que solicite entrada al operador.

Más información

Para descargar la herramienta de migración de SharePoint y para obtener más información sobre cómo solucionar los problemas identificados en los informes de evaluación, vea