Solucionar problemas de migrações de arquivos do Migration Manager
Este artigo descreve como resolve problemas e erros que você pode experimentar ao usar o Migration Manager para migração de compartilhamento de arquivos.
- 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
- A coleção de sites "XXXX" não pode ser criada ou atualizada
- Tarefa de verificação presa no status "enfileirado"
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é-provisionar contas do OneDrive Se você estiver migrando para contas do OneDrive, verifique se as contas estão pré-provisionadas 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 |
---|---|
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. Confira Falha de instalação do agente abaixo para saber mais. |
O usuário atual não tem acesso ao compartilhamento de arquivo 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. |
O compartilhamento de 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 arquivo que queira migrar. |
Problemas de URL do site de destino
Mensagem | Ação recomendada |
---|---|
Site de destino ou 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 se o caminho inserido está correto e siga o formatoapropriado Confirme 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 que a URL é válidaSe o site existir, confirme se você é o administradordo conjunto de sites Se ele ainda 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 arquivo e tipos de arquivo inválidos no OneDrive e no SharePoint Todo o caminho, incluindo o nome do arquivo, deve conter menos de 400 caracteres para OneDrive e 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 na embalagem: não é possível abrir o arquivo | Falha na embalagem devido à origem inexistente. Verifique se você pode acessar a pasta raiz de origem. |
Uma tarefa duplicada já foi criada. | O arquivo CSV usado para fazer 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 na pasta não migram. 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:
- 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.
- Selecione Baixar arquivo de configuração do agente.
- 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.
Questão: 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 o clientsetup.exe não puder ser aberto:
- 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 erros não sugerirem ações para resolve, o problema poderá ser causado por falha temporária de rede ou outros problemas desconhecidos.
Atenuação:
Se o clientsetup.exe não puder ser aberto:
- Entre no Windows como Administrador.
- 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 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 dessas condiçõ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.
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. Às vezes, resolve o problema.
O Relatório de Tarefas não pode ser baixado
Problema: o relatório 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 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-Personalized-Working-Folder >\Migration\MigrationTool[tenant_site], classifique as subpastas pelo tempo modificado. Localize a subpasta cuja hora de modificação é a mais próxima da hora de início da tarefa. Se os relatórios de tarefa existirem, eles estarão na pasta "Relatório" nessa 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 erro 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 você não puder baixar os relatórios de tarefas, consulte Relatório de tarefas não pode ser baixado
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 para Servidor: motivo de falha desconhecido ao enviar um trabalho. 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. Isso pode acontecer quando há um erro de carga do servidor do Google.
Atenuação:
Execute transações menos 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.
- No centro de administração, vá para a página Usuários>Usuários ativos.
- 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.
- 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 junção de um grupo do Azure não têm suporte total pelo Migration Manager. 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.
- No centro de administração, vá para a página Usuários>Usuários ativos.
- 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.
- 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.
A coleção de sites "XXXX" não pode ser criada ou atualizada
O nome UPN referenciado é inválido. Para criar ou atualizar uma coleção de sites do OneDrive, Microsoft Entra ID deve conter o UPN referenciado. Verifique sua URL de destino e valide se o usuário existe no Microsoft Entra ID.
Tarefa de verificação presa no status "enfileirado"
Problema: o status de uma verificação de compartilhamento de arquivos permanece em "Enfileirado" e nunca é agendado em um agente a ser executado.
Diagnóstico/Investigação
- Verifique a coluna Grupo de agentes para verificar tarefas de verificação. Somente agentes no grupo de agentes padrão podem ser agendados.
Mitigação
- Se não houver agentes no grupo de agentes padrão, altere o grupo do agente existente para Default. Todas as tarefas de verificação que foram presas agora devem sair desse 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 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. Verificar o relatório de nomes de arquivos com <>:"?*/, |
0x01110011 | Não há suporte para o item "tempo criado" ou "tempo modificado". |
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 o modelo de lista de origem. 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 – A coleção de sites não pode ser criada porque a URL já está em uso ou uma URL inválida. |
2 – A coleção de sites não pode ser criada porque a URL contém caractere inválido. | |
3 – A coleção de sites não pode ser criada ou atualizada. | |
0x02060007 | 1 – A coleção de sites não pode ser criada porque a URL já está em uso ou uma URL inválida. |
2 – A coleção de sites não pode ser criada porque a URL contém caractere 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 um arquivo 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 | O pacote não pode ser criado 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 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. |
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de