Como Preservar Decisões de Compartilhamento Durante a Migração no OneDrive for Business

Ao migrar conteúdo do OneDrive for Business entre locatários ou para um novo usuário, as permissões de compartilhamento geralmente são perdidas ou redefinidas. Usuários perdem acesso a arquivos compartilhados e links de compartilhamento externo param de funcionar. Este artigo explica como usar as ferramentas de migração do Microsoft 365 e o PowerShell para preservar as decisões de compartilhamento durante uma migração do OneDrive.

As decisões de compartilhamento incluem permissões internas, links de compartilhamento externo e configurações de expiração de acesso. Sem planejamento adequado, essas configurações são substituídas por permissões padrão após a migração. Você aprenderá as etapas exatas para exportar os metadados de compartilhamento antes da migração e reaplicá-los após a movimentação dos arquivos.

Abordamos o Migration Manager da Microsoft, a Ferramenta de Migração do SharePoint (SPMT) e scripts PowerShell que capturam e restauram as configurações de compartilhamento. Seguindo estas etapas, você pode garantir que os arquivos compartilhados permaneçam acessíveis às mesmas pessoas após a conclusão da migração.

Por que as Decisões de Compartilhamento São Perdidas Durante a Migração do OneDrive

As decisões de compartilhamento do OneDrive são armazenadas como metadados em cada arquivo e pasta. Ao migrar conteúdo entre locatários, os IDs de objeto de usuários e grupos mudam. O OneDrive de destino não reconhece os IDs de usuário antigos, tratando todas as configurações de compartilhamento como inválidas. Por padrão, as ferramentas de migração ignoram os metadados de compartilhamento ou os substituem pelas permissões padrão do usuário de destino.

O Migration Manager da Microsoft e o SPMT podem preservar as permissões de compartilhamento se você configurar o mapeamento de identidade. O mapeamento de identidade cria uma tabela de consulta que associa IDs de usuário de origem a IDs de usuário de destino. Sem o mapeamento de identidade, o processo de migração descarta os links e permissões de compartilhamento. Os links de compartilhamento externo também quebram porque as URLs dos links contêm identificadores específicos do locatário que diferem entre origem e destino.

Para preservar as decisões de compartilhamento, você deve exportar os metadados de compartilhamento antes da migração, criar um mapa de identidade e reaplicar as permissões após a migração. As seções a seguir explicam cada etapa em detalhes.

Etapas para Preservar Permissões de Compartilhamento Durante a Migração do OneDrive

Siga estas etapas em ordem. Você precisa ter acesso de administrador global ou administrador do SharePoint nos locatários de origem e destino. Também é necessário ter o SharePoint Online Management Shell instalado.

1. Exportar metadados de compartilhamento do OneDrive de origem
   Abra o SharePoint Online Management Shell como administrador. Execute o comando Export-SPOUserProfile -LoginName usuario@origem.com -OutputFile C:\migracao\compartilhamento.xml. Isso exporta todas as permissões e links de compartilhamento do OneDrive do usuário. Repita para cada usuário cujo OneDrive você planeja migrar. Armazene os arquivos XML em uma pasta segura.
2. Criar um arquivo de mapeamento de identidade
   No centro de administração do Microsoft 365, vá para Configurações > Migração > Migration Manager. Selecione Migração do OneDrive e depois Criar mapeamento de identidade. Baixe o modelo CSV. Preencha o nome principal do usuário (UPN) de origem e o UPN de destino para cada usuário. Carregue o arquivo CSV preenchido no Migration Manager. Esse mapeamento informa à ferramenta de migração como traduzir os IDs de usuário.
3. Configurar a migração com preservação de permissões
   No Migration Manager, selecione o local do OneDrive de origem e o local do OneDrive de destino. Em Configurações avançadas, ative Preservar permissões. Essa opção usa o mapeamento de identidade para reatribuir as permissões de compartilhamento aos usuários de destino corretos. Ative também Preservar links de compartilhamento se quiser que os links de compartilhamento externo continuem funcionando. Inicie a verificação da migração. Revise o relatório de verificação em busca de avisos de permissão.
4. Executar a migração
   Após a verificação, selecione Migrar. O processo de migração move os arquivos e reaplica as permissões de compartilhamento usando o mapeamento de identidade. A ferramenta registra quaisquer permissões que não puderam ser mapeadas. Após a conclusão da migração, verifique se os arquivos estão compartilhados com os usuários corretos no OneDrive de destino.
5. Reaplicar permissões órfãs usando PowerShell
   Se o relatório de migração mostrar permissões não mapeadas, use o arquivo XML exportado na etapa 1. Execute Set-SPOUser -Site https://destino.sharepoint.com/personal/usuario_destino -LoginName usuario@destino.com -IsSiteCollectionAdmin $true para conceder acesso de administrador temporário. Em seguida, execute Grant-SPOSitePermission -Identity https://destino.sharepoint.com/personal/usuario_destino -User usuario@origem.com -Role Contribute para reaplicar as permissões ausentes. Substitua as URLs e nomes de usuário pelos valores de destino.

Problemas Comuns ao Preservar Permissões de Compartilhamento do OneDrive

Links de compartilhamento externo não funcionam após a migração

Os links de compartilhamento externo contêm um identificador específico do locatário. Ao migrar para um novo locatário, os links antigos apontam para um locatário que não hospeda mais os arquivos. Para corrigir isso, gere novos links de compartilhamento externo no OneDrive de destino. Use o comando Set-SPOSite -Identity https://destino.sharepoint.com/personal/usuario_destino -SharingCapability ExternalUserAndGuestSharing para habilitar o compartilhamento externo e, em seguida, peça aos usuários para compartilhar novamente os arquivos.

Erros de permissão para grupos que não existem mais

Se o locatário de origem usava grupos de distribuição ou grupos de segurança que não existem no locatário de destino, a ferramenta de migração não consegue mapear esses grupos. Você deve recriar esses grupos no locatário de destino com os mesmos membros. Em seguida, atualize o CSV de mapeamento de identidade para incluir os IDs de objeto dos grupos. Execute novamente a verificação da migração para aplicar o mapeamento corrigido.

Cliente de sincronização do OneDrive mostra erro de permissão ausente

Após a migração, o cliente de sincronização do OneDrive pode mostrar um X vermelho em pastas compartilhadas. Isso acontece quando o cliente de sincronização ainda referencia os metadados de compartilhamento antigos. Instrua os usuários a pausar e retomar a sincronização na bandeja do sistema do OneDrive. Clique com o botão direito no ícone do OneDrive, selecione Pausar sincronização > 2 horas e depois clique em Retomar sincronização. O cliente de sincronização atualizará os metadados de permissão do servidor.

Migration Manager vs SPMT para Preservar Decisões de Compartilhamento

Item	Migration Manager OneDrive	Ferramenta de Migração do SharePoint (SPMT)
Descrição	Ferramenta integrada do centro de administração do Microsoft 365 para migração de OneDrive entre locatários	Ferramenta desktop gratuita para migrar conteúdo de compartilhamentos de arquivos locais ou SharePoint para o OneDrive
Preservação de permissões	Suporta mapeamento de identidade e caixa de seleção Preservar permissões	Suporta opção Preservar permissões, mas requer CSV de mapeamento de identidade manual
Preservação de links de compartilhamento	Preserva links de compartilhamento quando ativado nas configurações avançadas	Não preserva links de compartilhamento; os links devem ser recriados
Melhor caso de uso	Migrações entre locatários com muitos usuários	Migrações de pequena escala ou conteúdo de servidores de arquivos

Use o Migration Manager para migrações entre locatários onde você precisa preservar links de compartilhamento. Use o SPMT para migrações de servidores de arquivos locais ou SharePoint on-premises onde links de compartilhamento não existem. Ambas as ferramentas exigem mapeamento de identidade para preservar permissões internas.

Agora você pode preservar decisões de compartilhamento durante uma migração do OneDrive usando o Migration Manager da Microsoft com mapeamento de identidade e a opção Preservar permissões. Comece exportando os metadados de compartilhamento do OneDrive de origem e, em seguida, crie um CSV de mapeamento de identidade no centro de administração. Após a migração, use o PowerShell para reaplicar quaisquer permissões que a ferramenta não conseguiu mapear. Para links de compartilhamento externo, gere novos links no locatário de destino, pois os links antigos contêm identificadores específicos do locatário que não podem ser transferidos. Essa abordagem garante que os usuários mantenham acesso aos arquivos compartilhados sem necessidade de recompartilhamento manual.