Solucionar problemas de migrações de arquivos do Gerenciador de Migração

Este artigo descreve como resolver problemas e erros que você pode enfrentar ao usar o Gerenciador de Migração para migração de compartilhamento de arquivos.

Verificar pré-requisitos e configurações

Verifique se você atende aos pré-requisitos para a instalação do agente e examine os pontos de extremidade necessários. Os clientes de nuvem do governo devem confirmar se a configuração foi definida corretamente.

Mensagens de erro do agente

Mensagem Ação
O agente de migração não pôde ser instalado. Feche a configuração e tente novamente. Você pode estar usando uma versão desatualizada do arquivo de configuração do agente para instalar o agente. Para obter mais informações, consulte a seção Falha na instalação do agente .
O usuário atual não tem acesso ao compartilhamento do arquivo de origem Certifique-se de que o compartilhamento de arquivo de origem seja um compartilhamento de arquivo de rede. Verifique se a conta do Windows associada ao agente tem permissões de leitura para o compartilhamento de arquivos que você deseja migrar.
O compartilhamento do arquivo de origem não existe Certifique-se de que o compartilhamento de arquivo de origem seja um compartilhamento de arquivo de rede existente. Confirme se a conta do Windows associada ao agente tem permissões de leitura para o compartilhamento de arquivos que você deseja migrar.

Problemas de URL do site de destino

Mensagem Ação recomendada
O site ou Web de destino não existe Confirme se o site ou subsite de destino existe. Se for uma conta do OneDrive, verifique se ela está pré-provisionada.
Falha ao verificar a existência do site ou da Web. Confirme se o site ou subsite de destino existe.

Mensagens de erro frequentes

Mensagem Ação recomendada
Pasta de origem inválida Confirme se o caminho inserido está correto e segue o formato adequado.
Verifique se você tem acesso de leitura à pasta.
O site não pode ser criado ou atualizado Verifique se você tem permissões para criar o site e se a URL é válida.
Se o site existir, confirme que você é o administrador do conjunto de sites.
Se ainda assim falhar, crie o site manualmente e aponte a ferramenta de migração para esse site recém-criado.
Falha no arquivo de verificação: O nome da pasta é inválido Confira Nomes e tipos de arquivo inválidos no OneDrive e no SharePoint.
Falha no arquivo de verificação: O caminho de destino é muito longo Confira Nomes e tipos de arquivo inválidos no OneDrive e no SharePoint.
O caminho completo, incluindo o nome do arquivo, deve conter menos de 400 caracteres no OneDrive e no SharePoint.
Falha ao verificar o arquivo: não há espaço em disco suficiente para compactar o arquivo O espaço em disco disponível para a pasta de trabalho de migração é muito pequeno para o tamanho do arquivo de origem. Aumente o tamanho da pasta de trabalho e tente novamente.
Falha de empacotamento: Não é possível abrir o arquivo O empacotamento falhou devido a uma fonte inexistente. Verifique se você pode acessar a pasta raiz de origem.
Uma tarefa duplicada já foi criada. O arquivo CSV usado para fazer a migração em massa não pode ter entradas duplicadas. Remova a(s) linha(s) duplicada(s) e tente novamente.
A pasta pai não foi migrada A pasta pai não foi migrada, portanto, todos os itens dentro da pasta não serão migrados. Verifique a pasta pai e faça a migração novamente.

Falha na instalação do agente

Problema: A instalação do agente de migração falha ao usar uma versão antiga do arquivo de configuração do agente para instalar o agente.

Falha na instalação do agente de tela

Diagnóstico / Investigação:

Um arquivo clientsetup.exe desatualizado pode causar esse problema.

Atenuação:

  1. Vá para o Centro de migração do novo Centro de administração do SharePoint e entre com uma conta que tenha permissões de administrador da sua organização.
  2. Selecione Baixar arquivo de configuração do agente.
  3. Execute o arquivo clientsetup.exe no computador ou máquina virtual na qual você deseja instalar o agente. Siga as instruções para concluir a instalação do agente.

questão O agente de migração não é instalado com êxito ou o clientsetup.exe não pode ser aberto.

Exemplo:

Captura de tela de falha na instalação do agente do Gerenciador de Migração.

Diagnóstico / Investigação:

Se a clientsetup.exe não puder ser aberta:

  • Faça login no Windows como Administrador ou forneça o nome de usuário e a senha do Administrador ao abrir o aplicativo. A Conta do administrador já deve ser adicionada ao domínio.

Se ocorrerem erros durante o processo de instalação:

  • A mensagem de erro já deve incluir o motivo da falha e as ações apropriadas a serem tomadas, se possível.
  • Se os erros não sugerirem ações a serem resolvidas, uma falha temporária na rede poderá causar esse problema ou outros problemas desconhecidos.

Atenuação:

Se a clientsetup.exe não puder ser aberta:

  1. Entre no Windows como Administrador.
  2. Abra novamente o aplicativo clientsetup.exe ou forneça o nome de usuário e senha do Administrador ao abrir o aplicativo.

Se ocorrerem erros durante o processo de instalação:

  • Para erros com ações específicas declaradas, execute a ação correspondente e reabra o clientsetup.exe.
  • Para outros erros não específicos, verifique se sua conta de administrador foi adicionada ao domínio. Feche a janela do aplicativo e tente instalar novamente.

Agente desconectado

Problema: o estado do agente exibe "Desconectado" e nunca muda.

Agente desconectado

Diagnóstico / Investigação:

  • Verifique a integridade da rede no computador em que o agente está instalado.
  • Se a senha da conta de Administrador de Locatários conectada for alterada ou qualquer outra alteração crítica semelhante for aplicada à conta de Administração de Locatários que exigiria que você entrasse novamente, todos os agentes serão desconectados. A reinstalação é necessária em todos eles.
  • Se o agente não conseguiu atualizar automaticamente, a versão provavelmente é muito antiga. Reinstalar o aplicativo.
  • A expiração do token também pode fazer com que o agente se desconecte.

Atenuação:

  • Se houver um problema de rede, corrija-o. O agente deve se reconectar logo em seguida.
  • Se houver alterações críticas na conta de Administração do Locatário que exijam que você entre novamente: Reinstale o agente em todos os computadores.
  • Se nenhuma dessas opções se aplicar, comece reinstalando o agente primeiro.

Tarefa travada no status "Na fila"

Problema: O status de uma tarefa permanece em "Na fila" e nunca é programado para ser executado por um agente.

Tarefa presa no status Enfileirado.

Diagnóstico / Investigação:

  • Certifique-se de que haja agentes instalados para este locatário. Eles devem ser listados na Lista de agentes.
  • Verifique o estado de cada agente. Eles devem ser definidos como "Habilitados".
  • Um status de "Em uso" indica que o agente já está processando outra tarefa. O agente não pode receber mais tarefas sem concluir a tarefa atual.
  • Se um agente estiver listado como "Desabilitado", habilite-o.
  • Se eles parecerem "Desconectados" por um longo tempo, marque Agente Desconectado.

Atenuação:

  • Se houver agentes disponíveis e habilitados na lista, mas as tarefas não estiverem agendadas por um longo tempo: Crie outra tarefa que seja a mesma. Às vezes, isso corrige o problema.

Não é possível baixar um Relatório de Tarefas

Problema: o relatório da tarefa não pode ser baixado do link no painel de detalhes da tarefa.

  • O link Baixar relatório de tarefa está desabilitado.
  • O link Baixar relatório de tarefas exibe ativo, mas nada acontece depois de clicar nele.

Captura de tela do relatório de tarefas não pode ser baixado.

Diagnóstico / Investigação:

  • O link, "Baixar relatório de tarefa", fica desabilitado até que a tarefa seja concluída. Os relatórios só estarão disponíveis depois que o status da tarefa tiver um status "Concluído" ou "Com falha". As tarefas que falharam devido ao tempo limite também têm um link de relatório de tarefas desabilitado.
  • Se nenhum relatório puder ser baixado para tarefas concluídas e sem tempo limite, provavelmente ocorreram erros durante o processo de migração que interromperam o upload dos relatórios para o SharePoint. No entanto, eles podem ser encontrados localmente, desde que existam.

Mitigação:

No computador que concluiu a tarefa, tente recuperar os relatórios.

  • Na pasta %AppData%\Microsoft\SPMigration\Logs\Migration\MigrationTool[tenant_site], ou < Your-Customized-Working-Folder >\Migration\MigrationTool[tenant_site], classifique as subpastas pelo tempo de modificação. Localize a subpasta cuja hora de modificação é a mais próxima da hora de início da tarefa. Se os relatórios de tarefas existirem, eles estarão na pasta "Relatório" dentro desta subpasta.

Ou

  • Se a tarefa falhar, navegue até a pasta %AppData%\Microsoft\SPMigration\Logs e classifique as subpastas pelo tempo de modificação. Localize a subpasta cuja hora de modificação é a mais próxima da hora de início da tarefa. O relatório de erro está nessa subpasta.

Erros de migração em relatórios de tarefas

Problema: As tarefas de migração falham devido a vários motivos e são detalhadas nos relatórios de tarefas.

Erro do gerenciador de migração

Diagnóstico / Investigação:

Mitigação:

Localize o erro específico aqui para obter mais informações: Códigos de erro.

Se você receber um erro semelhante a este: FALHA DE ENVIO Falha ao enviar o trabalho ao servidor: motivo desconhecido da falha ao enviar um trabalho. 0x01610002, marcar as configurações de qualquer aplicativo antivírus instalado na máquina do agente. Adicione nossos dois aplicativos de migração como exceções para que o tráfego de migração não seja interrompido:

  • microsoft.sharepoint.migration.clientservice.exe
  • microsoft.sharepoint.migration.mthost.exe

Administradores de localização geográfica não são suportados

O Gerenciador de Migração atualmente não dá suporte à função de administrador de localização geográfica para cenários específicos. Para migrações de compartilhamento de arquivos, esses usuários não podem acessar a guia Verificações . Para migrações na nuvem, esses usuários não podem acessar a guia Verificações ou a guia Migrações .

Solução alternativa. Atribua ao usuário Geo uma função de administrador ou global no Microsoft Office SharePoint Online.

Importante

A Microsoft recomenda que você use funções com o menor número de permissões, ajudando a melhorar a segurança da sua organização. O Administrador Global é uma função altamente privilegiada que deve ser limitada a cenários de emergência quando não for possível usar uma função existente.

  1. No centro de administração, vá para a página Usuários>Usuários ativos.
  2. Na página Usuários ativos, escolha o usuário cuja função de administrador você pretende alterar. No painel do submenu, em Funções, selecione Gerenciar funções.
  3. Selecione a função de administrador que deseja atribuir ao usuário. Se você não vir a função que está procurando, selecione Mostrar tudo na parte inferior da lista.

Os administradores do SharePoint herdados do grupo não conseguem acessar as guias Verificações e Migrações

O Gerenciador de Migração não oferece suporte total às funções de administrador do SharePoint criadas como resultado do ingresso em um grupo do Azure. Para migrações de compartilhamento de arquivos, esses usuários não podem acessar a guia Verificações . Para migrações na nuvem, esses usuários não podem acessar a guia Verificações ou a guia Migrações .

Solução alternativa. Atribua ao usuário uma função de administrador do SharePoint ou de administrador global.

Importante

A Microsoft recomenda que você use funções com o menor número de permissões, ajudando a melhorar a segurança da sua organização. O Administrador Global é uma função altamente privilegiada que deve ser limitada a cenários de emergência quando não for possível usar uma função existente.

  1. No centro de administração, vá para a página Usuários>Usuários ativos.
  2. Na página Usuários ativos, escolha o usuário cuja função de administrador você pretende alterar. No painel do submenu, em Funções, selecione Gerenciar funções.
  3. Selecione a função de administrador que deseja atribuir ao usuário. Se você não vir a função que está procurando, selecione Mostrar tudo na parte inferior da lista.

O conjunto de sites "XXXX" não pode ser criado ou atualizado

O nome UPN referenciado é inválido. Para criar ou atualizar um conjunto de sites do OneDrive, o Microsoft Entra ID deve conter o UPN referenciado. Verifique a URL de destino e valide se o usuário existe no Microsoft Entra ID.

Tarefa de digitalização presa no status "queued"

Problema: o status de uma verificação de compartilhamento de arquivos permanece em "Na fila" e nunca é agendado para a execução de um agente.

Problema com a tarefa de verificação travada na fase de fila.

Diagnóstico/Investigação

  • Verifique a coluna Grupo de agentes para tarefas de verificação. Somente agentes no grupo de agentes Padrão podem ser agendados.

Solução de problemas de tarefa de verificação.

Mitigação

  • Se não houver agentes no grupo de agentes Padrão , altere o grupo do agente existente para Padrão. Todas as tarefas de verificação que estavam paralisadas agora devem sair desse estado.

Problema na tarefa de verificação, editar agentes.

Códigos de erro

Código do erro Ação recomendada
0x00000000 Erro inesperado.
0x01110001 Motivo desconhecido.
0x0111000B O caminho é muito longo.
0x0111000F A pasta pai não foi migrada. Verifique o relatório de falha para determinar o arquivo e tente novamente.
0x01110003 Não é possível acessar a pasta de origem.
0x01110009 Não foi possível recuperar os metadados do arquivo.
0x01110010 Caracteres inválidos no nome do arquivo. Verifique o relatório para nomes de arquivos com <>:"?*/,
0x01110011 Não há suporte para o item "hora de criação" ou "hora de modificação".
0x0201000D Verifique se a lista existe ou se você consegue acessá-la nos sites de origem e de destino.
0x02050008 Não é possível acessar o armazenamento local. Reinicie a migração.
0x02010023 Não há suporte para seu modelo de lista de fontes. Experimente outro.
0x0201000C Verifique suas credenciais e reinsira seu nome de usuário e senha.
0x02010017 Você deve ser administrador de um conjunto de sites.
0x02060009 1 - O conjunto de sites não pode ser criado porque a URL já está em uso ou é uma URL inválida.
2 - O conjunto de sites não pode ser criado porque a URL contém caracteres inválidos.
3 - O conjunto de sites não pode ser criado ou atualizado.
0x02060007 1 - O conjunto de sites não pode ser criado porque a URL já está em uso ou é uma URL inválida.
2 - O conjunto de sites não pode ser criado porque a URL contém caracteres inválidos.
0x02010018 1. Verifique as suas credenciais e tente novamente.
2. Ocorreu um problema ao acessar o SharePoint. Verifique as suas credenciais e tente novamente.
3. Ocorreu um problema ao acessar o SharePoint. Verifique as suas credenciais e a conexão à rede e tente novamente.
4. Ocorreu um problema ao acessar o SharePoint. Verifique as suas credenciais e a exatidão da URL do site e tente novamente.
5. Ocorreu um problema ao acessar o SharePoint. Verifique as suas credenciais e o formato da URL. Tente novamente.
6. Ocorreu um problema ao acessar o SharePoint. Verifique as suas credenciais e tente novamente. Se o problema persistir, crie um caso de suporte.
7. Ocorreu um problema ao acessar o SharePoint. Verifique as suas credenciais e tente abrir o site em um navegador.
0x0204000A Não é possível criar o arquivo do pacote. Todos os arquivos e pastas na pasta de trabalho do Gerenciador de Migração, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage, devem ser fechados. Reinicie a migração.
0x02030001 1. Verifique as suas credenciais. Reinicie a migração.
2. Verifique as suas credenciais. Reinicie a migração.
3. Verifique as suas credenciais e a conexão à rede. Reinicie a migração.
4. Verifique as suas credenciais e a URL do site. Reinicie a migração.
5. Verifique as suas credenciais e o formato da URL. Reinicie a migração.
6. Verifique as suas credenciais e reinicie a migração. Se o problema persistir, crie um caso de suporte.
7. Verifique as suas credenciais e tente abrir o site em um navegador. Reinicie a migração.
0x02010008 Confirme o caminho e o formato do arquivo de mapeamento de usuário e se você tem permissão para acessá-los.
0x02050001 Todos os arquivos e pastas na pasta de trabalho do Gerenciador de Migração, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage, devem ser fechados. Reinicie a migração.
0x02010002 Verifique o status da rede. Se você conseguir acessar os sites de origem usando um navegador, então crie um caso de suporte.
0x02010010 Verifique se as listas de origem e de destino têm o mesmo modelo.
0x0204000D Todos os arquivos e pastas na pasta de trabalho do Gerenciador de Migração, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage, devem ser fechados durante a migração. Reinicie a migração.
0x02040012 O armazenamento temporário em seu computador local é muito baixo. O Gerenciador de Migração armazena em cache o pacote na pasta de trabalho. Expanda seu armazenamento temporário e tente novamente.
0x02030003 Há muitos itens com permissões exclusivas. Simplifique a lista de permissões, reduzindo o número de permissões exclusivas. Faça a migração novamente.
0x02050001 O arquivo de armazenamento local está corrompido. A pasta de trabalho foi alterada ou modificada durante a migração. Faça a migração novamente.
0x02080001 O arquivo no pacote foi alterado ou excluído durante o carregamento. Todos os arquivos e pastas na pasta de trabalho do Gerenciador de Migração, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage, devem ser fechados. Reinicie a migração.
0x02040009 Não é possível criar o pacote porque o diretório não pode ser encontrado. Todos os arquivos e pastas na pasta de trabalho do Gerenciador de Migração, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage, devem ser fechados. Reinicie a migração.
0x02010020 Desabilite a migração do histórico de versão nas configurações do Gerenciador de Migração ou habilite o controle de versão no SharePoint.
0x0201000E Verifique se a configuração global está filtrando caracteres especiais no caminho de destino ou se o caminho tem caracteres não compatíveis.
0X0201000F URL de site inválida. Verifique se a URL do site é válida. Tente acessar a URL por meio de um navegador. Se essa conta for do OneDrive, verifique se ela está pré-provisionada antes de migrar.
0x0207001 Você não tem acesso à pasta de tarefas. Verifique se você pode acessar %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage.
0x01410010 Ocorreu uma falha devido a dependências inexistentes em itens da lista. Confira o FailureSummaryReport.csv para obter detalhes. Verifique se as dependências estão incluídas no escopo de migração.
0x01510001 Falha no carregamento de pacotes. Se você tiver um armazenamento personalizado do Azure, marque se pode acessar o armazenamento do Azure e marque se pode acessar o site de destino. Tente migrar novamente.
0x01510001 Não foi possível carregar o trabalho no servidor: falha ao migrar arquivo carregado.
0x02070009 Falha no carregamento de vários pacotes. Pause a tarefa e verifique sua conexão de rede.
0x01710009 Ocorreu uma falha devido a falhas no fim do trabalho; alguns itens falharam no pacote. Reiniciar migração.
0x01710009 Erros ou tempo limite para o servidor Processando o arquivo: Nem todos os itens do pacote foram migrados.
0x01610001 O contêiner do Azure expirou. Repetir tarefa de migração.
0x01710006 Erros ou tempo limite para o servidor processar o arquivo: Erro fatal de trabalho.
0x01710004 Erros ou tempo limite para o servidor processar o arquivo. Falha ao pesquisar nome da pasta. O item pode existir em outra lista ou site no mesmo conjunto de sites. Ou então o item pode estar na Lixeira.
0x0131000F Falha ao Ler o arquivo. Check-out do arquivo concluído.
  • Last updated on