Etapa 5: Mapeamento de identidade (versão prévia)
Observação
A migração entre locatários do SharePoint está atualmente em uma fase de desenvolvimento de visualização privada. Como um projeto inacabado, qualquer informação ou disponibilidade está sujeita a alterações a qualquer momento. O suporte para clientes de versão prévia privada será tratado por email. A migração entre locatários do SharePoint é abordada pelos termos de versão prévia dos Termos de Licença Universal da Microsoft para Serviços Online.
Esta é a Etapa 5 em uma solução projetada para concluir uma migração do SharePoint entre locatários. Para saber mais, confira Visão geral da migração do SharePoint entre locatários.
- Etapa 1: conectar-se à origem e aos locatários de destino
- Etapa 2: estabelecer confiança entre a origem e o locatário de destino
- Etapa 3: Verificar se a confiança foi estabelecida
- Etapa 4: Pré-criar usuários e grupos
- Etapa 5: preparar o mapeamento de identidade
- Etapa 6: iniciar uma migração do SharePoint entre locatários
- Etapa 7: Etapas de migração pós-migração\n
Criar o arquivo de mapeamento de identidade
Nesta etapa do processo de migração entre locatários, você criará um único arquivo CSV (valores separados por vírgula) que contém o mapeamento dos usuários e grupos no locatário de origem para seus usuários e grupos correspondentes no locatário de destino.
Recomendamos que você tenha tempo para verificar seus mapeamentos, garantindo que eles sejam precisos antes de iniciar qualquer migração para o locatário de destino.
Há uma relação um-para-um no arquivo de mapeamento de identidade. Você não pode mapear o mesmo usuário para vários usuários no locatário de destino. Por exemplo, se você tiver instâncias em que o administrador é o proprietário de várias contas do SharePoint, a propriedade deverá ser alterada para corresponder ao usuário correspondente que você deseja migrar de Fonte para Destino. Se você não fizer isso, esses arquivos de conta não migrarão.
Exemplo: Neste exemplo, o administrador possui várias contas do SharePoint.
| Proprietário do locatário de origem | Usuário locatário de destino |
|---|---|
admin@source.com |
new.userA@target.com |
admin@source.com |
new.userB@target.com |
admin@source.com |
new.userC@target.com |
A migração entre locatários dá suporte a esse cenário:
Exemplo:
| Proprietário do locatário de origem | Usuário locatário de destino |
|---|---|
userA@source.com |
new.userA@target.com |
userB@source.com |
new.userB@target.com |
userC@source.com |
new.userC@target.com |
Criar o arquivo CSV
Há seis colunas necessárias no arquivo CSV. Os três primeiros são seus valores de origem, cada um fornecendo detalhes sobre onde seus dados estão localizados no momento. As três colunas restantes são as informações correspondentes sobre o locatário de destino. Todas as seis colunas devem ser contabilizados no arquivo. Crie seu arquivo no Excel e salve-o como um arquivo .csv.
Usuários e grupos são incluídos no mesmo arquivo. Dependendo se é um usuário ou grupo, o que você insere na coluna é diferente. Em cada uma das colunas, insira valores conforme mostrado nos exemplos. Não inclua títulos de coluna.
| Coluna | User | Agrupar | Grupo do Microsoft 365 |
|---|---|---|---|
| 1 | User | Agrupar | Agrupar |
| 2 | SourceTenantCompanyID | SourceTenantCompanyID | SourceTenantCompanyID |
| 3 | SourceUserUpn | SourceGroupObjectID | SourceGroupObjectID |
| 4 | TargetUserUpn | TargetGroupObjectID | TargetGroupObjectID |
| 5 | TargetUserEmail | GroupName | M365GroupAlias |
| 6 | UserType | GroupType | GroupType |
Importante
Ao criar o Mapeamento de Identidade para sites Conectados ao Grupo, a URL do site de destino deve se alinhar com o alias do novo Grupo criado no locatário De destino.
Exemplo:
- Site de origem:
https://contoso.sharepoint.com/teams/O365SourceGroup - Novo Alias do grupo de destino = O365TargetGroup
No arquivo mapeamento de identidade, o site de destino precisa ser: https://fabrikam.sharepoint.com/teams/O365TargetGroup.
Se o Alias de Destino e a URL de Destino não se alinharem, a migração falhará.
Não inclua títulos de coluna no arquivo CSV. Nos exemplos abaixo, incluímos-os apenas para fins ilustrativos.
Usuários. Insira seus valores conforme mostrado neste exemplo para usuários:
Usuários convidados. Você pode mapear contas de convidado no locatário de origem para contas membro no locatário de destino. Você também pode mapear uma conta de convidado na origem para uma conta de convidado no destino se o convidado tiver sido criado anteriormente. Insira seus valores conforme mostrado neste exemplo para convidados:
Grupos. Insira seus valores conforme mostrado neste exemplo para grupos: 
Exemplo:
Grupos do Microsoft 365. Insira seus valores conforme mostrado neste exemplo para grupos do Microsoft 365:
Vários usuários e grupos em um arquivo CSV:
Exemplo:
Obter a ID da empresa de locatário de origem
Para obter a ID da Empresa de Locatário de Origem:
- Entre como Administração ao seu portal do Azure
- Selecione ou Pesquise Microsoft Entra ID.
- Role para baixo no painel esquerdo e selecione Propriedades.
- Localize o Campo ID do Locatário. A ID do Locatário necessária estará nessa caixa.
Para obter a ID do objeto do grupo de origem:
- Entre no locatário de origem como Administração para grupos do Azure.
- Pesquise seus grupos necessários.
- Selecione a instância de Grupo necessária e copie para a área de transferência. Cole esse valor na coluna sourceGroupObjectId do arquivo CSV de mapeamento.
- Se você tiver vários Grupos a serem mapeados, repita essas etapas para cada grupo.
Para obter a ID do objeto de grupo de destino:
- Entrar no locatário de destino como Administração para grupos do Azure
- Pesquise seus grupos necessários.
- Selecione a instância de grupo necessária e copie para a área de transferência. Cole esse valor na coluna targetGroupObjectId do arquivo CSV de mapeamento.
- Se você tiver vários grupos para mapear, repita o processo acima para obter os destinos específicosGroupObjectId.
- Para o GroupName, use a mesma ID que o TargetGroupObjectId obtido.
Carregar o mapa de identidade
Depois que o arquivo de mapeamento de identidade for preparado, o Administrador do SharePoint no locatário de destino carregará o arquivo no SharePoint. Isso permitirá que o mapeamento de identidade ocorra automaticamente como parte da migração entre locatários.
Importante
Antes de executar o comando Add-SPOTenantIdentityMap -IdentityMapPath , salve e feche o arquivo identitymap.csv em sua Área de Trabalho/SharePoint/SharePoint.
Se o arquivo permanecer aberto, você receberá o seguinte erro. Add-SPOTenantIdentityMap: o processo não pode acessar o arquivo 'C:\Users\myuser\Test-Identity-Map.csv' porque ele está sendo usado por outro processo.
- Para carregar o Mapa de identidade no locatário de destino, execute o comando a seguir. Para -IdentityMapPath, forneça o caminho completo e o nome do arquivo CSV de mapeamento de identidade.
Add-SPOTenantIdentityMap -IdentityMapPath <identitymap.csv>
Importante
Se você fizer ou precisar fazer alterações no Mapa de Identidade durante o ciclo de vida da migração, deverá executar o Add-SPOTenantIdentityMap -IdentityMapPath <identitymap.csv> comando sempre que uma alteração for feita para garantir que essas alterações sejam aplicadas à migração.
Carregar qualquer novo mapa de identidade substituirá o atual. Verifique se qualquer revisão ou adição inclui TODOS os usuários e grupos para a migração completa. Seu mapa de identidade deve sempre incluir todos que você deseja migrar.
Para examinar as entradas de mapeamento no arquivo de mapeamento de identidade de um determinado usuário, use o comando Get-SPOTenantIdentityMappingUser com Field como SourceUserKey e Value como o UPN do usuário que você está movendo.
Exemplo:
get-spoTenantIdentityMappingUser -Field SourceUserKey -Value usera@Contoso.onmicrosoft.com
Verificar status de compatibilidade entre locatários
Antes de iniciar qualquer migração entre locatários, verifique se ambos os esquemas de banco de dados do SharePoint estão atualizados e compatíveis entre a origem e o destino.
Para executar esse marcar, execute o cmdlet abaixo em seu locatário de origem.
Get-SPOCrossTenantCompatibilityStatus -PartnerCrossTenantHostURL [Target tenant hostname]
Get-SPOCrossTenantCompatibilityStatus -PartnerCrossTenantHostURL https://m365x12395529-my.sharepoint.com
- Se o locatário status for mostrado como Compatível ou Aviso, você poderá prosseguir com a próxima etapa de iniciar migrações entre locatários.
- Se o locatário status for mostrado como incompatível, seus locatários precisarão ser corrigidos/atualizados para garantir a compatibilidade.
| Status | Pode continuar com a migração |
|---|---|
| Compatível | Sim |
| Aviso | Sim |
| Incompatível | Não |
Observação
Recomendamos aguardar um período de 48 horas. Se seus locatários ainda estiverem relatando como incompatíveis, entre em contato com o suporte.
Recomendamos executar o status marcar de compatibilidade com frequência e antes de iniciar qualquer instância de migrações entre locatários. Se os locatários não forem compatíveis, isso poderá resultar em falha nas migrações entre locatários.
Etapa 6: iniciar uma migração entre locatários do SharePoint
Comentários
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, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de