Migrazioni da tenant a tenant

La funzionalità di migrazione da tenant a tenant consente di trasferire un ambiente da un tenant a un altro. Questa funzionalità supporta scenari come l'unione di più tenant in uno e la facilitazione delle acquisizioni di società. L'ambiente non viene spostato, ma è collegato a un altro tenant. L'ambiente esiste ancora ma non fa più parte del tenant di origine. È accessibile e gestito dal tenant di destinazione. Non ci sono modifiche dell'interfaccia o della versione che fanno parte di questo spostamento.

Prima di iniziare

Prima di iniziare con una migrazione da tenant a tenant, tieni presente le note seguenti.

• Tipi di ambiente supportati: solo produzione e sandbox.
• Tipi di ambiente non supportati: i tipi di ambiente predefiniti, per sviluppatori, di valutazione e Teams non sono supportati. Government Community Cloud (GCC) nei cloud pubblici e viceversa non sono supportati.
• I componenti non supportati includono Dynamics 365 Customer Voice, Multicanale per Customer Service, libreria dei componenti, Dynamics 365 Customer Insights - Journeys e Dynamics 365 Customer Insights - Data.
• Nei passaggi di pre-migrazione e post-migrazione sono necessari passaggi specifici per Power Apps, Power Automate, Power Pages e Microsoft Copilot Studio.
• Non è possibile eseguire la migrazione di un'organizzazione Dataverse collegata a un'organizzazione per la finanza e le operazioni a un tenant diverso.
• Potrebbe essere necessario riconfigurare alcune applicazioni e impostazioni dopo la migrazione da tenant a tenant quali Microsoft Dynamics 365 for Outlook, la sincronizzazione lato server, SharePoint e altri.
• Dopo aver creato e configurato gli utenti, è necessario creare un file di mapping utente, descritto più avanti in questo articolo.
• Se l'utente mappato dispone di una cassetta postale nel tenant di destinazione, la cassetta postale viene automaticamente configurata durante la migrazione. Per tutti gli altri utenti, sarà necessario riconfigurare la cassetta postale.
• Se viene utilizzata la stessa cassetta postale nel tenant di destinazione test@microsoft.com, la cassetta postale è usata per impostazione predefinita. Prima della migrazione da tenant a tenant, i clienti devono migrare e configurare le proprie cassette postali nel tenant di destinazione.
• Se si usa il dominio predefinito onmicrosoft, test@sourcecompanyname.onmicrosoft.com, il nome di dominio post-migrazione viene modificato in test@targetcompanyname.onmicrosoft.com. I clienti devono riconfigurare la cassetta postale. Ulteriori informazioni sulla configurazione della cassetta postale in Connettersi a Exchange Online.

Prerequisiti

Assicurati di completare i seguenti prerequisiti prima di iniziare il processo di migrazione.

• Creare utenti nel tenant di destinazione, tra cui:
  • Creare utenti in Microsoft 365 e Microsoft Entra ID.
  • Assegnare le licenze.
• Per eseguire la migrazione devi disporre dei privilegi di amministratore di Power Platform o di amministratore Dynamics 365.
• Il modulo PowerShell per amministratori Power Platform è il modulo PowerShell consigliato per l'interazione con le funzionalità di amministrazione. Ulteriori informazioni in Introduzione a PowerShell per gli amministratori di Power Platform.

Processo di preparazione

Completare le procedure seguenti per Power Automate, Power Apps, Copilot Studio e Power Pages prima della migrazione. È inoltre necessario creare un file di mapping utente.

Preparazione Power Automate

Se i flussi sono già definiti in Dataverse, non è necessario alcun lavoro aggiuntivo.

Le definizioni di tutti i flussi Power Automate di cui è necessario eseguire la migrazione devono essere aggiunte alle soluzioni Dataverse nell'ambiente di origine. Ulteriori informazioni in Aggiunta di un flusso cloud esistente in una soluzione. Questa operazione può essere eseguita in blocco eseguendo il cmdlet Add-AdminFlowsToSolution.

Preparazione Power Apps

Qualsiasi Power Apps deve essere esportato manualmente. Non supportiamo la migrazione di connettori, connessioni o gateway del cliente. Se hai configurato uno di questi componenti, è necessario riconfigurarli manualmente dopo la migrazione.

Per le app che supportano la soluzione:

1. Per le app che sono consapevoli della soluzione, vai a Power Apps, accedi alla pagina Soluzioni ed esporta tutte le app e le soluzioni. Puoi esportarli singolarmente o raggrupparli in un'unica soluzione, se non lo sono già.

2. Elimina queste app che supportano la soluzione nell'ambiente dopo averle esportate.

3. Le app appartenenti alle soluzioni gestite possono essere eliminate solo eliminando la soluzione.

4. Le app che si trovano in una soluzione non gestita possono essere eliminate utilizzando l'opzione Elimina da questo ambiente.

   Importante

   Le app canvas che supportano la soluzione, le pagine personalizzate o le librerie dei componenti che non elimini da un ambiente prima della migrazione non funzioneranno al termine della migrazione.

Per le app che non supportano la soluzione:

1. Vai a Power Apps, quindi seleziona App.

2. Per ogni app che vuoi spostare, seleziona Altri comandi, quindi seleziona Esporta pacchetto (anteprima).

3. Inserisci i dettagli richiesti per eseguire l'esportazione dell'app, quindi seleziona Esporta. Una volta completata l'esportazione, dovrebbe iniziare il download.

   Il file risultante contiene il pacchetto dell'app selezionato.

4. Ripeti questi passaggi fino a quando tutte le app non sono state esportate.

5. Elimina dall'ambiente queste app che non riconoscono la soluzione

Un amministratore può anche visualizzare o eliminare le app canvas dall'elenco nel portale di amministrazione completando i passaggi seguenti.

1. Vai a Interfaccia di amministrazione di Power Platform quindi seleziona l'ambiente da Gestisci.
2. Nell'azione Risorse, seleziona Power Apps per visualizzarle ed eliminarle.

Preparazione Copilot Studio

Qualsiasi chabot Copilot Studio deve essere esportato manualmente. Alcuni componenti dipendenti dei chatbot devono essere riconfigurati manualmente durante o dopo la migrazione. Ad esempio connessioni, variabili di ambiente e connettori personalizzati devono essere riconfigurati manualmente durante o dopo la migrazione.

I chabot riconoscono le soluzioni. Vai a Power Apps, accedi alla pagina Soluzioni, esporta tutte le soluzioni chatbot, individualmente o raggruppandole in una soluzione singola. Ulteriori informazioni in Esportare e importare bot utilizzando soluzioni.

Preparazione Power Pages

I seguenti passaggi devono essere eseguiti per ogni sito Web in un ambiente.

1. Accedi all'ambiente.
2. Apri l'interfaccia di amministrazione.
3. Elimina il sito Web.

Creare un file di mapping utente

Crea un file di mapping utente per l'ambiente di origine da trasferire all'ambiente di destinazione. È essenziale notare che ogni ambiente richiede un proprio file di mapping. Assicurarsi che gli utenti siano presenti e autorizzati sia nel tenant di origine che in quello di destinazione, poiché ciò è necessario per una migrazione corretta. I domini degli utenti possono variare tra origine e destinazione, purché siano attivi.

1. Creare un file di mapping utente denominato usermapping.csv.

   Nota

   Il nome del file fa distinzione tra maiuscole e minuscole. Assicurati che i record siano separati da una virgola e non da un punto e virgola.

2. Registra con precisione i dettagli degli utenti, inclusi gli ID e-mail di origine e destinazione. Assicurati che non ci siano spazi aggiuntivi prima e dopo l'intestazione. Il file di mapping devono avere il seguente aspetto:

   Source	Destinazione
   SourceUser@sourcetenant.com	DestinationUser@targettenant.com

Per gli utenti con accesso completo:

1. Accedi all'ambiente di origine.

2. Utilizzare Ricerca avanzata per cercare gli utenti.

3. Seleziona Usa visualizzazione salvata > Utenti accesso completo, quindi seleziona Modifica colonne.

4. Rimuovi tutte le colonne tranne la colonna Nome completo.

5. Seleziona Aggiungi colonne > Windows Live ID.

6. Seleziona OK > Risultati per visualizzare l'elenco degli utenti con accesso completo.

7. Seleziona tutti i record, seleziona Esporta utenti nella barra multifunzione, quindi scegli Foglio di lavoro statico.

8. Segui i passaggi 1-7 precedenti per il tenant di destinazione, se possibile. Ora dovresti avere due fogli Excel separati, uno per il target di origine e uno per quello di destinazione.

9. Apri i file Excel per la modifica.

10. Partendo dal foglio Excel di origine, copia i record sotto la colonna Windows Live ID nel Blocco note. Non copiare l'intestazione.

11. Salva il file nel Blocco note.

12. Immetti il Windows Live ID (UPN) di destinazione nello stesso documento del Blocco note a destra dell'UPN di origine corrispondente. Assicurarsi di separare gli UPN di origine da quelli di destinazione con una virgola (,).

    Esempio:

    • user001@source.com, user001@destination.com
    • user002@source.com, user002@destination.com
    • user003@source.com, user003@destination.com

13. Salvare il file in formato CSV.

Per gli utenti con accesso amministrativo:

1. Accedi all'ambiente di origine.
2. Utilizzare Ricerca avanzata per cercare gli utenti.
3. Seleziona Usa visualizzazione salvata > Utenti accesso amministrativo, quindi seleziona Risultati per visualizzare l'elenco degli utenti con accesso amministrativo.
4. Se decidi di non includere nessuno di questi utenti, salta i passaggi seguenti. In caso contrario, per includere questi utenti nel file di mapping, effettuare le seguenti operazioni:
   1. Trova gli utenti corrispondenti nel tenant di destinazione.
   2. Assicurati che una licenza valida sia assegnata all'utente di destinazione nel tenant di destinazione.

      Nota

      Se all'utente di destinazione non viene assegnata alcuna licenza, la migrazione avrà esito negativo.

   3. Salva il file CSV che ha mappati sia gli utenti con accesso completo che gli utenti con accesso amministrativo.

Migrazione

Prima di procedere con la migrazione, assicurati di aver esaminato e completato il processo di preparazione. Dopo aver completato il processo di preparazione, completa le seguenti sezioni per eseguire la migrazione.

Installazione PowerShell per gli amministratori Power Platform (amministratori di origine e di destinazione)

Il modulo PowerShell per amministratori Power Platform è il modulo PowerShell consigliato per l'interazione con le funzionalità di amministrazione. Per informazioni utili per iniziare a utilizzare il modulo PowerShell per amministratori di Power Platform, vedi Introduzione a PowerShell per amministratori di Power Platform e Installazione di PowerShell per amministratori di Power Platform.

Installare o aggiornare il modulo necessario utilizzando uno dei seguenti comandi:

Install-Module -Name Microsoft.PowerApps.Administration.PowerShell
Update-Module -Name Microsoft.PowerApps.Administration.PowerShell

Installare Azure PowerShell in Windows (amministratori di origine e di destinazione)

Il modulo Azure PowerShell è un modulo cumulativo. L'installazione del modulo Azure PowerShell consente di scaricare i moduli generalmente disponibili e di rendere disponibili per l'uso i relativi cmdlet. Ulteriori informazioni in Installare Azure PowerShell in Windows.

Utilizzare il cmdlet Install-Module per installare il modulo Azure PowerShell:

Install-Module -Name Az -Repository PSGallery -Force

Accedi a Microsoft Power Platform (amministratori di origine e di destinazione)

Accedi a Microsoft Power Platform. Questo passaggio consente agli amministratori di autenticarsi e accedere all'ambiente Power Platform.

Add-PowerAppsAccount

Inviare una richiesta di migrazione (amministratore di origine)

Per avviare una migrazione da tenant a tenant, l'amministratore del tenant di origine di Dynamics 365 o Power Platform deve inviare una richiesta al tenant di destinazione usando il comando seguente e specificare l'ID del nome dell'ambiente e l'ID del tenant.

Per completare questo passaggio, devi disporre delle credenziali di amministratore Power Platform o Dynamics 365.

TenantToTenant-SubmitMigrationRequest –EnvironmentName {EnvironmentId} -TargetTenantID {TenantID}

Puoi visualizzare lo stato e MigrationID utilizzando il comando seguente.

TenantToTenant-ViewMigrationRequest

Visualizzazione e approvazione della richiesta di migrazione (amministratore di destinazione)

L'amministratore del tenant di destinazione deve eseguire il comando seguente per visualizzare tutte le richieste di migrazione e lo stato. L'amministratore può esaminare tutte le richieste di migrazione e le opzioni da approvare o rifiutare.

Add-PowerAppsAccount

TenantToTenant-ViewApprovalRequest

TenantToTenant-ManageMigrationRequest -MigrationId {MigrationId from above command to approve or deny}

Dopo l'approvazione di una richiesta, l'amministratore del tenant di destinazione può inviare una notifica all'amministratore del tenant di origine affinché proceda con il passaggio successivo della migrazione.

Generare un URL di firma di accesso condiviso (amministratore di origine)

Questo passaggio prevede la creazione dell'URL di firma di accesso condiviso, che viene utilizzato in seguito per caricare il file di mapping utente. Esegui il seguente comando PowerShell, sostituendo EnvironmentId con l'ID dell'ambiente effettivo.

GenerateResourceStorage-PowerAppEnvironment –EnvironmentName {EnvironmentId}

Output di esempio

Code        :
Description :
Headers     :
Error       :
Errors      :
Internal    : @{sharedAccessSignature=https://dynamics.blob.core.windows.net/20240604t000000z73e18df430fe40059290dsddc25d783?sv=2018-03-28&sr=c&si=SASpolicyXXRRRX}

Carica il file di mapping utente (amministratore di origine)

Il passaggio successivo prevede il trasferimento del file di mapping utente all'URL di firma di accesso condiviso stabilito in precedenza. A tale scopo, esegui i seguenti comandi in Windows PowerShell ISE, assicurandoti che i parametri SASUri e FileToUpload contengano le informazioni appropriate sull'ambiente in uso. Questo passaggio è fondamentale per caricare la mappatura degli utenti in modo accurato nel sistema.

$SASUri ="Update the SAS Uri from previous step”
$Uri = [System.Uri] $SASUri
 
$storageAccountName = $uri.DnsSafeHost.Split(".")[0]
$container = $uri.LocalPath.Substring(1)
$sasToken = $uri.Query
 
# File to upload
# Note that the file name should be usermapping.csv (case sensitive) with comma separated values.
$fileToUpload = 'C:\filelocation\usermapping.csv'
 
# Create a storage context
$storageContext = New-AzStorageContext -StorageAccountName $storageAccountName -SasToken $sasToken
 
# Upload the file to Azure Blob Storage
Set-AzStorageBlobContent -File $fileToUpload -Container $container -Context $storageContext -Force

Preparare la migrazione dell'ambiente (amministratore di origine)

Il passaggio seguente prevede l'esecuzione di convalide complete per garantire che ogni utente elencato nel file di mapping utente sia verificato e attualmente attivo nel tenant di destinazione.

MigrationId può essere visualizzato usando il comando "TenantToTenant-ViewMigrationRequest" nel tenant di origine.

TenantToTenant-PrepareMigration 
-MigrationId {MigrationId} 
-TargetTenantId {TargetTenantId} 
-ReadOnlyUserMappingFileContainerUri {SasUri}

Output di esempio

Code        : 202
Description : Accepted

La durata di questo passaggio varia a seconda del numero di utenti nel file di mapping utente. Puoi monitorare lo stato di avanzamento di questo passaggio usando il comando TenantToTenant-GetStatus, fornito di seguito.

Controllare lo stato (amministratore dell'origine)

TenantToTenant-GetMigrationStatus -MigrationId {MigrationId}

Output di esempio

• Convalida migrazione da tenant a tenant: esecuzione
• Convalida migrazione da tenant a tenant: completata
• Convalida non riuscita. Gli errori vengono aggiornati nell'archiviazione BLOB qui: SASURI

Errori e come risolverli

• Se viene visualizzato un messaggio di errore che indica Il file di mapping dell'utente specificato per la migrazione da tenant a tenant non è valido, verificare che il nome del file di mapping utente sia corretto e che il file di mapping utente contenga una virgola per separare i valori.
• I "{numeri di riga}" hanno lo stesso "{emailID}: assicurati che non ci siano voci duplicate.
• Formato e-mail non valido "{emailid}": assicurati che il formato dell'e-mail sia corretto per testuser@tenantdomain.com.
• La destinazione sul "{linenumber}" della riga è uguale all'ID e-mail di origine: assicurati che l'e-mail di destinazione sia diversa dall'e-mail di origine.
• Ogni riga deve avere esattamente due colonne: "{numeri di riga}": assicurati che ogni riga abbia solo due colonne: la colonna di origine e la colonna di destinazione. Rimuovi eventuali virgole extra.

Dopo aver corretto gli errori di mapping utente, è necessario ricaricare il file di mapping utente utilizzando lo stesso URI di firma di accesso condiviso.

Scaricare il report degli errori (amministratore di origine)

Se sono presenti errori nel file di mapping utente, è disponibile un'opzione per scaricare un rapporto sugli errori. Questa operazione può essere eseguita copiando e incollando direttamente l'oggetto SasUrl fornito nel comando Tenant-To-Tenant-GetMigrationStatus oppure usando i comandi seguenti che usano l'URI di firma di accesso condiviso del passaggio precedente: controllare lo stato e la posizione desiderata per scaricare la segnalazione degli errori.

Effettuare i seguenti passaggi.

1. Esegui il comando seguente con Windows PowerShell ISE.

   Import-Module Az.Storage 
   # Define the SAS URI of the blob
   $sasUri = " Update the SAS Uri from previous step "
   # Define the path where the blob will be downloaded
   $destinationPath = "C:\Downloads\Failed\"
   # Split the SAS URI on the '?' character to separate the URL and the SAS token
   $url, $sasToken = $sasUri -split '\?', 2
   $containerName = $url.Split('/')[3]
   $storageAccountName = $url.Split('/')[2].Split('.')[0]
   $storageContext = New-AzStorageContext -StorageAccountName $storageAccountName -SasToken $sasToken
   Get-AzStorageBlobContent -Blob "usermapping.csv" -Container $containerName -Destination $destinationPath -Context $storageContext 
   

2. Risolvi i problemi nel file di mapping utente.

3. Ricarica il file seguendo la procedura descritta in [Caricare il file di mapping utente (amministratore di origine)](#upload-the-user-mapping-file-(source-admin).

Dopo aver completato con successo la procedura Preparare la migrazione dell'ambiente (amministratore di origine), è possibile procedere con la procedura Migrazione dell'ambiente (amministratore di origine) per migrare l'ambiente. Eseguire la migrazione entro i prossimi sette giorni. Se non completi la migrazione nei prossimi sette giorni, devi ricominciare con la procedura Preparare la migrazione dell'ambiente (amministratore di origine).

Eseguire la migrazione dell'ambiente (amministratore di origine)

MigrationId può essere visualizzato usando il comandoTenantToTenant-ViewMigrationRequest nel tenant di origine.

TenantToTenant-MigratePowerAppEnvironment
-MigrationId {MigrationId}
-TargetTenantId {TargetTenantId}

Recuperare lo stato (amministratore dell'origine)

TenantToTenant-GetMigrationStatus -EnvironmentName {EnvironmentId}

Output di esempio

• Migrare un ambiente: esecuzione
• Migrazione dell'ambiente: riuscita

Processo dopo la migrazione

Dopo aver spostato gli ambienti in un altro tenant:

• L'URL dell'ambiente, l'ID organizzazione (OrgID) e il nome non cambiano.
• L'ambiente di origine non ha Dataverse.
• Gli utenti non inclusi nel file di mapping non verranno migrati e mappati dopo la migrazione.

Completare le seguenti procedure per Power Automate, Power Apps, Copilot Studio, Power Pages.

Processo dopo la migrazione per Power Automate

Al termine della migrazione, esamina la sezione componenti da esaminare come elenco di controllo per modificare e attivare i flussi e gli altri componenti. I passaggi chiave sono:

1. Creare connessioni per tutti i riferimenti a una connessione.
2. Avvia tutti i flussi, incluso l'avvio dei flussi figlio prima dei flussi padre.
3. Per tutti i flussi attivati da HTTP, recuperare il nuovo URL e inserirlo in tutte le app o i flussi chiamanti per aggiornare i riferimenti.

Processo dopo la migrazione per Power Apps

Per le app che supportano la soluzione:

1. Seleziona il nuovo ambiente da Power Apps e vai alla pagina Soluzioni.
2. Seleziona Importa e usa il selettore di file per selezionare i pacchetti esportati nel passaggio precedente.
3. Conferma che l'importazione sia stata completata correttamente controllando il contenuto della soluzione nell'ambiente di migrazione.

Per le app che non supportano la soluzione:

1. Vai a Power Apps.
2. Seleziona il nuovo ambiente dall'elenco a discesa Ambiente.
3. Seleziona App.
4. Seleziona Importa app canvas.
5. Carica il file di pacchetto dell'app.
6. Completa tutte le selezioni delle opzioni di importazione, quindi seleziona Importa.
7. Ripeti questi passaggi fino a quando tutte le app non sono state importate.

Processo dopo la migrazione per Copilot Studio

1. Seleziona il nuovo ambiente da Power Apps e vai alla pagina Soluzioni.
2. Seleziona Importa e usa il selettore di file per selezionare i pacchetti esportati nel passaggio precedente.
3. Conferma che l'importazione sia stata completata correttamente controllando il contenuto della soluzione nell'ambiente di migrazione.

Processo dopo la migrazione per Power Pages

I passaggi seguenti devono essere completati per ogni sito Web nell'ambiente.

1. Accedi all'ambiente.
2. Apri l'interfaccia di amministrazione.
3. Esegui il provisioning del sito Web con lo stesso tipo di portale e la stessa lingua.

Dopo aver completato tutti i passaggi precedenti e la migrazione, puoi convalidare l'ambiente nel tenant di destinazione e successivamente eliminare l'ambiente di origine nell'interfaccia di amministrazione di Power Platform.

Domande frequenti

Le operazioni in background sono abilitate durante la migrazione da tenant a tenant? La modalità di amministrazione è abilitata durante la migrazione da tenant a tenant, pertanto le operazioni in background non vengono eseguite. Ulteriori informazioni in Modalità amministrazione.

Possiamo eseguire la migrazione di tutti gli utenti dell'organizzazione Dataverse? Possiamo migrare tutti gli utenti dell'organizzazione Dataverse solo se gli utenti esistono nel tenant di destinazione. Ad esempio:

user001@source.com, user001@destination.comuser002@source.com, user002@destination.com