Executar uma avaliação de páginas clássicas

Execute a avaliação de páginas clássicas com --mode Classic --classicinclude Pages.

Antes de começar, preencha os requisitos de páginas clássicas.

Fluxo de trabalho de modernização da página

Configure e execute a avaliação de páginas clássicas.
Valide a cobertura de site, Web e auditoria.
Interprete e priorize os resultados da página.
Corrigir ou mapear Web Parts de bloqueio.
Transformar páginas selecionadas com o PowerShell PnP.
Valide as páginas modernas e expanda a onda de migração.

Avaliar o locatário completo

A autenticação de aplicativo é recomendada para uma avaliação de locatário completo:

Antes de executar o comando, configure o certificado do aplicativo.

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

O --tenant valor é o nome do host do SharePoint sem https://.

Avaliar conjuntos de sites selecionados

Use --siteslist para uma lista curta separada por vírgulas:

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 um escopo maior:

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"

O arquivo de sites contém uma URL absoluta de conjunto de sites por linha. Não combine --siteslist e --sitesfile.

Opções específicas da página

Opção	Effect
`--exportwebpartproperties`	Adiciona propriedades de web part serializadas ao `classicpagewebparts.csv`.
`--skipusageinformation`	Ignora a coleta de uso de auditoria do Microsoft Graph e não gera `classicpageauditusage.csv`.
`--auditlogwindowdays <1-180>`	Define a janela de auditoria. O padrão é 14 dias.
`--skipuserinformation`	Omite informações do modificador de página.
`--homepageonly`	Filtra o inventário da página para a página inicial de cada site. Ele não filtra os resultados de auditoria no escopo do site.
`--threads <number>`	Altera o paralelismo. Comece com 4 a 8 threads quando a limitação for uma preocupação.

Importante

A Consulta de Auditoria do Microsoft Graph não está disponível para esta avaliação em ambientes de nuvem soberana, incluindo GCC High, DoD e Microsoft 365 operados pela 21Vianet. Use --skipusageinformation; priorize páginas com ModifiedAta importância da página e a entrada do proprietário da empresa em vez da atividade de auditoria.

Por exemplo, avalie apenas as home pages, exporte propriedades da Web Part e ignore o uso de auditoria:

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>"

Considerações sobre escopo

Para um locatário que usa URLs personalizadas do SharePoint (URLs intuitivas), configure ambos AdminCenterUrl e MySiteHostUrl em appsettings.jsone forneça --siteslist ou --sitesfile. Consulte Configuração da ferramenta de avaliação.
Para um locatário Multi-Geo, execute uma avaliação separada para cada área geográfica. Use o host de locatário principal e --tenant forneça os conjuntos de sites da área geográfica com --siteslist ou --sitesfile.
Execute um pequeno escopo representativo primeiro para validar a autenticação, a saída, o acesso de auditoria e a duração da verificação.
A ferramenta é compatível com até três avaliações paralelas, mas varreduras paralelas aumentam o risco de limitação.

Monitorar e controlar a avaliação

Listar avaliações disponíveis:

microsoft365-assessment.exe list

Mostrar o status atualizado continuamente:

microsoft365-assessment.exe status

Pausar e reiniciar uma avaliação:

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

A ID de avaliação também é o nome da pasta de dados local. Revise o log nessa pasta se o progresso parar de mudar.

Após a conclusão do processamento do site, status pode mostrar Finalizing enquanto o trabalho pós-verificação é executado. A avaliação aguarda até 90 minutos por cada consulta de auditoria de página. Uma consulta pode permanecer notStarted ou running durante essa espera. Se nenhuma parte de auditoria for bem-sucedida antes que a espera expire, classicpageauditusage.csv os registros QueryStatus=failed e um SkipReason que começa com QueryTimeout. Revise [AuditLog] as entradas no log de avaliação antes de tratá-lo Finalizing como um travamento.

Gerar saída do relatório

Gere arquivos CSV e, no Windows, o modelo do Power BI:

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

A avaliação deve ser Finished ou intencionalmente Paused antes que um relatório possa ser gerado. A ferramenta rejeita solicitações de relatório para avaliações que ainda estão em execução ou finalizando.

Gere somente arquivos CSV em um local personalizado:

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

Por padrão, a saída é gravada na report subpasta na pasta assessment-ID.

Use --delimiter Semicolon quando uma exportação delimitada por ponto-e-vírgula for necessária. Use --open false para impedir que o relatório gerado seja aberto automaticamente.

Próximas etapas

Referências

Last updated on 2026-08-24