Ao migrar arquivos de um servidor de arquivos local para o OneDrive durante um corte de fim de semana, os usuários frequentemente relatam que links compartilhados criados antes da migração não funcionam mais. Isso acontece porque os caminhos dos arquivos mudam quando os dados são movidos de um compartilhamento de rede para um locatário na nuvem. Os links de compartilhamento originais apontam para o local do servidor antigo, e o OneDrive não consegue resolver essas referências após o corte. Este artigo explica o motivo técnico para links recentes quebrados e fornece um checklist passo a passo para administradores preservarem a integridade dos links durante a migração.
Principais Conclusões: Preservar Links de Compartilhamento Durante a Migração do Servidor de Arquivos
- Ferramenta de Migração do SharePoint (SPMT) > Preservar links de compartilhamento: Ao marcar esta configuração, o SPMT reescreve as referências dos links para o novo local do OneDrive durante a migração.
- Detecção de alteração de caminho de arquivo: O OneDrive usa um ID de arquivo único para cada item. Se você mover o arquivo sem preservar o ID, todos os links existentes serão quebrados.
- Varredura de Avaliação de Migração: Execute esta varredura antes do corte para identificar todos os arquivos compartilhados e sua contagem de links, para que você possa planejar o momento e o método da migração.
Por que a Migração do Servidor de Arquivos Quebra os Links Recentes do OneDrive
Quando os usuários compartilham um arquivo de um servidor de arquivos, o link de compartilhamento contém o caminho do servidor, como \\fileserver\shared\project\report.xlsx. O OneDrive for Business armazena um mapeamento entre esse caminho do servidor e o ID único do arquivo no banco de dados de conteúdo do SharePoint. Após a migração, o arquivo existe em um novo site do OneDrive com um novo ID de arquivo. O caminho antigo do servidor não resolve mais para nenhum arquivo válido no locatário.
Os links de compartilhamento do Microsoft 365 estão vinculados ao ID interno do arquivo, não ao seu nome de exibição ou caminho de pasta. Quando você copia ou move um arquivo para o OneDrive usando o Windows File Explorer ou um método de arrastar e soltar, o arquivo recebe um novo ID. Todos os links de compartilhamento anteriores se tornam órfãos. Apenas ferramentas de migração que preservam o ID do arquivo, como a Ferramenta de Migração do SharePoint com a opção correta ativada, podem manter os links existentes funcionais.
O termo “links recentes” refere-se à lista de arquivos acessados recentemente que aparece na interface web do OneDrive e nos aplicativos do Microsoft 365. Esses links também dependem do ID do arquivo. Após a migração, a lista de links recentes mostra entradas quebradas porque os IDs antigos não existem mais no OneDrive do usuário.
Checklist do Administrador: Preservar Links Durante o Corte de Fim de Semana
- Execute a Varredura de Avaliação de Migração
Abra o Centro de Administração do SharePoint. Vá para Migração > Avaliação. Execute uma varredura completa no compartilhamento do servidor de arquivos. O relatório lista cada arquivo compartilhado, o número de links de compartilhamento e a data do último acesso. Use esses dados para decidir quais arquivos devem manter seus links e quais podem ser recriados. - Ative a opção Preservar links de compartilhamento no SPMT
Baixe e instale a Ferramenta de Migração do SharePoint versão 3.12 ou posterior. Ao criar uma nova tarefa de migração, expanda a seção Configurações avançadas. Marque a caixa rotulada Preservar links de compartilhamento durante a migração. Essa configuração instrui o SPMT a copiar o ID do arquivo da origem para o destino. - Use a migração em massa do SPMT em vez de cópia manual
Não use cópia do Windows File Explorer, robocopy ou qualquer ferramenta de terceiros que não preserve os IDs de arquivo do SharePoint. Configure o SPMT para apontar para o caminho do servidor de arquivos de origem e a URL de destino do OneDrive. O SPMT lida com o mapeamento de ID automaticamente quando a opção de preservação está ativa. - Realize uma migração piloto em uma pasta pequena
Selecione uma pasta com no máximo 50 arquivos. Execute a migração com a opção de preservação ativada. Após a conclusão, peça ao proprietário da pasta para testar alguns links compartilhados de antes da migração. Se os links abrirem corretamente, prossiga com o corte completo. - Agende o corte durante uma janela de baixa atividade
Cortes de fim de semana são padrão, mas confirme que nenhum usuário está pendente de criação de link de compartilhamento durante a janela de migração. Envie uma notificação 48 horas antes do corte pedindo aos usuários que evitem compartilhar arquivos do servidor durante a migração. - Verifique a integridade dos links após a migração
Execute o relatório pós-migração do SPMT. Procure por arquivos que mostrem um status de Falha na preservação do link. Para esses arquivos, compartilhe-os novamente manualmente a partir do novo local do OneDrive. Use o relatório de Compartilhamento do OneDrive no centro de administração do Microsoft 365 para visualizar todos os links de compartilhamento ativos para cada site de usuário. - Redirecione o caminho antigo do servidor de arquivos para o OneDrive
Após a migração, configure um link DFS ou um redirecionamento de URL simples no servidor de arquivos. Quando um usuário clicar em um atalho de arquivo que aponta para o caminho antigo do servidor, o redirecionamento abre a URL web do OneDrive para esse arquivo. Isso reduz a confusão do usuário e os tickets de suporte.
Problemas Comuns Após a Migração do Servidor de Arquivos e Como Corrigi-los
Usuários relatam links quebrados na lista Recente do OneDrive
Se a lista recente mostrar arquivos com um X vermelho ou um erro “Arquivo não encontrado”, a migração não preservou os IDs dos arquivos. Para corrigir, use o SPMT para migrar novamente apenas esses arquivos específicos com a opção de preservação ativada. Se os arquivos já estiverem no OneDrive, exclua-os primeiro e execute novamente a migração. Após a nova migração, peça ao usuário para atualizar a página web do OneDrive pressionando F5.
Links compartilhados com usuários externos param de funcionar
Links de compartilhamento externo criados antes da migração também quebram porque o ID do arquivo mudou. A opção de preservação no SPMT não corrige retroativamente links que já foram enviados. Você deve gerar novos links de compartilhamento para usuários externos. Use o centro de administração do Microsoft 365 para visualizar todos os links de compartilhamento externo por site e notifique os usuários externos com o novo link.
A ferramenta de migração mostra “Preservação de link não suportada para este tipo de arquivo”
O SPMT não pode preservar links para arquivos maiores que 15 GB ou para arquivos armazenados em certas pastas criptografadas. Verifique o log de erros do SPMT para o nome exato do arquivo. Para esses arquivos, informe ao proprietário do arquivo que ele deve compartilhar o arquivo novamente manualmente após a migração. Mova esses arquivos em um lote separado para evitar bloquear toda a migração.
Métodos de Migração do Servidor de Arquivos: Comparação de Preservação de Links
| Item | Ferramenta de Migração do SharePoint (SPMT) | Cópia do Windows File Explorer |
|---|---|---|
| Preserva o ID do arquivo | Sim, quando a opção de preservação está ativada | Não |
| Preserva links de compartilhamento | Sim | Não |
| Suporta migração em massa | Sim, até 100 TB por tarefa | Não, manual por pasta |
| Lida com histórico de versões de arquivos | Sim, até 50 versões | Não |
| Requer credenciais de administrador | Sim, função de administrador do SharePoint | Não |
| Relatório de links pós-migração | Sim, incluído no resumo do SPMT | Não |
A tabela acima mostra que apenas o SPMT com a opção de preservação oferece preservação de links em escala. Qualquer método de cópia manual quebrará todos os links de compartilhamento existentes.
Agora você tem um checklist claro para evitar links de compartilhamento quebrados durante uma migração de servidor de arquivos para o OneDrive no fim de semana. Execute a varredura de avaliação primeiro, ative a opção de preservar links no SPMT e verifique a integridade dos links após o corte. Para arquivos onde a preservação de links falhar, use o relatório de Compartilhamento do OneDrive no centro de administração do Microsoft 365 para identificá-los e compartilhá-los novamente. Como dica avançada, crie um script PowerShell que exporte todos os links de compartilhamento do servidor de arquivos antigo usando os cmdlets Get-SPOSite e Get-SPOSiteSharingLink antes da migração e compare com o relatório pós-migração para detectar links perdidos.