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

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

• Pré-requisitos e configurações
• Mensagens de erro do agente
• Problemas de URL do site de destino
• Mensagens de erro comuns
• Falha na instalação do agente
• Agente desconectado
• Tarefa travada no estado "Em fila"
• O relatório de tarefa não pode ser baixado
• Erros de migração em relatórios de tarefas
• Os relatórios de erro de migração do Google contêm HTML
• Códigos de erro
• Os administradores de localização geográfica não conseguem acessar a funcionalidade completa do Gerenciador de Migração
• Os administradores do Microsoft Office SharePoint Online herdados do grupo não podem acessar a funcionalidade completa do Gerenciador de Migração
• Não é possível criar ou atualizar a coleção de sites "XXXX"
• Tarefa de análise bloqueada no estado "em fila"

Verificar pré-requisitos e configurações

Certifique-se de ter atendido aos pré-requisitos para instalação do agente e revisado os pontos de extremidade necessários. Os clientes de nuvem do governo devem confirmar que definiram suas configurações corretamente.

• Pré-requisitos de instalação do agente

• Pontos de extremidade necessários

• Configurações de nuvem governamental

• Pré-aprovisionar contas do OneDrive Se estiver a migrar para contas do OneDrive, certifique-se de que as contas estão pré-aprovisionadas antes de migrar. Você pode fazer isso usando um script, conforme mostrado aqui: Pré-provisionar o OneDrive para usuários em sua organização.

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. Confira Falha de instalação do agente abaixo para saber mais.
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. Confirme se a conta do Windows associada ao agente tem permissões de leitura para o compartilhamento de arquivo que queira 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 se a conta do Windows associada ao agente tem permissões de leitura para o compartilhamento de arquivo que queira 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 OneDrive, certifique-se de que ela foi 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 que o caminho que introduziu está correto e siga o formato adequado Confirmar que tem acesso de leitura à pasta.
Não é possível criar ou atualizar o site	Confirme 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 continuar a falhar, crie o site manualmente e aponte a ferramenta de migração para este site recém-criado.
Falha no arquivo de verificação: O nome da pasta é inválido	Confira Nomes e tipos de arquivos inválidos no OneDrive e SharePoint
Falha no arquivo de verificação: O caminho de destino é muito longo	Consulte Nomes de ficheiro e tipos de ficheiro inválidos no OneDrive e no SharePoint O caminho completo, incluindo o nome do ficheiro, tem de conter menos de 400 carateres para o OneDrive e o 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 à origem existente. 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(s) linha(s) duplicada(s) 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.

Diagnóstico / Investigação:

O problema pode ser causado por um arquivo clientsetup.exe desatualizado.

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 MV em que você deseja 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:

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 resolver, o problema pode ser causado por uma falha temporária da rede 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 foi adicionada ao domínio. Feche a janela do aplicativo e tente instalar novamente.

Agente desconectado

Problema: o"estado" do agente fica travado como "Desconectado" e nunca mais volta.

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 foi alterada, ou qualquer outra alteração crítica semelhante aplicada à conta de Administrador de Locatários que exigiria um novo login, todos os agentes serão desconectados e a reinstalação será necessária em todos eles.
• Se o agente falhou ao 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 do Administrador Locatário que exijam que você entre novamente: reinstale o agente em todos os computadores.
• Se nenhuma destas condiçõ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.

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 poderá ser atribuído a mais tarefas sem terminar a 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 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 o 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.
• O link Baixar relatório de tarefa é exibido ativo, mas nada acontece depois de clicar nele

Diagnóstico / Investigação:

• O link, "Baixar relatório de tarefa", fica desabilitado até que a tarefa seja concluída. Os relatórios só ficam disponíveis depois que o status da tarefa se torna "Concluído" ou "Falha". As tarefas que falharam devido ao tempo limite também terão um link de relatório de tarefa desabilitado.
• Se nenhum relatório puder ser baixado para tarefas concluídas e sem tempo limite, é mais provável que ocorram erros durante o processo de migração que interromperam o upload dos relatórios para o Microsoft Office SharePoint Online. 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, estarão na pasta "Relatório" nesta subpasta.

Ou

• Se a tarefa falhou, navegue até a pasta %AppData%\Microsoft\SPMigration\Logs e, em seguida, classifique as subpastas pelo horário de suas modificações. 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.

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, veja Não é Possível Transferir o 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

Verifique as configurações em 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

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

Problema: Os relatórios de erro gerados para uma migração do Google às vezes terão o código HTML incorporado no relatório.

Detalhes:

As APIs do Google estão retornando erros HTML que estão sendo incluídos nos relatórios gerados. Isto pode acontecer quando existe um erro de carregamento do servidor Google.

Atenuação:

Execute menos transações simultâneas.

Status:

Este é um 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 compartilhamento de arquivos, esses usuários não conseguem acessar a guia de verificações. Para migrações na nuvem, esses usuários não conseguem acessar nem as verificações, nem a guia de migrações.

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

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 Microsoft Office SharePoint Online não conseguem acessar as guias de verificações e migrações

As funções de administrador do SharePoint que foram criadas como resultado da associação a um grupo do Azure não são totalmente suportadas pelo Gestor de Migração. Para migrações de compartilhamento de arquivos, esses usuários não conseguem acessar a guia de verificações. Para migrações na nuvem, esses usuários não conseguem acessar nem as verificações, nem a guia de migrações.

Solução alternativa. Até que isso seja resolvido, atribua ao usuário uma função de administrador ou administrador global do Microsoft Office SharePoint Online.

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, o ID do Microsoft Entra tem de conter o UPN referenciado. Verifique o URL de destino e confirme se o utilizador existe no ID do Microsoft Entra.

Tarefa de análise bloqueada no estado "em fila"

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

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.

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 que tenham ficado bloqueadas devem agora sair deste estado.

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 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 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 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 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	Desabilite o histórico de versão de migração nas configurações do Gerenciador de Migração ou habilite a versão em SPO.
0x0201000E	Verifique se a configuração global filtrou caracteres especiais no caminho de destino ou se o caminho tem caracteres sem suporte.
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 for uma conta do OneDrive, certifique-se de que ela foi pré-provisionada antes de migrar.
0x0207001	Você não tem acesso à pasta da tarefa. 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 foram incluídas no escopo da migração.
0x01510001	Falha no carregamento de pacotes. Se você tiver personalizado o armazenamento do Azure, verifique se você pode acessar o armazenamento do Azure e 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 do Servidor processando o arquivo: falha na migração de alguns dos itens no pacote.
0x01610001	O contêiner do Azure expirou. Repetir tarefa de migração.
0x01710006	Erros ou tempo limite do servidor processando o arquivo: Job Fatal Error.
0x01710004	Erros ou tempo limite do servidor processando 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.