Erros do SPMT e do Migration Manager: checklist de endpoints, espaço em disco e verificação
By Mirko Peters ·
O SPMT informa falta de espaço em disco, ou o agente do Migration Manager diz "Connected" mas não consegue fazer a verificação? Confira os endpoints necessários, a pasta de trabalho local, o armazenamento de destino e as configurações do agente, nessa ordem.
Automatically translated with AI from the original post. Read the English original
Uma migração de compartilhamento de arquivos ou do SharePoint local costuma correr bem por semanas. Então, uma biblioteca falha com uma mensagem de espaço em disco, um firewall recusa um endpoint, ou o agente do Migration Manager fica "Connected" e se recusa a fazer a verificação. Quatro tópicos da comunidade da Microsoft, de fins de 2025 até o fim de 2026, mostram esses casos. Apenas um deles tem uma resposta marcada como solução, por isso este artigo combina os tópicos com as páginas atuais do Learn. É um guia de solução de problemas, não um procedimento oficial da Microsoft.
Pontos-chave
- Libere a lista completa de endpoints do Microsoft Learn, incluindo o api.office.com para o SPMT e os endpoints de verificação do Migration Manager. Um tópico recomenda fazer isso pelo nome do host, e não pelo endereço IP.
- Um firewall que rejeita uma entrada com https:// pode precisar apenas do nome do host em um objeto FQDN, conforme relatado em um tópico que marcou isso como solução.
- Os erros de espaço em disco do SPMT documentados pelo Learn apontam para a pasta de trabalho local. Por isso, verifique primeiro o espaço livre no computador de migração e depois o armazenamento do site de destino.
- "Cannot scan" com o agente conectado não teve uma correção confirmada nos tópicos. Um autor de pergunta tinha um chamado de suporte que a Microsoft tratou como problema conhecido.
- Tenha em mãos o relatório de falha, o código de erro exato e o horário (UTC), porque a maioria dos tópicos terminou com "abra um chamado de suporte".
Como os sintomas se apresentam
- Endpoint: o firewall de um computador com SPMT rejeita
https://api.office.comcomo entrada inválida. O autor tinha lido que a API foi descontinuada, mas a página de pré-requisitos do SPMT ainda a lista (agosto de 2026). - Espaço em disco: uma migração do SharePoint 2019 para o SharePoint Online falha em duas bibliotecas com "There isn't enough disk space in the target site collection" e "Not all the items in the package have been migrated". O autor afirma que o destino tem bastante espaço (agosto de 2026).
- Cannot scan: um agente do Migration Manager mostra "Connected", mas "Cannot scan". As migrações funcionavam até meados de setembro. Reinstalar o agente não resolveu, e o autor viu falhas em requisições SSL para os endpoints de migração da Microsoft (outubro de 2026).
- Login com certificado: após reinstalar o agente com autenticação baseada em certificado, o Add Source Path na aba de verificação fica desabilitado, e o log do agente repete
token_not_found(novembro de 2025).
Passo 1: verifique os endpoints
O Learn lista os endpoints das duas ferramentas como URLs HTTPS. No caso do Migration Manager, ele diz que o agente envia solicitações para esses endpoints e recebe respostas, que os endpoints nunca podem chamar o Migration Manager e que o agente não abre uma porta para conexões remotas.
Para o SPMT, a página de pré-requisitos do Learn lista, entre outros:
- Autenticação:
login.microsoftonline.com,login.windows.net,aadcdn.msftauth.net,aadcdn.msauth.net,secure.aadcdn.microsoftonline-p.com - APIs de movimentação e validação de conteúdo:
api.office.comegraph.windows.net - Filas e armazenamento do Azure para migração:
.queue.core.windows.nete.blob.core.windows.net - Destino:
*.sharepoint.com - Graph para informações de locatário e de sites:
graph.microsoft.com
Para o Migration Manager, a página de pré-requisitos do Learn acrescenta endpoints relacionados à verificação, por exemplo api.mmp.svc.cloud.microsoft, odyssey.mmp.svc.cloud.microsoft, odyssey.prod.migrations.microsoft.com e vários hosts do SignalR. api.prod.migrations.microsoft.com aparece ali como requisito para a interface web do Migration Manager. Sempre copie a lista atual da página, porque ela muda. A introdução da página também cita production.odyssey.ops.mover.io para conexões SignalR, e esse host não está na tabela dela, então leia o texto ao redor da tabela.
A resposta marcada como solução no tópico sobre api.office.com traz esta orientação:
- Não trate a rejeição do firewall como prova de que o endpoint é desnecessário.
- Libere o nome do host na porta TCP 443 a partir do computador de migração e use regras baseadas em DNS, não em endereços IP. Esta é a orientação do tópico. O Learn não menciona porta.
- Se o campo do firewall rejeitar a entrada, informe apenas o nome do host em um objeto FQDN. O prefixo
https://pode ser o que o campo não aceita. Esta parte é uma orientação do tópico, não do Learn. - Teste a resolução de nomes e uma conexão TLS de saída a partir do computador de migração e, em seguida, execute a verificação novamente.
Um teste rápido a partir do computador de migração:
``powershell Test-NetConnection api.office.com -Port 443 Test-NetConnection odyssey.prod.migrations.microsoft.com -Port 443 ``
Um curinga como *.blob.core.windows.net não pode ser testado como está escrito. Teste um nome de host real do seu locatário. Uma resposta no tópico "Cannot scan" também pede que você descarte proxy, firewall, inspeção SSL ou alterações de certificado entre o agente e esses hosts. Não vi inspeção SSL mencionada nas duas páginas de pré-requisitos, então trate esse ponto como uma sugestão da comunidade.
Etapa 2: verifique o espaço livre no computador de migração
Para o SPMT, a página de solução de problemas do Learn documenta estes erros:
- "Scan File Failure: Not enough disk space to pack the file": o espaço em disco da pasta de trabalho da migração é pequeno demais para o tamanho do arquivo de origem. Aumente a pasta de trabalho e tente novamente.
- Erro 0x02040012: o armazenamento temporário no computador local está baixo, porque o SPMT armazena em cache o pacote na pasta de trabalho. Expanda o armazenamento temporário e tente novamente.
O Learn recomenda 150 GB de armazenamento local livre para o computador que executa o SPMT, tanto no perfil de hardware recomendado quanto no mínimo. Verifique a unidade do sistema e a unidade da sua pasta de trabalho. A pasta de trabalho %appdata%\Microsoft\MigrationToolStorage é mencionada na página de solução de problemas, e vários erros ali indicam que seus arquivos e pastas devem permanecer fechados durante a migração.
No tópico do SharePoint 2019, uma resposta de um membro da comunidade com título de MVP afirmou que a mensagem aponta, muito provavelmente, para o armazenamento temporário local, e não para limites do SharePoint Online. A página do Learn lista os erros locais acima e não lista a formulação exata "target site collection". Por isso, a verificação local é o primeiro passo mais bem respaldado.
Etapa 3: verifique o armazenamento do site de destino e do locatário
Outra resposta na mesma discussão dizia que a segunda mensagem, "Nem todos os itens do pacote foram migrados", provavelmente é um efeito colateral do primeiro erro. A sugestão era verificar o limite de armazenamento do site de destino (no centro de administração do SharePoint, em Sites ativos), o armazenamento total do locatário e o conteúdo das versões antigas e da lixeira. Essa resposta e a outra não foram marcadas como solução, e quem postou não informou nenhum resultado.
Se o destino estiver cheio, lembre-se do que a Learn diz sobre armazenamento: os relatórios de uso podem atrasar em até 48 horas e, no modo de armazenamento Manual, cada site tem seu próprio limite.
Sobre a parte "not all items migrated", a página de solução de problemas da Learn lista o erro 0x01710009 duas vezes: uma com o texto "Errors or time-out for Server Processing the file: Not all the items in the package are migrated" e outra como falha por falhas no fim do job, em que alguns itens do pacote falharam, com a recomendação de reiniciar a migração. Para dependências ausentes em itens de lista (erro 0x01410010), verifique o FailureSummaryReport.csv e certifique-se de que as dependências estão no escopo da migração. A thread também sugere tentar novamente uma biblioteca com falha em lotes menores e, depois, executar uma migração incremental para capturar os itens ausentes. Isso é uma sugestão da comunidade, não um passo da Learn.
Etapa 4: verifique o agente do Migration Manager
A página de solução de problemas do Migration Manager da Learn cobre alguns casos de agente que não são "Cannot scan", mas se parecem com eles:
- Agente desconectado: as possíveis causas incluem a integridade da rede no computador do agente, a troca de senha ou outra alteração crítica semelhante na conta de administrador do locatário (nesse caso, todos os agentes precisam ser reinstalados), uma atualização automática que falhou e a expiração de tokens.
- A verificação permanece em Queued: somente agentes no grupo de agentes Default podem ser agendados. Se nenhum agente estiver nesse grupo, altere o grupo do agente para Default.
- Falha ao enviar um job (0x01610002): a página recomenda exceções no antivírus para
microsoft.sharepoint.migration.clientservice.exeemicrosoft.sharepoint.migration.mthost.exe.
Na thread "Cannot scan", uma resposta listou os passos de configuração do agente da Microsoft e perguntou se todos os compartilhamentos ou apenas alguns são afetados. Uma resposta gerada automaticamente na mesma thread sugeriu editar um arquivo de configuração do agente. Respostas desse tipo não são evidência, e não encontrei nada parecido nas páginas da Learn; portanto, não aplique essa alteração sem uma orientação da Microsoft. O autor da pergunta escreveu que um engenheiro de suporte informou que se trata de um problema conhecido em correção. Membros da equipe da Microsoft não confirmaram isso na thread. Se seus sintomas forem semelhantes, procure o suporte logo no início.
Etapa 5: entrada com certificado para o agente
A thread sobre certificado não tem uma correção confirmada. Um moderador da equipe da Microsoft apontou um arquivo de configuração de certificado ausente ou incompleto como causa de token_not_found e pediu para verificar as permissões do aplicativo. O autor respondeu que o arquivo havia sido verificado e que o agente fora reinstalado várias vezes. Em seguida, o moderador sugeriu verificações de endpoint e a concessão de permissão de Leitura ao aplicativo no site de administração; o autor relatou que os testes de endpoint passaram e o problema continuou. O último comentário do moderador sugeriu o Microsoft Service Hub caso o problema persista. Nenhuma resposta confirma uma correção. Não consegui confirmar o formato do arquivo nem as permissões nas páginas da Learn que li; por isso, use a página oficial de configuração do Migration Manager para autenticação por certificado e não se baseie na thread.
Etapa 6: colete evidências
A Learn indica estes locais de log do Migration Manager: %AppData%\Microsoft\SPMigration\Logs para tarefas com falha, e a pasta Migration\MigrationTool[tenant_site] dentro de %AppData%\Microsoft\SPMigration\Logs para o relatório de uma tarefa concluída (ou dentro da sua pasta de trabalho personalizada). Ordene as subpastas pela data de modificação e abra a mais próxima do início da tarefa. A página do SPMT não lista as próprias pastas de log, então abra o relatório da tarefa com falha na ferramenta (como sugere uma resposta). Anote o primeiro item com falha, o código de erro, o ID de correlação e o horário em UTC, e acrescente a URL do site de destino.
Limites e pontos em aberto
- Somente a questão do endpoint tem uma solução marcada, e mesmo nela o autor não escreveu nenhuma confirmação.
- As threads sobre falta de espaço em disco, "Cannot scan" e certificado seguem sem solução. Trate os passos delas como uma lista de verificação para restringir o problema.
- A página de pré-requisitos do Migration Manager mostra uma data de atualização visível de julho de 2025. Compare-a com o que o portal solicita hoje.
Relacionados
Fontes
- Microsoft Learn: pré-requisitos do SPMT e endpoints necessários
- Microsoft Learn: solução de problemas comuns do SPMT
- Microsoft Learn: pré-requisitos e endpoints do Migration Manager
- Microsoft Learn: solução de problemas em migrações de arquivos com o Migration Manager
- Microsoft Community Hub: problema com o SharePoint Migration Tool (agosto de 2026)
- Microsoft Community Hub: ajuda com erro do SPMT (agosto de 2026)
- Microsoft Q&A: Microsoft 365 Migration - Cannot Scan (outubro de 2026)
- Microsoft Q&A: Migration Manager (Certificate Authentication) Add Source Path greyed out (novembro de 2025)