Qué vas a conseguir
Llevar los usuarios, el correo y los archivos de una empresa de un tenant de Microsoft 365 a otro con un fin de semana de corte y un lunes tranquilo. Saber desde el principio qué se migra con herramientas, qué hay que rehacer a mano y qué no se puede mover, para que nadie se entere el lunes.
Antes de empezar
- El escenario claro: fusión (dos tenants pasan a uno), escisión (una parte de la empresa sale a un tenant nuevo, normalmente con un acuerdo de servicios transitorios, TSA, que fija hasta cuándo el origen da servicio) o cambio de marca (el dominio cambia de tenant).
- Roles administrativos en los dos tenants, activados por PIM (guía de Global Admin y PIM).
- Las herramientas: la migración nativa de buzones y de OneDrive entre tenants necesita una licencia Cross-Tenant User Data Migration por usuario migrado; la alternativa son herramientas de terceros (para correo, OneDrive, SharePoint y Teams) con su propio coste.
- El repo 29 del portfolio, *Tenant Separation Cutover Planner*, sirve de plantilla para el plan del corte y sus dependencias.
1. El inventario
Todo lo que no está en el inventario aparece el lunes como ticket.
Connect-ExchangeOnlineGet-EXOMailbox -ResultSize Unlimited -Properties RecipientTypeDetails | Group-Object RecipientTypeDetails | Select-Object Name, CountGet-EXOMailbox -ResultSize Unlimited | Get-EXOMailboxStatistics | Sort-Object TotalItemSize -Descending | Select-Object -First 5 DisplayName, TotalItemSize, ItemCountName Count---- -----UserMailbox 412SharedMailbox 37RoomMailbox 18EquipmentMailbox 3DisplayName TotalItemSize ItemCount----------- ------------- ---------Carlos Martín 48.71 GB (52,302,131,200 bytes) 398112Facturación 31.02 GB (33,307,705,344 bytes) 521007| Elemento | Cómo se mueve |
|---|---|
| Usuarios y grupos | Se crean en el destino (o los sincroniza Entra Connect del destino) |
| Buzones de usuario, compartidos y archivos | Migración entre tenants (nativa o herramienta) |
| OneDrive | Migración entre tenants (nativa o herramienta) |
| Sitios de SharePoint y archivos de Teams | Herramienta de migración, sitio a sitio |
| Chats de Teams | No se mueven de forma nativa: se avisa y se exportan si hace falta por cumplimiento |
| Aplicaciones con SSO | Se dan de alta otra vez en el destino (guía de Entra ID SSO) |
| Dispositivos | No se mueven: se restablecen y se inscriben en el destino |
| Licencias, Conditional Access, Intune | Se rehacen en el destino antes del corte |
| Dominio de correo | Se mueve el día del corte (solo puede estar en un tenant) |
2. Las identidades en el destino
- Cada usuario existe en el destino antes del corte, con un UPN provisional en el dominio
onmicrosoft.comdel destino (el dominio de verdad aún está en el origen). - Un CSV de correspondencias es la columna vertebral de todo el proyecto:
SourceUPN,TargetUPN,FinalUPN. Lo usan los scripts de buzones, de OneDrive, de licencias y de UPN final. - Los usuarios tendrán que registrar MFA otra vez en el tenant destino: se prepara la comunicación y, si se puede, se usan Temporary Access Pass el lunes para que el primer inicio de sesión sea sencillo.
3. Los buzones entre tenants
Las piezas de la migración nativa: una aplicación de migración en el tenant destino con consentimiento del origen, una relación de organización en cada tenant que permite mover buzones, y un punto de conexión de migración en el destino.
En el destino, cada usuario es primero un usuario de correo (MailUser) que se convierte en buzón al migrar. Tres atributos tienen que coincidir con el origen:
Set-MailUser -Identity "laura.prado" -ExchangeGuid "4f1d2a9c-0b3e-4c8e-9a51-7c2d1e6b3f10" -ArchiveGuid "9b7e3c21-5d4a-4e0f-8c6b-2a1f9d0e7c45"Set-MailUser -Identity "laura.prado" -EmailAddresses @{ add = "x500:/o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=7a1c0e5b9d2f4c3a8e6b1d0f2a9c4e7b-laura.prado" }ExchangeGuidyArchiveGuidiguales a los del buzón de origen: sin ellos, la migración no encuentra destino.- La dirección x500 con el
LegacyExchangeDNdel origen: sin ella, responder a un correo antiguo o a una convocatoria vieja rebota con un errorIMCEAEX. Es el fallo que más tickets genera tras una migración.
New-MigrationBatch -Name "ola1-finanzas" -SourceEndpoint "ep-origen" -CSVData ([System.IO.File]::ReadAllBytes("C:\mig\ola1.csv")) -TargetDeliveryDomain "fabrikam.onmicrosoft.com" -AutostartGet-MigrationUser -BatchId "ola1-finanzas" | Get-MigrationUserStatistics | Format-Table Identity, Status, SyncedItemCount, SkippedItemCountIdentity Status SyncedItemCount SkippedItemCount-------- ------ --------------- ----------------laura.prado@fabrikam.com Synced 84211 0carlos.martin@fabrikam.com Syncing 301455 12Los lotes se crean y sincronizan semanas antes del corte: copian casi todo y se quedan en *Synced*, actualizándose. El día del corte solo se completa el último incremento, que tarda minutos y no días. Los elementos omitidos (*SkippedItemCount*) se revisan antes, no el lunes.
4. OneDrive, SharePoint y Teams
- OneDrive: la migración nativa entre tenants (
Start-SPOCrossTenantUserContentMoveen SharePoint Online PowerShell, tras confiar los dos tenants) mueve el OneDrive completo y deja una redirección en el origen. Con herramientas de terceros, el modelo es el mismo: copia previa y delta el fin de semana. - SharePoint y Teams: sitio a sitio con la herramienta de migración, con los propietarios de cada sitio validando antes del corte qué se lleva y qué se archiva.
- Los chats de Teams no viajan: se avisa con tiempo para que lo importante se guarde en un canal o un documento.
5. El fin de semana del corte
El dominio no puede estar en dos tenants a la vez, y Entra ID no te deja quitarlo del origen mientras algún objeto lo use. Encontrarlos lleva tiempo; se ensaya antes con un script:
Get-Recipient -ResultSize Unlimited | Where-Object { $_.EmailAddresses -match "@fabrikam\.com" } | Select-Object Name, RecipientTypeDetailsDispositivos: los equipos unidos a Entra ID y gestionados por Intune no se pueden mover entre tenants. Se borra su registro de Autopilot en el origen, se importa el hash en el destino y se restablecen (en el corte o por olas, con los datos ya en OneDrive). Los equipos unidos a un AD local se vuelven a unir al dominio del destino.
6. La semana de hipercuidado
- Rebotes: seguimiento de mensajes en el destino buscando
550 5.1.1eIMCEAEX; cada uno suele ser una x500 que falta. - MFA y primer inicio de sesión: el pico de llamadas del lunes. Los Temporary Access Pass y una guía de una página con capturas reducen la cola.
- Outlook: perfiles que hay que volver a crear y buzones compartidos que no aparecen (los permisos se vuelven a aplicar en el destino desde el inventario).
- Un parte diario a dirección: incidencias abiertas, cerradas y las que requieren decisión.
- Al cerrar el TSA: retirar licencias y cerrar el tenant de origen (o la parte que corresponda) con copia de lo que haya que conservar por cumplimiento.
Siguientes pasos
- Si los tenants van a convivir, sincronización entre tenants y la organización multiinquilino de Microsoft 365: los usuarios se ven en el directorio y en Teams sin migrar nada.
- Acceso B2B durante el TSA: que los usuarios ya migrados entren como invitados a lo que aún vive en el origen.
- La guía de Azure AD Connect del Nivel 2: en una migración híbrida es la pieza que se desmonta en el origen y se monta en el destino.
¿Falta algo o en tu entorno es distinto? Escríbeme y lo corrijo.
What you'll get
Moving a company's users, mail and files from one Microsoft 365 tenant to another with a single cutover weekend and a quiet Monday. Knowing from the start what is migrated with tools, what has to be rebuilt by hand and what cannot be moved, so nobody finds out on Monday.
Before you start
- A clear scenario: merger (two tenants become one), divestiture (part of the company moves to a new tenant, usually with a transitional services agreement, TSA, that sets how long the source keeps providing service) or rebrand (the domain changes tenant).
- Admin roles in both tenants, activated through PIM (Global Admin and PIM guide).
- The tools: native cross-tenant mailbox and OneDrive migration needs a Cross-Tenant User Data Migration licence per migrated user; the alternative is third-party tools (for mail, OneDrive, SharePoint and Teams) with their own cost.
- Repo 29 in the portfolio, *Tenant Separation Cutover Planner*, works as a template for the cutover plan and its dependencies.
1. The inventory
Everything that isn't in the inventory turns up on Monday as a ticket.
Connect-ExchangeOnlineGet-EXOMailbox -ResultSize Unlimited -Properties RecipientTypeDetails | Group-Object RecipientTypeDetails | Select-Object Name, CountGet-EXOMailbox -ResultSize Unlimited | Get-EXOMailboxStatistics | Sort-Object TotalItemSize -Descending | Select-Object -First 5 DisplayName, TotalItemSize, ItemCountName Count---- -----UserMailbox 412SharedMailbox 37RoomMailbox 18EquipmentMailbox 3DisplayName TotalItemSize ItemCount----------- ------------- ---------Carlos Martín 48.71 GB (52,302,131,200 bytes) 398112Invoicing 31.02 GB (33,307,705,344 bytes) 521007| Item | How it moves |
|---|---|
| Users and groups | Created in the target (or synchronised by the target's Entra Connect) |
| User and shared mailboxes, archives | Cross-tenant migration (native or a tool) |
| OneDrive | Cross-tenant migration (native or a tool) |
| SharePoint sites and Teams files | Migration tool, site by site |
| Teams chats | Not moved natively: users are warned and they are exported if compliance requires it |
| Apps with SSO | Onboarded again in the target (Entra ID SSO guide) |
| Devices | Not moved: reset and enrolled in the target |
| Licences, Conditional Access, Intune | Rebuilt in the target before the cutover |
| Mail domain | Moved on cutover day (it can only live in one tenant) |
2. Identities in the target
- Every user exists in the target before the cutover, with a temporary UPN on the target's
onmicrosoft.comdomain (the real domain is still in the source). - A mapping CSV is the backbone of the whole project:
SourceUPN,TargetUPN,FinalUPN. The mailbox, OneDrive, licence and final-UPN scripts all use it. - Users will have to register MFA again in the target tenant: prepare the communication and, where possible, use Temporary Access Pass on Monday so the first sign-in is simple.
3. Cross-tenant mailboxes
The pieces of the native migration: a migration application in the target tenant with consent from the source, an organization relationship in each tenant that allows mailbox moves, and a migration endpoint in the target.
In the target, each user starts as a mail user (MailUser) that becomes a mailbox when migrated. Three attributes must match the source:
Set-MailUser -Identity "laura.prado" -ExchangeGuid "4f1d2a9c-0b3e-4c8e-9a51-7c2d1e6b3f10" -ArchiveGuid "9b7e3c21-5d4a-4e0f-8c6b-2a1f9d0e7c45"Set-MailUser -Identity "laura.prado" -EmailAddresses @{ add = "x500:/o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=7a1c0e5b9d2f4c3a8e6b1d0f2a9c4e7b-laura.prado" }ExchangeGuidandArchiveGuidequal to the source mailbox's: without them, the migration finds no target.- The x500 address with the source
LegacyExchangeDN: without it, replying to an old email or an old meeting invite bounces with anIMCEAEXerror. It is the failure that generates most tickets after a migration.
New-MigrationBatch -Name "wave1-finance" -SourceEndpoint "ep-source" -CSVData ([System.IO.File]::ReadAllBytes("C:\mig\wave1.csv")) -TargetDeliveryDomain "fabrikam.onmicrosoft.com" -AutostartGet-MigrationUser -BatchId "wave1-finance" | Get-MigrationUserStatistics | Format-Table Identity, Status, SyncedItemCount, SkippedItemCountIdentity Status SyncedItemCount SkippedItemCount-------- ------ --------------- ----------------laura.prado@fabrikam.com Synced 84211 0carlos.martin@fabrikam.com Syncing 301455 12Batches are created and synchronised weeks before the cutover: they copy almost everything and stay in *Synced*, keeping up to date. On cutover day only the last increment is completed, which takes minutes rather than days. Skipped items (*SkippedItemCount*) are reviewed beforehand, not on Monday.
4. OneDrive, SharePoint and Teams
- OneDrive: native cross-tenant migration (
Start-SPOCrossTenantUserContentMovein SharePoint Online PowerShell, once the two tenants trust each other) moves the whole OneDrive and leaves a redirect in the source. With third-party tools the model is the same: a pre-copy and a delta over the weekend. - SharePoint and Teams: site by site with the migration tool, with each site's owners validating before the cutover what is taken and what is archived.
- Teams chats don't travel: users are warned early so anything important is saved to a channel or a document.
5. The cutover weekend
The domain can't live in two tenants at once, and Entra ID won't let you remove it from the source while any object still uses it. Finding them takes time; rehearse it beforehand with a script:
Get-Recipient -ResultSize Unlimited | Where-Object { $_.EmailAddresses -match "@fabrikam\.com" } | Select-Object Name, RecipientTypeDetailsDevices: devices joined to Entra ID and managed by Intune can't be moved between tenants. Their Autopilot registration is deleted in the source, the hash is imported into the target and they are reset (at cutover or in waves, with the data already in OneDrive). Devices joined to an on-premises AD are re-joined to the target's domain.
6. The hypercare week
- Bounces: message trace in the target looking for
550 5.1.1andIMCEAEX; each one is usually a missing x500. - MFA and first sign-in: Monday's call peak. Temporary Access Pass and a one-page guide with screenshots shorten the queue.
- Outlook: profiles that need recreating and shared mailboxes that don't appear (permissions are re-applied in the target from the inventory).
- A daily report to management: incidents open, closed and those that need a decision.
- When the TSA ends: remove licences and close the source tenant (or the relevant part) with a copy of whatever must be kept for compliance.
Next steps
- If the tenants will live side by side, cross-tenant synchronisation and Microsoft 365's multitenant organization: users see each other in the directory and in Teams without migrating anything.
- B2B access during the TSA: users already migrated sign in as guests to whatever still lives in the source.
- The Level 2 Azure AD Connect guide: in a hybrid migration it is the piece taken apart in the source and rebuilt in the target.
Is something missing, or different in your environment? Get in touch and I'll fix it.
Tech Career Lab · newsletter
¿Te ha servido? Cada dos semanas envío una idea práctica para perfiles IT: LinkedIn, proyectos, networking y procesos de selección.Found this useful? Every two weeks I send one practical idea for IT professionals: LinkedIn, projects, networking and hiring processes.
Apúntate y llévate las 33 ideasSign up and get the 33 ideas →