Compartilhar via

Visão geral da Ferramenta de Avaliação de Migração do SharePoint

  • Artigo

A Ferramenta de Avaliação de Migração do SharePoint é uma ferramenta executável de linha de comandos simples. Analisa os conteúdos do farm do SharePoint para ajudar a identificar o impacto da migração do servidor para o SharePoint com o Microsoft 365.

A ferramenta foi concebida para ser executada sem afetar o seu ambiente, pelo que poderá observar que a ferramenta necessita de um a dois dias para concluir uma análise do seu ambiente. Durante este período, a ferramenta comunica o progresso na janela da consola. Após a conclusão da análise, os ficheiros de saída encontram-se no diretório Registos. Os ficheiros de registo são onde pode encontrar o resumo e informações mais detalhadas sobre os cenários afetados pela migração.

Observação

Para transferir a Ferramenta de Avaliação de Migração do SharePoint, veja Transferir a Ferramenta de Avaliação de Migração do SharePoint.

Observação

Para melhorar a qualidade dos produtos e serviços Microsoft, a ferramenta comunica informações estatísticas anónimas à Microsoft. Opcionalmente, pode identificar a sua organização quando lhe for pedido no final da análise. Se a ferramenta não conseguir ligar-se à Internet para comunicar estas informações, a ferramenta continuará a funcionar conforme esperado.

Pré-requisitos

A ferramenta deve ser executada a partir de um farm do SharePoint 2010, 2013 ou 2016 e tem estes pré-requisitos:

  • Para executar a ferramenta, todos os ficheiros têm de ser extraídos de qualquer pacote comprimido antes da execução.
  • A ferramenta tem de ser executada como a conta de serviço do Farm. Uma conta de administrador do farm é aceitável desde que seja concedido acesso de leitura à conta a todas as aplicações Web. A conta também precisa de permissões de Controlo Total explícitas emAdministradores de Operações> ePermissões de Partilha> na aplicação de serviço Perfil de Utilizador. Existe uma série de verificações para garantir que a conta tem permissões suficientes antes de analisar o ambiente.
  • A ferramenta suporta apenas versões em inglês do SharePoint.

Ficheiros de configuração

Pode modificar dois ficheiros de configuração para o SMAT:

  • SiteSkipList.csv está instalado no mesmo diretório que SMAT.exe. Adicionar sites a este CSV indica ao SMAT para não incluir estes sites na saída do relatório. Para obter exemplos sobre como adicionar sites à lista de ignorar, consulte SiteSkipList.csv.
  • ScanDef.json está instalado no mesmo diretório do SMAT. Pode utilizar ScanDef.json para ativar ou desativar análises individuais para o SMAT. Este ficheiro contém configurações para avaliação no SharePoint 2010 e 2013.

Para desativar uma análise, localize a entrada no ficheiro ScanDef.json e defina Ativado como falso. Esta definição é útil se existir uma análise da qual a sua empresa não se importa. Desativar a análise reduz o tempo de execução geral do SMAT.

A configuração seguinte desativa a análise de Alertas.

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

A SupportedVersion informa o SMAT a que versões do SharePoint se aplica uma análise específica. Por exemplo, o SharePoint 2010 não tinha suplementos do SharePoint, pelo que o scanner aplicações não lista 2010 como uma versão suportada.

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

Algumas análises têm opções de configuração adicionais. Estas opções são configuráveis no ficheiro ScanDef.json. Nem todas as análises têm propriedades configuráveis. No entanto, se uma análise tiver uma propriedade, existe uma propriedade predefinida configurada no ficheiro ScanDef.json que pode ser modificado. Por exemplo, a análise SiteTemplateLanguage tem um filtro para excluir sites em inglês [região 1033]. Se a sua equipa estiver preocupada com a migração de sites em inglês, pode modificar o filtro para incluir esses sites:

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

Se remover ou danificar o ficheiro ScanDef.json, é utilizada uma configuração predefinida incorporada no ficheiro executável SMAT.exe. Esta alteração é anotado no ficheiro SMAT.log. Se desativar uma análise ou alterar uma propriedade e reparar que a alteração não é detetada quando executa SMAT.exe, procure detalhes no ficheiro de SMAT.log.

Execução

Execute smat.exe a partir da localização dos ficheiros extraídos. Para ver todos os parâmetros disponíveis, execute: smat.exe /help.

SMAT.exe é um programa de iniciador que determina as suas intenções com base nos parâmetros transmitidos e, em seguida, carrega a aplicação adequada para fazer o trabalho pedido. Nos limites, existem três ficheiros executáveis que são responsáveis por fazer o trabalho:

  • SMAT2010.exe – efetua uma avaliação em ambientes do SharePoint 2010.
  • SMAT2013.exe – efetua uma avaliação em ambientes do SharePoint 2013.
  • SMIT.exe - Executa o trabalho de mapeamento de identidades para ambientes do SharePoint 2010 e 2013.

Observação

O SMAT deixou de funcionar após 30 de junho de 2023 devido à descontinuação do serviço Azure AD Graph. Para obter mais informações sobre o anúncio mais recente, veja Importante: Azure AD Descontinuação do Graph e Descontinuação do Módulo do PowerShell. Ao executar SMAT.exe para efetuar uma avaliação a partir de PowerShell.exe, ocorrem as seguintes ações. A janela do PowerShell em execução SMAT.exe inicia a aplicação para executar o trabalho. Depois de carregar a aplicação de trabalho, o programa SMAT.exe carregador termina e devolve o controlo ao operador. A ferramenta que executa o trabalho é executada na sua própria janela até ser concluída.

Arquivos de log

Poderá ver até três ficheiros de registo no diretório de saída:

  • SMAT.log - Este ficheiro contém todos os registos da execução da ferramenta. Este ficheiro contém três níveis de registo: Informações, Aviso e Erros. As informações ajudam a monitorizar o progresso e a resolver problemas. Normalmente, os Avisos são condições de erro esperadas. Os erros são condições inesperadas em que as nossas ferramentas não conseguiram determinar se são um bloqueador para avançar ou não. Estes bloqueadores têm de ser revistos.
  • SMAT_Errors.log - Este ficheiro contém apenas os Eventos de erro. Se este ficheiro estiver em falta após a conclusão das ferramentas, significa que não foram encontrados erros.
  • SMATTelemetry.log - Este ficheiro contém o registo das ferramentas de carregamento de telemetria. Os problemas aqui apresentados não afetam a geração dos seus relatórios.

Automatizar a avaliação

Se precisar de agendar o processo de avaliação, pode fazê-lo ao executar o ficheiro de .exe específico. Por exemplo, se quiser configurar uma tarefa agendada num farm do SharePoint 2010 para avaliação, apontaria a tarefa agendada para SMAT2010.exe. Se quiser escrever um script do PowerShell que executou a avaliação no SharePoint 2013, apontaria o script para SMAT2013.exe.

Qualquer cenário de scripting tem de utilizar o -q comutador para executar o ficheiro .exe no modo silencioso. Este modo não fornece qualquer saída para a consola do e evita qualquer item que pede entrada ao operador.

Mais informações

Para transferir a Ferramenta de Migração do SharePoint e para obter mais informações sobre como resolver problemas identificados nos relatórios de avaliação, consulte: