Ejecución de una evaluación de páginas clásicas

Ejecute la evaluación de páginas clásicas con --mode Classic --classicinclude Pages.

Antes de empezar, complete los requisitos de páginas clásicas.

Flujo de trabajo de modernización de páginas

Configure y ejecute la evaluación de páginas clásicas.
Valide la cobertura de sitio, web y auditoría.
Interpretar y priorizar los resultados de la página.
Corrección o bloqueo de mapas de elementos web.
Transforme las páginas seleccionadas con PowerShell PnP.
Valide las páginas modernas y expanda la oleada de migración.

Evaluación del inquilino completo

Se recomienda la autenticación de aplicaciones para una evaluación de inquilino completo:

Antes de ejecutar el comando, configure el certificado de aplicación.

microsoft365-assessment.exe start --mode Classic --classicinclude Pages `
  --authmode application `
  --tenant <tenant>.sharepoint.com `
  --applicationid <application-id> `
  --certpath "My|CurrentUser|<certificate-thumbprint>"

El --tenant valor es el nombre de host de SharePoint sin https://.

Evaluación de colecciones de sitios seleccionadas

Use --siteslist para una lista corta separada por comas:

microsoft365-assessment.exe start --mode Classic --classicinclude Pages `
  --skipusageinformation `
  --authmode interactive `
  --tenant <tenant>.sharepoint.com `
  --applicationid <application-id> `
  --siteslist "https://<tenant>.sharepoint.com/sites/site1,https://<tenant>.sharepoint.com/sites/site2"

Use --sitesfile para un ámbito mayor:

microsoft365-assessment.exe start --mode Classic --classicinclude Pages `
  --authmode application `
  --tenant <tenant>.sharepoint.com `
  --applicationid <application-id> `
  --certpath "My|CurrentUser|<certificate-thumbprint>" `
  --sitesfile "C:\assessment\sites.txt"

El archivo de sitios contiene una dirección URL de colección de sitios absoluta por línea. No combine --siteslist y --sitesfile.

Opciones específicas de página

Opción	Efecto
`--exportwebpartproperties`	Agrega propiedades de elemento web serializadas a `classicpagewebparts.csv`.
`--skipusageinformation`	Omite la colección de uso de auditoría de Microsoft Graph y no genera `classicpageauditusage.csv`.
`--auditlogwindowdays <1-180>`	Establece la ventana de auditoría. El valor predeterminado es 14 días.
`--skipuserinformation`	Omite la información del modificador de página.
`--homepageonly`	Filtra el inventario de páginas a la página principal de cada web. No filtra los resultados de auditoría con ámbito de sitio.
`--threads <number>`	Cambia el paralelismo. Comience con entre 4 y 8 subprocesos cuando la limitación es un problema.

Importante

Microsoft Graph Audit Query no está disponible para esta evaluación en entornos de nube soberana, incluidos GCC High, DoD y Microsoft 365 operados por 21Vianet. Use --skipusageinformation; dé prioridad a las páginas con ModifiedAt, la importancia de la página y la entrada del propietario de la empresa en lugar de la actividad auditoría.

Por ejemplo, evalúe solo las páginas principales, exporte las propiedades del elemento web y omita el uso de auditoría:

microsoft365-assessment.exe start --mode Classic --classicinclude Pages `
  --homepageonly `
  --exportwebpartproperties `
  --skipusageinformation `
  --authmode application `
  --tenant <tenant>.sharepoint.com `
  --applicationid <application-id> `
  --certpath "My|CurrentUser|<certificate-thumbprint>"

Consideraciones sobre el ámbito

Para un inquilino que usa direcciones URL personalizadas de SharePoint (direcciones URL de vanidad), configure AdminCenterUrl y MySiteHostUrl en appsettings.jsony proporcione --siteslist o --sitesfile. Consulte Configuración de la herramienta de evaluación.
Para un inquilino multigeográfico, ejecute una evaluación independiente para cada ubicación geográfica. Use el host de inquilino principal en --tenant y proporcione las colecciones de sitios de la ubicación geográfica con --siteslist o --sitesfile.
Ejecute primero un ámbito representativo pequeño para validar la autenticación, la salida, el acceso de auditoría y la duración del examen.
La herramienta admite hasta tres evaluaciones paralelas, pero los exámenes paralelos aumentan el riesgo de limitación.

Supervisión y control de la evaluación

Enumerar las evaluaciones disponibles:

microsoft365-assessment.exe list

Mostrar estado actualizado continuamente:

microsoft365-assessment.exe status

Pausar y reiniciar una evaluación:

microsoft365-assessment.exe pause --id <assessment-id>
microsoft365-assessment.exe restart --id <assessment-id>

El identificador de evaluación también es el nombre de la carpeta de datos local. Revise el registro en esa carpeta si el progreso deja de cambiar.

Una vez finalizado el procesamiento del sitio, status se puede mostrar Finalizing mientras se ejecuta el trabajo posterior al examen. La evaluación espera hasta 90 minutos por cada página Consulta de auditoría. Una consulta puede permanecer notStarted o running durante esa espera. Si ningún fragmento de auditoría se realiza correctamente antes de que expire la espera, classicpageauditusage.csv registra y un SkipReason que comienza por QueryTimeoutQueryStatus=failed . Revise [AuditLog] las entradas del registro de evaluación antes de tratar Finalizing como un bloqueo.

Generación de la salida del informe

Genere archivos CSV y, en Windows, la plantilla de Power BI:

microsoft365-assessment.exe report --id <assessment-id>

La evaluación debe ser Finished o intencionadamente Paused antes de que se pueda generar un informe. La herramienta rechaza las solicitudes de informe para las evaluaciones que todavía se están ejecutando o finalizando.

Genere solo archivos CSV en una ubicación personalizada:

microsoft365-assessment.exe report --id <assessment-id> --mode CsvOnly --path "C:\reports"

De forma predeterminada, la salida se escribe en la report subcarpeta de la carpeta assessment-ID.

Se usa --delimiter Semicolon cuando se requiere una exportación delimitada por punto y coma. Use --open false para evitar que el informe generado se abra automáticamente.

Pasos siguientes

Referencia

Last updated on 2026-07-30