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 comando simples. Ele examina o conteúdo do seu farm do SharePoint para ajudar a identificar o impacto da migração do servidor para o SharePoint com o Microsoft 365.

A ferramenta foi projetada para ser executada sem afetar seu ambiente, portanto, você pode observar que a ferramenta requer de um a dois dias para concluir uma verificação do seu ambiente. Durante esse tempo, a ferramenta relata o progresso na janela do console. Após a conclusão da verificação, os arquivos de saída estão no diretório Logs. É aqui que você pode encontrar o resumo e informações mais detalhadas sobre os cenários que podem ser afetados pela migração.

Observação

Para baixar a Ferramenta de Avaliação de Migração do SharePoint, consulte Baixar a Ferramenta de Avaliação de Migração do SharePoint.

Observação

Para melhorar a qualidade dos produtos e serviços da Microsoft, a ferramenta relata informações estatísticas anônimas de volta à Microsoft. Opcionalmente, você pode identificar sua organização quando solicitado no final da verificação. Se a ferramenta não puder se conectar à Internet para relatar essas informações, a ferramenta ainda funcionará como esperado.

Pré-requisitos

A ferramenta é criada para ser executada de dentro de um farm do SharePoint 2010, 2013 ou 2016 e tem esses pré-requisitos:

  • Para executar a ferramenta, todos os arquivos devem ser extraídos de qualquer pacote compactado antes da execução.

  • A ferramenta deve ser executada como a conta de serviço farm. Uma conta de administrador do farm é aceitável desde que a conta tenha recebido acesso de leitura a todos os aplicativos Web. A conta também precisa de permissões explícitas de Controle Total emadministradores de operações> epermissõesde compartilhamento> no aplicativo de serviço Perfil de Usuário. Há uma série de verificações para garantir que a conta tenha permissões suficientes antes de examinar o ambiente.

  • A ferramenta dá suporte apenas a versões em inglês do SharePoint.

Arquivos de configuração

Você pode modificar dois arquivos de configuração para SMAT:

  • SiteSkipList.csv é instalado no mesmo diretório que SMAT.exe. Adicionar sites a este CSV informa ao SMAT para não incluir esses sites na saída do relatório. Para obter exemplos sobre como adicionar sites à lista de ignorar, consulte SiteSkipList.csv.

  • ScanDef.json é instalado no mesmo diretório que o SMAT. Você pode usar ScanDef.json para habilitar ou desabilitar verificações individuais para SMAT. Este arquivo contém configurações para avaliação no SharePoint 2010 e 2013.

Para desabilitar uma verificação, localize a entrada no arquivo ScanDef.json e defina Habilitado como false. Isso será útil se houver uma verificação com a qual sua empresa não se importa. Desabilitar a verificação reduz o tempo de execução geral do SMAT.

O seguinte desabilita a verificação alertas.

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

O SupportedVersion informa ao SMAT a quais versões do SharePoint uma verificação específica se aplica. Por exemplo, o SharePoint 2010 não tinha suplementos do SharePoint, portanto, o scanner de aplicativos não lista 2010 como uma versão com suporte.

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

Algumas verificações têm opções de configuração adicionais. Elas são configuráveis no arquivo ScanDef.json. Nem todas as verificações têm propriedades configuráveis. No entanto, se uma verificação tiver uma propriedade, haverá uma propriedade padrão configurada no arquivo ScanDef.json que pode ser modificada. Por exemplo, a verificação SiteTemplateLanguage tem um filtro para excluir sites em inglês [locale 1033]. Se sua equipe tiver preocupações com a migração de sites em inglês, você poderá modificar o filtro para incluir esses sites:

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

Se você remover ou corromper o arquivo ScanDef.json, uma configuração padrão inserida no arquivo executável SMAT.exe será usada. Isso é observado no arquivo SMAT.log. Se você desabilitar uma verificação ou alterar uma propriedade e notar que a alteração não é detectada quando você executar SMAT.exe, procure no arquivo SMAT.log para obter detalhes.

Execução

Execute smat.exe do local dos arquivos extraídos. Para ver todos os parâmetros disponíveis, execute: smat.exe /help.

SMAT.exe é um programa de inicialização que determina suas intenções com base nos parâmetros passados e carrega o aplicativo apropriado para fazer o trabalho solicitado. Nas capas, há três arquivos executáveis responsáveis por fazer o trabalho:

  • SMAT2010.exe – realiza avaliação em ambientes do SharePoint 2010.

  • SMAT2013.exe – realiza avaliação em ambientes do SharePoint 2013.

  • SMIT.exe – executa um trabalho de mapeamento de identidade para ambientes do SharePoint 2010 e 2013.

Observação

O SMIT para de funcionar após 30 de junho de 2023 devido à preterição do serviço Azure AD Graph. Para obter mais detalhes sobre o último anúncio, consulte Importante: Azure AD Reforma do Graph e Preterição do Módulo do Powershell. Ao executar SMAT.exe para executar uma avaliação de PowerShell.exe, as ações a seguir ocorrem. A janela do PowerShell em execução SMAT.exe inicia o aplicativo para executar o trabalho. Depois que o aplicativo de trabalho é carregado, o programa SMAT.exe carregador é encerrado e retorna o controle para o operador. A ferramenta que executa o trabalho é executada em sua própria janela até que ela seja concluída.

Arquivos de log

Você pode ver até três arquivos de log no diretório de saída:

  • SMAT.log - Este arquivo contém todos os logs da execução da ferramenta. Isso contém três níveis de registro em log: informações, avisos e erros. As informações ajudam a rastrear o progresso e a solução de problemas. Normalmente, avisos são condições de erro esperadas. Erros são condições inesperadas que nossa ferramenta não pôde determinar se eles serão um bloqueador para avançar. Elas precisam ser revisadas.

  • SMAT_Errors.log - Isso contém apenas os eventos Error. Se esse arquivo estiver ausente após a conclusão das ferramentas, ele indicará que nenhum erro foi encontrado.

  • SMATTelemetry.log – isso contém log para a ferramenta de carregamento de telemetria. Quaisquer problemas aqui não afetam a geração de seus relatórios.

Automatizando a avaliação

Se você precisar agendar o processo de avaliação, poderá fazê-lo executando o arquivo .exe específico. Por exemplo, se você quiser configurar uma tarefa agendada em um farm do SharePoint 2010 para avaliação, apontará a tarefa agendada para SMAT2010.exe. Se você quiser escrever um script do PowerShell que executou a avaliação no SharePoint 2013, você apontará o script para SMAT2013.exe.

Qualquer cenário de script deve usar a opção -q para executar o arquivo .exe no modo silencioso. Esse modo não fornece nenhuma saída para o console e evita qualquer coisa que solicitaria entrada ao operador.

Mais informações

Para baixar 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