Compartilhar via

Resolver problemas de migrações de ficheiros do Migration Manager

Este artigo descreve como resolve problemas e erros que pode deparar ao utilizar o Gestor de Migração para migração de partilhas de ficheiros.

Verificar pré-requisitos e configurações

Certifique-se de que cumpre os pré-requisitos para a instalação do agente e reveja os pontos finais necessários. Os clientes da cloud governamental devem confirmar que a configuração está definida corretamente.

Mensagens de erro do agente

Mensagem Ação
Não foi possível instalar o agente de migração. 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, veja a secção Falha na instalação do agente .
O utilizador atual não tem acesso à partilha de ficheiros 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 a partilha de ficheiros que pretende migrar.
A partilha de ficheiros de origem não existe Certifique-se de que o compartilhamento de arquivo de origem seja um compartilhamento de arquivo de rede existente. Confirme que a conta do Windows associada ao agente tem permissões de Leitura para a partilha de ficheiros que pretende migrar.

Problemas de URL do site de destino

Mensagem Ação recomendada
O site de destino ou a Web não existe Confirme se o site ou subsite de destino existe. Se for uma conta do OneDrive, certifique-se de que foi pré-aprovisionada.
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 que o caminho que introduziu está correto e segue o formato adequado.
Confirme que tem acesso de Leitura à pasta.
Não é possível criar ou atualizar o site Certifique-se de que tem permissões para criar o site e que o URL é válido.
Se o site existir, confirme que é o administrador da coleção 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 Veja Nomes de ficheiro e tipos de ficheiro inválidos no OneDrive e no SharePoint.
Falha no arquivo de verificação: O caminho de destino é muito longo Veja Nomes de ficheiro e tipos de ficheiro 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 no empacotamento: não é possível abrir o ficheiro O empacotamento falhou devido a uma origem inexistente. Verifique se você pode acessar a pasta raiz de origem.
Uma tarefa duplicada já foi criada. O ficheiro CSV utilizado para fazer a migração em massa não pode ter entradas duplicadas. Remova a linha ou linhas duplicadas e tente novamente.
A pasta principal não foi migrada A pasta principal não foi migrada, pelo que todos os itens na pasta não foram 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 ficheiro declientsetup.exe desatualizado pode causar este 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 ficheiro clientsetup.exe no computador ou na máquina virtual no qual pretende instalar o agente. Siga as instruções para concluir a instalação do agente.

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

Exemplo:

Captura de ecrã da falha de instalação do agente do Gestor de Migração.

Diagnóstico / Investigação:

Se não for possível abrir oclientsetup.exe:

  • 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 para resolve, a falha temporária da rede poderá causar este problema ou outros problemas desconhecidos.

Atenuação:

Se não for possível abrir o clientsetup.exe:

  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, certifique-se de que a sua conta de Administrador é adicionada ao domínio. Feche a janela do aplicativo e tente instalar novamente.

Agente desconectado

Problema: o estado do agente apresenta "Desligado" e nunca é alterado.

Agente desconectado

Diagnóstico / Investigação:

  • Verifique a integridade da rede no computador em que o agente está instalado.
  • Se a palavra-passe da conta de Administrador Inquilino com sessão iniciada for alterada ou se forem aplicadas outras alterações críticas semelhantes à conta Administração inquilino que exigiria que inicie sessão novamente, todos os agentes serão desligados. A reinstalação é necessária em todos eles.
  • Se o agente não conseguiu atualizar automaticamente, é provável que a versão seja demasiado 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 existirem alterações críticas à conta Administração inquilino que exijam que inicie sessão novamente: Reinstale o agente em todos os computadores.
  • Se nenhuma destas opções se aplicar, comece por reinstalar 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 bloqueada no status em fila.

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. Não é possível atribuir mais tarefas ao agente sem concluir a atual.
  • Se um agente estiver listado como "Desativado", ative-o.
  • Se eles parecerem "Desconectados" por um longo tempo, marque Agente Desconectado.

Atenuação:

  • Se houver disponível, agentes habilitados na lista, mas as tarefas não foram agendadas há muito tempo: Crie outra tarefa igual. Por vezes, corrige o problema.

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

Problema: o Relatório de tarefas não pode ser transferido a partir da ligação no painel de detalhes da tarefa.

  • O link Baixar relatório de tarefa está desabilitado.
  • A ligação Transferir relatório de tarefas é apresentada como ativa, mas nada acontece depois de clicar no mesmo.

Não é possível transferir a captura de ecrã do relatório de tarefas.

Diagnóstico / Investigação:

  • O link, "Baixar relatório de tarefa", fica desabilitado até que a tarefa seja concluída. Os relatórios só estão disponíveis após a status da tarefa ter um status "Concluído" ou "Com Falhas". As tarefas que falharam devido ao tempo limite também têm uma ligação de relatório de tarefas desativada.
  • Se não for possível transferir relatórios para tarefas concluídas e sem tempo limite excedido, é provável que ocorreram erros durante o processo de migração que interromperam o carregamento 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], ordene as subpastas pela hora 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, está na pasta "Relatório" nesta subpasta.

Ou

  • Se a tarefa falhar, navegue para a pasta %AppData%\Microsoft\SPMigration\Logs e, em seguida, ordene as subpastas pela hora 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 erros está nesta 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:

  • Os motivos da falha já devem ser escritos em detalhes nos relatórios, juntamente com as soluções sugeridas.
  • Se não conseguir transferir os relatórios de tarefas, consulte Não é possível transferir um relatório de tarefas.

Mitigação:

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

Se receber um erro semelhante a este: FALHA AO SUBMETER FALHA ao Submeter a Tarefa para Servidor: Motivo de falha desconhecida ao submeter uma tarefa. 0x01610002, marcar as definições em qualquer aplicação antivírus instalada no computador do agente. Adicione as nossas duas aplicações 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

O relatório de erros do Google apresentam o código HTML no relatório

Problema: por vezes, os relatórios de erros gerados para uma migração do Google têm um código HTML incorporado no relatório.

O relatório de erros do Google inclui código HTML.

Detalhes:

As APIs do Google devolvem erros HTML incluídos nos relatórios gerados. Este problema pode ocorrer quando existe um erro de carregamento do servidor Google.

Atenuação:

Execute menos transações simultâneas.

Status:

Este problema é conhecido. O ETA não está definido.

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 partilha de ficheiros, estes utilizadores não podem aceder ao separador Análises . Para migrações para a cloud, estes utilizadores não podem aceder ao separador Análises ou ao separador 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 utilize funções com menos 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 herdados do SharePoint herdados não conseguem aceder aos separadores Análises e Migrações

O Gestor de Migração não suporta totalmente as funções de administrador do SharePoint criadas como resultado da associação a um grupo do Azure. Para migrações de partilha de ficheiros, estes utilizadores não podem aceder ao separador Análises . Para migrações para a cloud, estes utilizadores não podem aceder ao separador Análises ou ao separador Migrações .

Solução alternativa. Atribua ao utilizador uma função de administrador do SharePoint ou Administrador global.

Importante

A Microsoft recomenda que utilize funções com menos 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.

Não é possível criar ou atualizar a coleção de sites "XXXX"

O nome UPN referenciado é inválido. Para criar ou atualizar uma coleção de sites do OneDrive, Microsoft Entra ID tem de conter o UPN referenciado. Verifique o URL de destino e confirme se o utilizador existe no Microsoft Entra ID.

Tarefa de análise bloqueada na status "em fila"

Problema: o status para uma análise de partilha de ficheiros permanece em "Em fila" e nunca é agendado para execução num agente.

Problema de tarefa de análise bloqueado na fase de colocação em fila.

Diagnóstico/Investigação

  • Verifique a coluna Grupo de agentes para obter tarefas de análise. Apenas os agentes no grupo Agente predefinido podem ser agendados.

Resolução de problemas da tarefa de análise.

Mitigação

  • Se não existirem agentes no grupo Agente predefinido , altere o grupo do agente existente para Predefinido. Todas as tarefas de análise bloqueadas devem agora sair deste estado.

Analisar agentes de edição de problemas de tarefas.

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 principal não foi migrada. Verifique o relatório de falha para determinar o arquivo e tente novamente.
0x01110003 Não é possível aceder à pasta de origem.
0x01110009 Não foi possível recuperar os metadados do arquivo.
0x01110010 Caracteres inválidos no nome do arquivo. Verificar se existem nomes de ficheiros no relatório com <>:"?*/,
0x01110011 O item "hora de criação" ou "hora de modificação" não é suportado.
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 O seu modelo de lista de origem não é suportado. 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 - Não é possível criar a coleção de sites porque o URL já está a ser utilizado ou um URL inválido.
2 - Não é possível criar a coleção de sites porque o URL contém um caráter inválido.
3 - Não é possível criar ou atualizar a coleção de sites.
0x02060007 1 - Não é possível criar a coleção de sites porque o URL já está a ser utilizado ou um URL inválido.
2 - Não é possível criar a coleção de sites porque o URL contém um caráter inválido.
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 pedido 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 ficheiro de 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 este problema continuar, crie um pedido 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 ficheiro no pacote foi alterado ou eliminado 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 não é possível localizar o diretório. 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 Desative a migração do histórico de versões nas definições do Gestor de Migração ou ative o controlo de versões no SharePoint.
0x0201000E Verifique se a definição global está a filtrar carateres especiais no caminho de destino ou se o caminho tem carateres não suportados.
0X0201000F URL de site inválida. Verifique se a URL do site é válida. Tente acessar a URL por meio de um navegador. Se esta conta for uma conta do OneDrive, certifique-se de que está pré-aprovisionada antes de migrar.
0x0207001 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 âmbito da migração.
0x01510001 Falha no carregamento de pacotes. Se tiver um armazenamento personalizado do Azure, marcar se conseguir aceder ao armazenamento do Azure e marcar se conseguir aceder ao 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 excedido para o Servidor a Processar o ficheiro: nem todos os itens no pacote foram migrados.
0x01610001 O contêiner do Azure expirou. Repetir tarefa de migração.
0x01710006 Erros ou tempo limite excedido para o servidor que processa o ficheiro: Erro Fatal da Tarefa.
0x01710004 Erros ou tempo limite excedido para o servidor que processa o ficheiro. 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.