Solução de problemas de migração de servidor de arquivos para OneDrive for Business em cortes de fim de semana: links recentes quebrados

Ao migrar servidores de arquivos para o OneDrive for Business durante um corte de fim de semana, os usuários frequentemente relatam que os links compartilhados do servidor antigo não funcionam mais. Esses links quebrados geram erros de acesso negado ou arquivo não encontrado, interrompendo os fluxos de trabalho imediatamente após a migração. A causa raiz é que o corte altera o caminho do arquivo ou a estrutura da URL, e os links compartilhados ainda apontam para o local original do servidor em vez do novo caminho do OneDrive. Este artigo explica por que esses links quebram, fornece um método passo a passo para evitar o problema antes do corte e descreve como corrigir links já quebrados.

Por que a migração do servidor de arquivos quebra links compartilhados

Ao migrar arquivos de um servidor de arquivos de rede para o OneDrive for Business, o caminho do arquivo subjacente muda de um caminho UNC, como \fileserver\shared\Project\Report.docx, para uma URL do OneDrive como https://contoso-my.sharepoint.com/personal/user/Documents/Project/Report.docx. Qualquer link compartilhado do servidor de arquivos contém o caminho UNC original. Após o corte, o servidor de arquivos é desativado ou suas permissões de compartilhamento são modificadas, tornando esses caminhos UNC inacessíveis.

A Ferramenta de Migração do SharePoint não atualiza automaticamente os links compartilhados existentes durante o processo de migração. Ela copia arquivos e metadados, mas mantém os links antigos intactos. O corte, normalmente realizado durante um fim de semana, introduz uma lacuna em que os usuários esperam que os arquivos migrados estejam acessíveis pelos links antigos, mas os encontram quebrados.

O papel da janela de corte

Um corte de fim de semana significa que o servidor de arquivos é descomissionado ou seus compartilhamentos são desabilitados na sexta-feira à noite, e espera-se que os usuários acessem os arquivos pelo OneDrive a partir de segunda-feira de manhã. Durante essa janela, ninguém pode atualizar os links. Se a migração não estiver configurada para preservar ou redirecionar links, toda URL compartilhada do servidor antigo se torna inválida.

Passos para evitar links quebrados antes do corte

Siga estes passos na semana anterior ao corte para minimizar ou eliminar links compartilhados quebrados.

1. Execute uma pré-verificação com a Ferramenta de Migração do SharePoint
   Abra o SPMT e crie um novo trabalho de migração para o compartilhamento do servidor de arquivos. Na etapa “Verificação”, selecione “Verificação completa” e ative “Analisar links compartilhados”. A ferramenta gera um relatório listando cada link compartilhado que será quebrado. Exporte este relatório para CSV para planejamento de correção.
2. Notifique os proprietários dos links sobre a quebra pendente
   Use o relatório CSV para identificar o criador original de cada link. Envie um e-mail automatizado do centro de administração do Microsoft 365 ou um script do PowerShell que liste os arquivos exatos cujos links compartilhados serão quebrados. Instrua os proprietários a compartilhar novamente esses arquivos do OneDrive após a migração.
3. Configure o redirecionamento de links no SPMT
   Nas configurações do SPMT, em “Avançado”, ative “Redirecionar links compartilhados para o novo local”. Esta opção cria um redirecionamento de URL do caminho antigo do servidor de arquivos para a nova URL do OneDrive. O redirecionamento funciona apenas se o servidor antigo permanecer acessível durante o corte. Se o servidor for totalmente descomissionado, essa configuração não terá efeito.
4. Teste a migração em um subconjunto de arquivos
   Crie um compartilhamento de teste no servidor de arquivos com 20 a 50 arquivos. Execute uma migração de teste para o OneDrive usando o SPMT com a opção de redirecionamento ativada. Após o teste, verifique se os links compartilhados nesses arquivos de teste resolvem para as URLs do OneDrive. Ajuste as configurações antes do corte completo.

Como corrigir links já quebrados após o corte

Se o corte foi concluído e os usuários relatam links quebrados, use estes métodos para repará-los.

1. Use a ferramenta de reparo de links do Centro de Administração do SharePoint
   Vá para Centro de administração do Microsoft 365 > SharePoint > Migração > Reparação de links. Clique em “Iniciar verificação” para identificar todos os links compartilhados quebrados no locatário. A ferramenta lista cada link quebrado junto com o caminho do arquivo de destino no OneDrive. Selecione os links e clique em “Reparar” para atualizá-los para a URL do OneDrive.
2. Repare links com PowerShell
   Abra o SharePoint Online Management Shell como administrador. Execute Connect-SPOService -Url https://contoso-admin.sharepoint.com. Em seguida, execute Repair-SPOSiteGroup -Identity "https://contoso-my.sharepoint.com/personal/user" -OldUrl "\\fileserver\shared" -NewUrl "https://contoso-my.sharepoint.com/personal/user/Documents". Este comando substitui todas as ocorrências do caminho UNC antigo em links compartilhados dentro do site do OneDrive especificado.
3. Peça aos usuários para compartilhar novamente os arquivos manualmente
   Para um pequeno número de links quebrados, instrua os usuários a abrir o arquivo no OneDrive, clicar no botão Compartilhar e criar um novo link de compartilhamento. Eles devem então enviar o novo link para qualquer pessoa que recebeu o antigo. Este método é demorado, mas funciona quando as ferramentas administrativas não conseguem encontrar os links quebrados.

Se os links compartilhados ainda falharem após o reparo

Links quebrados apontam para um arquivo que não foi migrado

Verifique o relatório de migração do SPMT para confirmar se o arquivo foi incluído. Se o arquivo foi excluído devido ao bloqueio de tipo de arquivo ou limites de tamanho, o link não pode ser reparado. Adicione o arquivo a um novo trabalho de migração e execute-o novamente. Em seguida, repita a etapa de reparo de link.

Usuários veem “Acesso negado” em links reparados

A ferramenta de reparo atualiza a URL, mas não altera as permissões. Verifique se as configurações de compartilhamento externo no OneDrive permitem os destinatários pretendidos. Vá para Centro de administração do Microsoft 365 > SharePoint > Políticas > Compartilhamento e certifique-se de que “Qualquer pessoa” ou “Convidados novos e existentes” esteja selecionado conforme necessário. Se o link original foi compartilhado com pessoas específicas, essas pessoas devem ser adicionadas novamente às permissões de compartilhamento do arquivo no OneDrive.

Links reparados abrem o arquivo errado

Isso ocorre quando a migração renomeou arquivos ou os colocou em pastas diferentes. Revise o arquivo de mapeamento do SPMT para garantir que os caminhos de origem e destino correspondam exatamente. Se um arquivo foi movido para uma pasta diferente após a migração, você deve atualizar manualmente o link ou mover o arquivo de volta para o local esperado.

Item	Prevenção pré-corte	Reparo pós-corte
Ferramenta usada	Pré-verificação da Ferramenta de Migração do SharePoint	Reparação de links do Centro de Administração do SharePoint ou PowerShell
Tempo necessário	Vários dias antes do corte	Horas a dias após o corte
Taxa de sucesso para preservação de links	Alta se o redirecionamento estiver ativado e o servidor permanecer online	Alta para links identificados, baixa para links desconhecidos
Envolvimento do usuário	Proprietários dos links devem compartilhar novamente proativamente	Usuários podem precisar compartilhar novamente se o reparo falhar

Agora você sabe por que a migração do servidor de arquivos durante um corte de fim de semana quebra os links compartilhados do OneDrive e como prevenir ou repará-los. Antes do seu próximo corte, execute a pré-verificação do SPMT com análise de links e ative a opção de redirecionamento. Após o corte, use a ferramenta de reparo de links do Centro de Administração do SharePoint ou o comando PowerShell Repair-SPOSiteGroup para corrigir URLs quebradas. Para arquivos que não foram migrados, execute um trabalho de migração direcionado e depois reaplique o reparo.