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 de páginas

Configure e execute a avaliação de Páginas clássicas.
Valide a cobertura do site, da Web e da Auditoria.
Interpretar e atribuir prioridades aos resultados da página.
Remediar ou mapear peças Web bloqueadas.
Transformar páginas selecionadas com o PnP PowerShell.
Valide as páginas modernas e expanda a onda de migração.

Avaliar o inquilino completo

A autenticação da aplicação é recomendada para uma avaliação de inquilino completo:

Antes de executar o comando, configure o certificado de aplicação.

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 anfitrião do SharePoint sem https://.

Avaliar coleções de sites selecionadas

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

Utilize --sitesfile para um âmbito 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 ficheiro de sites contém um URL absoluto de coleção de sites por linha. Não combine --siteslist e --sitesfile.

Opções específicas da página

Opção	Effect
`--exportwebpartproperties`	Adiciona propriedades de peças Web serializadas a `classicpagewebparts.csv`.
`--skipusageinformation`	Ignora a coleção de utilização 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 as informações do modificador de página.
`--homepageonly`	Filtra o inventário de páginas para a home page de cada Web. Não filtra os resultados de Auditoria no âmbito do site.
`--threads <number>`	Altera o paralelismo. Comece com 4 a 8 threads quando a limitação é uma preocupação.

Importante

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

Por exemplo, avalie apenas as home pages, exporte as propriedades da peça Web e ignore a utilização da 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 de âmbito

Para um inquilino que utiliza URLs personalizados do SharePoint (URLs personalizados), configure e AdminCenterUrlMySiteHostUrl em appsettings.jsone forneça --siteslist ou --sitesfile. Veja Configuração da ferramenta de avaliação.
Para um inquilino da Multi-Geo, execute uma avaliação separada para cada área geográfica. Utilize o anfitrião do inquilino principal no --tenant e forneça as coleções de sites da área geográfica com --siteslist ou --sitesfile.
Execute primeiro um âmbito representativo pequeno para validar a autenticação, a saída, o acesso de auditoria e a duração da análise.
A ferramenta suporta até três avaliações paralelas, mas as análises paralelas aumentam o risco de limitação.

Monitorizar e controlar a avaliação

Listar as avaliações disponíveis:

microsoft365-assessment.exe list

Mostrar status atualizados continuamente:

microsoft365-assessment.exe status

Colocar em pausa e reiniciar uma avaliação:

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

O ID da avaliação também é o nome da pasta de dados local. Reveja o registo nessa pasta se o progresso deixar de ser alterado.

Após a conclusão do processamento do site, status pode mostrar Finalizing enquanto o trabalho pós-análise é executado. A avaliação aguarda até 90 minutos por cada página Consulta de auditoria. Uma consulta pode permanecer notStarted ou running durante essa espera. Se nenhum segmento de auditoria tiver êxito antes de a espera expirar, classicpageauditusage.csv os registos QueryStatus=failed e um SkipReason que comece por QueryTimeout. Reveja [AuditLog] as entradas no registo de avaliação antes de tratar Finalizing como um bloqueio.

Gerar saída do relatório

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

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

A avaliação tem de ser Finished ou intencionalmente Paused antes de um relatório poder ser gerado. A ferramenta rejeita pedidos de relatório para avaliações que ainda estão em execução ou a finalizar.

Gerar apenas ficheiros CSV numa localização personalizada:

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

Por predefinição, o resultado é escrito na report subpasta na pasta assessment-ID.

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

Próximas etapas

Referências

Last updated on 2026-07-30