Migração entre Locatários Deixa Links de Compartilhamento Quebrados: Correção no OneDrive for Business

Após uma migração entre locatários, os usuários frequentemente descobrem que os links compartilhados para arquivos e pastas no OneDrive for Business não funcionam mais. Esses links retornam erros como “Acesso Negado” ou “Item não encontrado” porque os IDs de arquivo e URLs do locatário foram alterados durante a migração. Este artigo explica por que os links de compartilhamento quebram durante uma migração entre locatários e fornece um método passo a passo para restaurá-los usando as ferramentas nativas da Microsoft e scripts PowerShell.

Por que a Migração entre Locatários Quebra os Links de Compartilhamento do OneDrive

Ao mover o OneDrive de um usuário de um locatário para outro, o locatário de destino atribui um novo ID de site, novo ID de biblioteca de documentos e novos IDs de arquivo exclusivos. Os links de compartilhamento contêm esses IDs como parte da URL. Por exemplo, um link como https://oldtenant-my.sharepoint.com/personal/user_oldtenant_com/_layouts/15/guestaccess.aspx?share=... inclui o identificador do locatário antigo e o GUID do arquivo. Após a migração, o arquivo existe em uma nova URL no novo locatário. O link antigo aponta para um local que não existe mais ou pertence a um locatário diferente. A infraestrutura de compartilhamento da Microsoft não redireciona automaticamente links antigos para o novo local porque a migração é uma movimentação completa de conteúdo, não uma renomeação.

Dois Tipos de Links Quebrados

Existem duas categorias de links quebrados após uma migração entre locatários:

1. Links compartilhados do OneDrive para usuários externos. Esses links dependem do token de acesso de convidado do locatário antigo. Após a migração, o token é inválido porque o arquivo não reside mais no locatário antigo. Usuários externos veem uma página de “Acesso Negado”.

2. Links compartilhados dentro da organização entre locatários diferentes. Se a migração envolveu a divisão de uma empresa em dois locatários, os usuários internos no novo locatário não conseguem abrir links que ainda referenciam a coleção de sites do locatário antigo. Esse cenário ocorre frequentemente durante cisões ou fusões.

Passos para Restaurar Links de Compartilhamento Após Migração entre Locatários

O único método suportado para corrigir links de compartilhamento quebrados é gerar novos links para os arquivos migrados e comunicar as novas URLs a todos os usuários afetados. A Microsoft não fornece um recurso direto de “remapear link antigo para novo arquivo”. Os passos a seguir usam o SharePoint Online Management Shell e o Microsoft Graph PowerShell para identificar e recriar os links.

Pré-requisitos

Antes de começar, verifique o seguinte:

• Você concluiu a migração entre locatários usando a ferramenta de Migração de Dados de Usuário entre Locatários da Microsoft ou um serviço de migração de terceiros.
• Você tem o SharePoint Online Management Shell instalado em uma máquina Windows.
• Você tem o SDK do Microsoft Graph PowerShell instalado e autenticado com os escopos Files.ReadWrite.All e Sites.ReadWrite.All.
• Você tem uma lista de todas as URLs do OneDrive dos usuários migrados (por exemplo, https://newtenant-my.sharepoint.com/personal/user_newtenant_com).

Passo 1: Identificar Todos os Links Quebrados em uma Biblioteca do OneDrive

1. Conectar ao SharePoint Online
   Abra o SharePoint Online Management Shell como administrador. Execute Connect-SPOService -Url https://newtenant-admin.sharepoint.com e faça login com uma conta de administrador global.
2. Recuperar a coleção de sites do OneDrive
   Execute Get-SPOSite -IncludePersonalSite $true -Filter {Url -like "/personal/user_newtenant_com"} para confirmar que o site existe.
3. Exportar todos os links de compartilhamento
   Use o cmdlet Get-SPOSiteSharingLink para listar todos os links de compartilhamento ativos do site do OneDrive. Execute Get-SPOSiteSharingLink -Site https://newtenant-my.sharepoint.com/personal/user_newtenant_com | Export-Csv -Path "C:\temp\links.csv". Isso exporta detalhes dos links, incluindo o caminho do arquivo de destino, tipo de link e data de expiração.
4. Identificar links quebrados
   Abra o arquivo CSV no Excel. Filtre pelos links que foram criados antes da data da migração. Esses são os links quebrados. Anote os caminhos dos arquivos e os usuários que possuem os links.

Passo 2: Gerar Novos Links de Compartilhamento Usando o Microsoft Graph

1. Conectar ao Microsoft Graph PowerShell
   Abra uma nova janela do PowerShell. Execute Connect-MgGraph -Scopes "Files.ReadWrite.All", "Sites.ReadWrite.All" e faça login com a mesma conta de administrador.
2. Obter o ID da unidade do OneDrive do usuário
   Execute Get-MgUserDrive -UserId user@newtenant.com | Select-Object Id, WebUrl. Anote o valor de Id.
3. Criar um novo link de compartilhamento para cada arquivo quebrado
   Use o cmdlet New-MgDriveItemLink. Por exemplo: New-MgDriveItemLink -DriveId "drive-id" -DriveItemId "item-id" -Type "edit" -Scope "anonymous". Substitua drive-id e item-id pelos valores da exportação CSV. O cmdlet retorna a nova URL de compartilhamento.
4. Registrar as novas URLs
   Direcione a saída para um arquivo CSV para distribuição posterior: New-MgDriveItemLink ... | Export-Csv -Path "C:\temp\newlinks.csv" -Append.

Passo 3: Distribuir Novos Links para os Usuários Afetados

1. Enviar uma notificação por e-mail
   Use o Microsoft Graph para enviar um e-mail para cada usuário cujo OneDrive foi migrado. Inclua os novos links de compartilhamento e instruções para atualizar favoritos ou recompartilhar os arquivos.
2. Remover links antigos quebrados (opcional)
   Para limpeza, execute Remove-SPOSiteSharingLink -Site https://newtenant-my.sharepoint.com/personal/user_newtenant_com -SharingLinkId "old-link-id" para cada link quebrado. Obtenha o SharingLinkId da exportação CSV.

Se os Links de Compartilhamento do OneDrive Ainda Falharem Após a Correção

Usuários externos veem “Acesso Negado” mesmo com novos links

Isso ocorre se as configurações de compartilhamento externo do novo locatário forem mais restritivas que as do antigo. Vá para Central de administração do Microsoft 365 > Configurações > Configurações da organização > SharePoint > Compartilhamento. Certifique-se de que “Permitir compartilhamento com usuários externos e usar links de acesso anônimo” esteja ativado. Verifique também se o tipo de link que você criou (por exemplo, “Anônimo” ou “Toda a empresa”) é permitido pela política do locatário.

Links expiram imediatamente após a criação

Se o novo locatário tiver uma política de expiração padrão mais curta, os links recém-criados podem expirar em dias em vez de anos. Nas configurações de Compartilhamento do SharePoint, ajuste a seção “Escolher opções de expiração e permissão para links de compartilhamento”. Defina uma expiração padrão que atenda às necessidades da sua organização ou crie links com o parâmetro -ExpirationDateTime no PowerShell para substituir o padrão.

O aplicativo de sincronização do OneDrive mostra “Este arquivo está compartilhado” mas o link está quebrado

Isso acontece quando o aplicativo de sincronização armazenou em cache os metadados do link antigo. Peça ao usuário para executar o aplicativo de sincronização do OneDrive > Configurações > Desvincular este PC e, em seguida, vincular novamente a conta. Após o aplicativo de sincronização reindexar os arquivos, ele buscará os novos metadados de compartilhamento do servidor.

Links Antigos vs Novos Links: Principais Diferenças Após Migração entre Locatários

Item	Link Antigo (Pré-Migração)	Novo Link (Pós-Migração)
Domínio do locatário	oldtenant-my.sharepoint.com	newtenant-my.sharepoint.com
GUID do arquivo	Exclusivo do banco de dados de conteúdo do locatário antigo	Novo GUID atribuído durante a migração
Token de acesso de convidado	Emitido pelo Azure AD do locatário antigo	Emitido pelo Azure AD do novo locatário
Tipo de link (editar/visualizar)	Preservado se a ferramenta de migração copiou as permissões	Deve ser recriado manualmente ou via script
Data de expiração	Definida pela política do locatário antigo	Definida pela política do novo locatário

Após uma migração entre locatários, agora você pode identificar links de compartilhamento quebrados do OneDrive e gerar novos usando PowerShell. Em seguida, revise as configurações de compartilhamento externo do seu novo locatário para evitar futuras falhas de link. Uma dica concreta: execute um script pré-migração que exporte todos os links de compartilhamento para um CSV antes do início da migração — isso fornece um inventário completo para recriar links mais rapidamente no novo locatário.