Esecuzione della migrazione

Importante

La migrazione da tenant a tenant è attualmente disponibile in anteprima. Le funzionalità e la disponibilità possono cambiare prima della disponibilità generale.

La migrazione viene eseguita creando un processo di migrazione sotto forma di batch. Gli utenti vengono raggruppati in un batch e inviati insieme. La dimensione massima del batch è di 100 utenti. Le migrazioni vengono gestite tramite API Graph. Queste API possono essere eseguite con PowerShell 5 o 7 o con Graph Explorer.

Informazioni sulla convalida

Poiché esistono molti prerequisiti per la migrazione, è possibile eseguire un passaggio separato quante volte necessario per verificare che tali prerequisiti siano soddisfatti. Questo passaggio è denominato Convalida autonoma e funziona in modo analogo all'esecuzione di un what-if. Verifica tutti i requisiti noti per una corretta migrazione nell'ecosistema di migrazione generale (autorizzazioni delle app, relazioni tra tenant e così via) e a livello di utente (licenze, mapping delle identità e così via). È consigliabile che per ogni batch un amministratore eserciti la convalida prima di inviare la migrazione. Questa azione conferma che tutti i requisiti sono soddisfatti.

L'esecuzione di un batch di convalida comporta una delle seguenti operazioni:

1. Conferma che un batch e i relativi utenti soddisfano tutti i prerequisiti.
2. Elenco di errori risultanti da controlli non riusciti.

Gli amministratori possono esaminare l'elenco per eventuali errori, correggere eventuali problemi e inviare di nuovo usando un nuovo batch per confermare l'esito positivo.

Nota

L'elenco degli errori potrebbe non essere esaustivo. Gli amministratori devono eseguire la convalida e correggere gli errori fino a quando non vengono soddisfatti tutti i prerequisiti e non si verificano errori.

Quando si invia la migrazione, viene eseguito un altro controllo di tutti i prerequisiti, ma non viene restituito un elenco degli errori per ogni carico di lavoro.

Nota

Per un elenco delle diverse fasi e descrizioni dell'elaborazione della migrazione batch, vedere Valori della descrizione della migrazione batch.

Informazioni sul processo di migrazione

La migrazione si verifica a livello di utente, il che significa che se un utente supera la fase di convalida, la migrazione continua. Se un altro utente non esegue alcun controllo di convalida, la migrazione ha esito negativo (e non inizia mai effettivamente). Per eseguire la migrazione di questi utenti non riusciti, creare un nuovo batch che includa gli utenti non riusciti, dopo aver corretto gli errori di convalida. Ripete la migrazione se si è verificato un errore del terminale.

Convalida

Il primo passaggio che viene eseguito è la fase di convalida. In questo passaggio vengono convalidati tutti i passaggi di configurazione necessari. Se i controlli hanno esito negativo, la migrazione non riesce. L'amministratore deve quindi correggere gli errori e inviare di nuovo la migrazione. Per un elenco delle verifiche preliminari, vedere l'articolo Prerequisiti . Questo passaggio include tutti i controlli confermati in Convalida autonoma, ma non restituirà i risultati completi per ogni controllo. Restituisce solo il primo errore riscontrato.

Sincronizzazione delle cassette postali

Dopo che tutti i controlli sono stati superati per i carichi di lavoro applicabili, inizia la sincronizzazione delle cassette postali. La sincronizzazione delle cassette postali significa che in background i dati della cassetta postale dell'utente vengono spostati nel tenant di destinazione. L'utente è ancora in grado di usare completamente la propria cassetta postale nel tenant di origine in questo momento. È consigliabile inviare batch due settimane prima della data di cut-over in quanto non si verifica alcun impatto sugli utenti finali durante la sincronizzazione.

Completa

Al termine dell'ora indicata da CompleteAfterDate e dopo il completamento della sincronizzazione, le cassette postali vengono tagliate al tenant di destinazione. Dopo questo punto, non è possibile effettuare annullamenti. Gli utenti possono accedere alle cassette postali dal tenant di destinazione. Le cassette postali non vengono più visualizzate nel tenant di origine.

Migrazione di Teams e OneDrive

Dopo il cutover della cassetta postale, inizia la migrazione delle chat di Teams, delle riunioni di Teams e dei siti di OneDrive. Le chat e le riunioni vengono migrate nel tenant di destinazione. Gli utenti potrebbero visualizzare le modifiche alle chat di origine quando gli utenti vengono aggiunti o rimossi e le chat e le riunioni iniziano a essere visualizzate nel tenant di destinazione.

Conclusione della migrazione

Dopo la migrazione delle chat di Teams, delle riunioni di Teams e dei siti di OneDrive, la migrazione è stata completata. Gli utenti possono usare gli account tenant di destinazione per usare cassette postali, chat, riunioni e siti di OneDrive.

Informazioni sullo stato e sugli errori della migrazione

Per una suddivisione dei significati dietro gli stati e gli errori, vedere Valori della descrizione della migrazione di Batch.

Si verifica un ritardo di un'ora tra l'esecuzione degli aggiornamenti al gruppo contenente gli utenti autorizzati per la migrazione e l'elaborazione delle modifiche da parte del sistema. Attendere fino a un'ora per avviare la migrazione dopo aver apportato modifiche all'appartenenza al gruppo.

Nota

Per altre indicazioni sulla risoluzione dei problemi, vedere Risolvere gli errori di migrazione orchestrati.

Comandi disponibili per l'esecuzione

Inviare un batch per la convalida

Questa funzionalità consente di inviare un batch di utenti per verificare che i prerequisiti siano soddisfatti prima di inviare una migrazione. Non invia effettivamente la migrazione. Crea un batch che viene eseguito una volta nel contesto di convalida. Per ottenere informazioni su questo batch, recuperare un batch specifico restituisce un elenco completo dei risultati dei controlli eseguiti. Eventuali errori devono essere risolti per una migrazione riuscita in un secondo momento. Ogni batch inviato deve avere un nome univoco. Gli utenti possono appartenere a un solo batch attivo alla volta. La dimensione massima del batch è di 100 utenti.

Esistono due modi per inviare un batch di convalida.

Opzione 1: Definire il corpo della richiesta

body = '{
  "displayName": "xtmigration1",
  "completeAfterDateTime": "2024-12-09T22:48:03.092Z",
  "sourceTenantId": "XXXXX-XXXXX-XXXXXX-XXXXXX",
  "exchangeSettings": {
    "targetDeliveryDomain": "DOMAIN.onmicrosoft.com",
    "sourceEndpoint": "sampleEndpointText"
  },
  "resources": [
    "XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX",
    "XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX",
    "XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX"
  ],
  "resourceType": "Users",
  "workloads": [
    "Teams",
    "Exchange",
    "ODSP",
"Meeting"
  ]
}'
Test-MgBetaCrossTenantMigrationJob -BodyParameter $body 

Opzione 2: Usare i parametri

Test-MgBetaCrossTenantMigrationJob -DisplayName "xtmigration1" -CompleteAfterDateTime 2024-12-09T22:48:03.092Z -Resources @("XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX","XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX", "XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX") -ResourceType Users -SourceTenantId XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX -ExchangeSettings @{SourceEndpoint = "sampleEndpointText"; TargetDeliveryDomain = "DOMAIN.onmicrosoft.com"} 

Inviare un batch per la migrazione

Questa funzionalità consente di inviare un batch di utenti per iniziare la migrazione. È consigliabile eseguire prima invia un batch per la convalida per verificare che tutti i prerequisiti siano sul posto. Ogni batch inviato deve avere un nome univoco. Gli utenti possono appartenere a un solo batch attivo alla volta. La dimensione massima del batch è di 100 utenti.

Esistono due modi per inviare un batch di migrazione.

Opzione 1: Definire il corpo della richiesta

$body = '{
  "displayName": "xtmigration1",
  "completeAfterDateTime": "2024-12-09T22:48:03.092Z",
  "sourceTenantId": "XXXXX-XXXXX-XXXXXX-XXXXXX",
  "exchangeSettings": {
    "targetDeliveryDomain": "DOMAIN.onmicrosoft.com",
    "sourceEndpoint": "sampleEndpointText"
  },
  "resources": [
    "XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX",
    "XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX",
    "XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX"
  ],
  "resourceType": "Users",
  "workloads": [
    "Teams",
    "Exchange",
    "ODSP",
"Meeting"
  ]
}'
New-MgBetaCrossTenantMigrationJob -BodyParameter $body 

Opzione 2: Usare i parametri

New-MgBetaCrossTenantMigrationJob -DisplayName "xtmigration1" -CompleteAfterDateTime 2024-12-09T22:48:03.092Z -Resources @("XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX","XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX", "XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX") -ResourceType Users -SourceTenantId XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX -ExchangeSettings @{SourceEndpoint = "sampleEndpointText"; TargetDeliveryDomain = "DOMAIN.onmicrosoft.com"} 

Recuperare tutti i batch

Questa funzionalità consente di visualizzare tutti i batch inviati. Vengono visualizzati batch di convalida e migrazione. Mostra le migrazioni attive e passate.

Get-MgBetaCrossTenantMigrationJob | ConvertTo-Json

Per impostazione predefinita, vengono visualizzati i 20 risultati più recenti. Per accedere a altro, eseguire il comando con il parametro -All.

Recuperare un batch specifico

Questa funzionalità consente di ricevere informazioni su un batch specifico e sulle relative proprietà.

Get-MgBetaCrossTenantMigrationJob -CrossTenantMigrationJobId <batch display name or job id> | ConvertTo-Json

Per impostazione predefinita, vengono visualizzati i 20 risultati più recenti. Per accedere a altro, eseguire il comando con il parametro (codice) -All.

Recuperare lo stato utente all'interno di un batch specifico

Questa funzionalità consente di ricevere informazioni sugli utenti all'interno di un batch specifico. Viene visualizzato lo stato per ogni carico di lavoro. Le informazioni includono:

• Exchange
• Chat di Teams
• Riunioni di Teams
• OneDrive

Get-MgBetaCrossTenantMigrationJobUser -CrossTenantMigrationJobId <batch display name or job id> -CrossTenantMigrationTaskId <ExternalDirectoryObjectIds for the target users> | ConvertTo-Json -Depth 100

Per impostazione predefinita, vengono visualizzati i 20 risultati più recenti. Per accedere a altro, eseguire il comando con il parametro -All.

Aggiornare la data successiva completa per un batch specifico

Questa funzionalità consente di modificare il completamento dopo la data. Lo spostamento della data determina il push della data meno recente in cui si verificano i cutover per le cassette postali e quando inizia la chat e la riunione di Teams e la migrazione di OneDrive.

Update-MgBetaCrossTenantMigrationJob -CrossTenantMigrationJobId <batch display name or job id> -CompleteAfterDateTime <date time to update to>

I formati di data e ora accettabili sono disponibili in Standard formato di data e ora.

Annullare un batch

Questa funzionalità consente di annullare un intero batch e tutte le migrazioni degli utenti. Annulla tutte le migrazioni per gli utenti le cui cassette postali non sono ancora state ritagliate. Un batch può essere annullato solo prima del completamento dopo la data. Dopo questo punto, la migrazione continua senza annullamento.

Stop-MgBetaCrossTenantMigrationJob -CrossTenantMigrationJobId <batch display name or job id> 

Rimuovere un utente da un batch e annullare la migrazione dell'utente

Questa funzionalità consente di annullare la migrazione di un singolo utente rimuovendoli da tale batch. Deve essere eseguito più volte se è necessario rimuovere più utenti. Gli utenti rimanenti nel batch non sono interessati. Questo stato è possibile solo prima che la cassetta postale dell'utente abbia un cutover, a quel punto l'utente non può essere rimosso.

Stop-MgBetaCrossTenantMigrationJobUser -CrossTenantMigrationJobId <batch display name or job id> -CrossTenantMigrationTaskId  <ExternalDirectoryObjectIds for the target user> 

Se la rimozione ha esito positivo, viene visualizzata una richiesta 202 Accettata con la risposta:

Richiesta di annullamento per l'ID utente: <XXXX-XXXXX-XXXXX-XXXX> da batch: <batch name or batch request ID> è stata accettata.

A questo punto, l'utente viene rimosso dal batch, la migrazione viene annullata e tutte le operazioni di sincronizzazione delle cassette postali eseguite vengono annullate. L'utente può essere aggiunto a un nuovo batch. Nessun altro utente all'interno di tale batch è interessato. Il mapping delle identità non viene modificato affatto.

Se la rimozione non riesce, ecco le possibili risposte:

1. L'ID utente specificato nella richiesta non esiste all'interno del batch specificato. Questo messaggio indica probabilmente che l'amministratore ha fornito un ID utente non corretto e deve controllarlo di nuovo.

   Annullamento non possibile perché non è stata trovata alcuna attività per id <User ID> traceid specificato: <Trace ID>

2. Non è possibile trovare l'ID batch o il nome del batch nel tenant. Questo probabilmente significa che l'amministratore ha fornito un ID batch non corretto o un nome batch nella richiesta di annullamento e deve controllarlo di nuovo.

   UserRequest non trovato con <target tenant ID>, <batch ID or batch name> TraceId: <Trace ID>

3. Se la richiesta di annullamento arriva dopo il completamento specificatoAfterDate passato, la migrazione dell'utente non può essere annullata e non può essere rimossa dal batch.

   L'annullamento non è possibile perché la migrazione ha superato il completamentoDopo la data TraceId: <Trace ID>

4. L'attività utente non è valida, pertanto la migrazione dell'utente non può essere annullata. Ciò significa che esiste un problema fondamentale con la configurazione dell'utente al punto che non viene comunque eseguito all'interno del batch. Un problema come questo potrebbe provenire dall'utente che non è stato mappato all'identità. L'impatto è che l'utente non può essere migrato, anche se tecnicamente appartiene al batch.

   L'annullamento non è possibile perché l'attività non è traceId: <Trace ID>

   Se una rimozione non riesce (ad eccezione di uno stato utente non valido), l'utente continua a appartenere al batch e viene eseguita la migrazione.

Eliminare i dati batch

Questa funzionalità consente di eliminare i dati associati a un batch dal sistema di migrazione. Elimina i dati entro 30 giorni dalla richiesta.

Remove-MgBetaCrossTenantMigrationJob -CrossTenantMigrationJobId <batch display name or job id> 

Solo i batch in uno stato terminale possono essere annullati. Annullare il batch o attendere che tutti gli utenti raggiungano lo stato del terminale Annullato, Non riuscito o Completato.

Nota

L'eliminazione dei dati batch influisce sulle migrazioni future che il batch informerà. Non è consigliabile eliminare i dati batch fino al completamento dell'intera migrazione.

Parametri comuni

Esistono molti parametri che devono essere forniti in un formato specifico per l'input della migrazione:

• displayName : nome batch scelto per identificare questo batch specifico.
• completeAfterDateTime : data che specifica l'ora accettabile meno recente per l'inizio del cutover di Exchange. Non c'è alcun impatto sull'utente fino al termine di questa data e al completamento della sincronizzazione di Exchange. Questa data può essere aggiornata in un secondo momento. I formati di data e ora accettabili sono disponibili in Microsoft Learn.
• sourceTenantId : ID del tenant di origine. Questo ID è disponibile nella Interfaccia di amministrazione di Microsoft Entra.
• targetDeliveryDomain : dominio del tenant di destinazione. Esempio: domain.onmicrosoft.com.
• sourceEndpoint : nome dell'endpoint creato nel tenant di destinazione. È possibile trovarlo usando il Get-MigrationEndpoint comando con il -Name parametro .
• resources : elenco di ExternalDirectoryObjectIds per gli utenti di destinazione inclusi in questo batch. Queste risorse sono disponibili nel portale di Azure sotto l'utente come "ID oggetto" o tramite PowerShell.
• resourceType : è sempre "Utenti" per tutte le migrazioni del contenuto utente.
• carichi di lavoro : stringa con l'elenco dei carichi di lavoro di cui si intende eseguire la migrazione. Queste stringhe devono essere formattate in un elenco delimitato da virgole. Le stringhe appropriate sono:
  • "Exchange"
  • "ODSP"
  • "Teams"
  • "Riunione"

Se non si specifica una stringa, per impostazione predefinita la migrazione sposta tutti e quattro i carichi di lavoro.

Migrazione tramite PowerShell

Connettersi a PowerShell e Microsoft Graph

1. Aprire Microsoft PowerShell.
2. Installare Graph SDK:
   • Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   • Install-Module Microsoft.Graph
3. Accedere con le credenziali di amministratore globale del tenant di destinazione:
   • Connect-Graph
4. Verificare di essere nel tenant corretto:
   • Get-MgContext

Convalidare il batch

Prima di inviare un batch per la migrazione, verificare che il batch e i relativi utenti siano configurati correttamente eseguendo un'attività di convalida.

Vedere l'elenco completo dei prerequisiti controllati durante la convalida: controlli di preconvalida.

Vedere Convalidare il batch per un elenco disponibile di comandi di convalida da eseguire.

Ottenere il report dettagliato degli errori e mitigare tali errori prima di riprovare a livello di batch (vedere Recuperare un batch specifico) e a livello di utente (vedere Recuperare lo stato utente all'interno di un batch specifico).

Esaminare lo stato del batch. Se è ValidatePassed, vengono soddisfatti tutti i prerequisiti ed è possibile continuare a eseguire la migrazione del batch. Se è ValidateFailed, esaminare gli errori e i messaggi. Vedere Risolvere i problemi di migrazione orchestrata. Risolvere questi problemi ed eseguire la convalida in un nuovo batch fino a quando non vengono risolti tutti i problemi e lo stato è ValidatePassed.

Inviare un batch di migrazione

Inviare il batch dopo l'esito positivo del batch di convalida. Usando un nuovo nome batch, inviare il batch: Inviare un batch di migrazione.

Monitorare regolarmente la migrazione a livello di batch: recuperare un batch specifico e a livello di utente: Recuperare lo stato utente all'interno di un batch specifico.

Per comprendere lo stato di avanzamento, vedere la tabella dei valori di descrizione della migrazione batch.

In caso di errori, esaminare gli errori e i messaggi restituiti negli oggetti utente: Risolvere i problemi di migrazione orchestrata. Seguire le indicazioni per la risoluzione dei problemi per attenuare eventuali problemi e riprovare, iniziando di nuovo con la convalida.

Al termine della migrazione

Al termine della migrazione, è possibile monitorare i risultati degli stati del batch e dell'utente. Se le migrazioni non sono riuscite, esaminare il codice di errore e il messaggio per eventuali istruzioni di ripetizione dei tentativi. Quando gli utenti raggiungono lo stato del terminale "Annullato" o "Non riuscito", possono essere aggiunti a un nuovo batch da ritentarsi.

Apportare le modifiche necessarie

Se è necessario apportare modifiche alla migrazione, ad esempio la modifica della data di completamento, la rimozione di un utente da un batch o l'annullamento di una migrazione, questa operazione può essere eseguita fino a un determinato punto della migrazione, come definito nella tabella di stato del batch.

Valori della descrizione della migrazione batch

Usare la tabella seguente per comprendere i flussi di convalida e migrazione e i valori di stato:

Nota

Per altre informazioni sulla risoluzione dei problemi, vedere Risolvere i problemi relativi alla migrazione orchestrata.

Batch di migrazione

Stato	Descrizione	Carichi di lavoro
Inviato/Approvato/Elaborazione	Il batch viene inviato.	[Exchange] NotStarted [Chat di Teams] NotStarted [Riunioni di Teams] NotStarted [OneDrive] NotStarted
Inprogress	Il batch è in corso, che include il controllo dei prerequisiti per tutti i carichi di lavoro e l'elaborazione della sincronizzazione per le cassette postali. I batch e le migrazioni degli utenti possono essere annullati durante questa fase.	[Exchange] Sincronizzato/Finalizzato/Completato [Chat di Teams] Sincronizzato/InProgress [Riunioni di Teams] Sincronizzato/InProgress [OneDrive] Sincronizzato/InProgress
CuttingOver	Il batch sta tagliando, il che significa che la cassetta postale sta tagliando o ha tagliato e le chat, le riunioni e OneDrive stanno eseguendo la migrazione. A questo punto non possono verificarsi annullamenti.	[Exchange] Sincronizzato/Finalizzato/Completato [Chat di Teams] Sincronizzato/InProgress [Riunioni di Teams] Sincronizzato/InProgress [OneDrive] Sincronizzato/InProgress
Completata	Il batch è stato completato senza errori.	[Exchange] Completato [Chat di Teams] Completato [Riunioni di Teams] Completato [OneDrive] Completato
CompletedWithErrors	Il batch è stato completato, ma con errori.	[Exchange] Completato/Non riuscito [Chat di Teams] Completato/Non riuscito [Riunioni di Teams] Completato/Non riuscito [OneDrive] Completato/Non riuscito
Annullato	Il batch viene annullato.
Esito negativo	Il batch non è riuscito.
PendingCancel	Il batch è in sospeso.
PendingDelete	Il batch è in sospeso.
Eliminato	I dati del batch vengono eliminati.

Batch di convalida

Stato	Descrizione	Carichi di lavoro
ValidationSubmitted/ValidationProcessing	Il batch di convalida è stato inviato.	[Exchange] NotStarted [Chat di Teams] NotStarted [Riunioni di Teams] NotStarted [OneDrive] NotStarted
ValidateInProgress	Il batch di convalida è in corso. Tutti i carichi di lavoro applicabili vengono controllati per i prerequisiti.	[Exchange] Inprogress [Chat di Teams] InProgress/Completed [Riunioni di Teams] InProgress/Completed [OneDrive] InProgress/Completed
ValidatePassed/ValidateFailed	Il batch di convalida è stato completato. Il batch è stato superato (nessun controllo non è riuscito) o non è riuscito (almeno un controllo non è riuscito).	[Exchange] Completato/Non riuscito [Chat di Teams] Completato/Non riuscito [Riunioni di Teams] Completato/Non riuscito [OneDrive] Completato/Non riuscito

Passaggi successivi

Per informazioni sulle operazioni da eseguire al termine della migrazione, vedere Attività di post-migrazione per le migrazioni da tenant a tenant.

Per domande frequenti e risoluzione dei problemi relativi all'agente di orchestrazione della migrazione, vedere Domande frequenti sull'agente di orchestrazione della migrazione.