Migraciones de inquilino a inquilino

La característica de migración de inquilino a inquilino le permite transferir un entorno de un inquilino a otro. Esta característica admite escenarios como la combinación de varios inquilinos en uno y la facilitación de las adquisiciones de empresas. En realidad , el entorno no se mueve, sino que está vinculado a otro inquilino. El entorno aún existe, pero ya no está bajo el inquilino de origen. Está disponible para el inquilino de destino, quien lo administra. No hay cambios de la interfaz de usuario o los cambios en la versión como parte de este traslado.

Antes de empezar

Tenga en cuenta las siguientes notas antes de comenzar con una migración de inquilino a inquilino.

• Tipos de entornos compatibles: solo producción y espacio aislado.
• Tipos de entorno no compatibles: los tipos de entorno predeterminado, desarrollador, de prueba y de Teams no son compatibles. No se admite Government Community Cloud (GCC) a nubes públicas y viceversa.
• Los componentes no admitidos incluyen Dynamics 365 Customer Voice, Plataforma omnicanal para Customer Service, biblioteca de componentes, Dynamics 365 Customer Insights - Journeys y Dynamics 365 Customer Insights - Data.
• Hay pasos específicos necesarios para Power Apps, Power Automate, Power Pages, y Microsoft Copilot Studio mencionados en los pasos previos y posteriores a la migración.
• Una organización de Dataverse vinculada a una organización de finanzas y operaciones no se puede migrar a otro inquilino.
• Quizá deba reconfigurar algunas aplicaciones y valores después de una migración de inquilino a inquilino como Microsoft Dynamics 365 for Outlook, sincronización del lado del servidor, SharePoint y otros.
• Una vez creados y configurados los usuarios, debe crear un archivo de asignación de usuarios, que se describe más adelante en este artículo.
• Si el usuario asignado tiene un buzón de correo en el inquilino de destino, el buzón de correo se configura automáticamente durante la migración. Para todos los demás usuarios, deberá volver a configurar el buzón.
• Si se usa el mismo buzón en el inquilino de destino test@microsoft.com, el buzón se usa de manera predeterminada. Antes de la migración de inquilino a inquilino, los clientes deben migrar y configurar sus buzones en el inquilino de destino.
• Si está utilizando el dominio onmicrosoft predeterminado, test@sourcecompanyname.onmicrosoft.com, el nombre de dominio posterior a la migración se cambia a test@targetcompanyname.onmicrosoft.com. Los clientes deben reconfigurar el buzón. Más información sobre configurar el buzón en Conectar a Exchange Online.

Requisitos previos

Asegúrese de completar los siguientes requisitos previos antes de comenzar el proceso de migración.

• Cree usuarios en el inquilino de destino, incluidos:
  • Crear usuarios en Microsoft 365 y Microsoft Entra ID.
  • Asignación de licencias.
• Debe tener privilegios de administrador de Power Platform o administrador Dynamics 365 para realizar la migración.
• El PowerShell para el módulo de administradores de Power Platform es el módulo de PowerShell recomendado para interactuar con las capacidades de administrador. Para obtener más información, consulte Introducción a PowerShell para administradores de Power Platform.

Proceso de preparación

Complete los siguientes procedimientos para Power Automate, Power Apps, Copilot Studio, y Power Pages antes de la migración. También debe crear un archivo de asignación de usuarios.

Preparación Power Automate

Si sus flujos ya están definidos en Dataverse, no se requiere ningún trabajo adicional.

Cualquier flujo de Power Automate que se deba migrar debe tener sus definiciones agregadas a soluciones de Dataverse en el entorno de origen. Más información en Agregar un flujo de nube existente a una solución. Esto se puede hacer de forma masiva mediante la ejecución del cmdlet Add-AdminFlowsToSolution.

Preparación Power Apps

Cualquier Power Apps debe exportarse manualmente. No admitimos la migración de conectores, conexiones o puertas de enlace del cliente. Si ha configurado alguno de estos componentes, debe volver a configurarlos manualmente después de la migración.

Para aplicaciones compatibles con soluciones:

1. Para las aplicaciones que son conscientes de la solución, vaya a Power Apps, navegue a la página Soluciones y exporte todas las aplicaciones y soluciones. Puede exportarlos individualmente o agruparlos en una sola solución, si aún no lo están.

2. Elimine estas aplicaciones compatibles con la solución en el entorno después de exportarlas.

3. Las aplicaciones que pertenecen a soluciones administradas solo se pueden eliminar eliminando la solución.

4. Las aplicaciones que se encuentran en una solución no administrada se pueden eliminar mediante la opción Eliminar de este entorno.

   Importante

   Las aplicaciones de lienzo con reconocimiento de soluciones, las páginas personalizadas o las bibliotecas de componentes que no elimine de un entorno antes de la migración no funcionarán una vez que se complete la migración.

Para las aplicaciones que no son compatibles con las soluciones:

1. Vaya a Power Apps y seleccione Aplicaciones.

2. Para cada aplicación que desee mover, seleccione Más comandos y luego seleccione Exportar paquete (vista previa).

3. Introduzca los detalles necesarios para realizar la exportación de la aplicación y luego seleccione Exportar. Una vez que se complete la exportación, debería comenzar una descarga.

   El archivo resultante contiene el paquete de la aplicación que se seleccionó.

4. Repita estos pasos hasta que se hayan exportado todas las aplicaciones.

5. Elimine del entorno estas aplicaciones que no reconocen soluciones

Un administrador también puede ver o eliminar aplicaciones lienzo de la lista en el portal de administración completando los siguientes pasos.

1. Vaya al Centro de administración de Power Platform y seleccione el entorno en Administrar.
2. En la acción Recursos, seleccione Power Apps para verlos y eliminarlos.

Preparación Copilot Studio

Cualquier bot de chat de Copilot Studio debe exportarse manualmente. Algunos componentes dependientes de los bots de chat deben reconfigurarse manualmente durante o después de la migración. Los componentes dependientes de algunos chatbots deben reconfigurarse manualmente durante o después de la migración, por ejemplo, conexiones, variables de entorno, conectores personalizados.

Los bots de chat son compatibles con las soluciones. Vaya a Power Apps, navegue a la página Soluciones y exporte todas las soluciones de bot de chat (ya sea individualmente o agrúpelas en una sola solución si aún no lo están). Más información en Exportación e importación de bots mediante soluciones.

Preparación Power Pages

Se deben realizar los siguientes pasos para cada sitio web en un entorno.

1. Inicie sesión en el entorno.
2. Abra el Centro de Administración.
3. Eliminar el sitio web.

Crear un archivo de asignación de usuarios

Cree un archivo de asignación de usuarios para que el entorno de origen se transfiera al entorno de destino. Es esencial tener en cuenta que cada entorno requiere un archivo de asignación individual. Asegúrese de que los usuarios estén presentes y autorizados tanto en el inquilino de origen como en el de destino, ya que esto es necesario para que la migración se realice correctamente. Los dominios de los usuarios pueden variar entre el origen y el destino, siempre que estén activos.

1. Cree un archivo de asignación de usuarios denominado usermapping.csv.

   Nota

   El nombre del archivo distingue entre mayúsculas y minúsculas. Asegúrese de que los registros estén separados por una coma, no por un punto y coma.

2. Registre con precisión los detalles de los usuarios, incluidos sus ID de correo electrónico de origen y destino. Asegúrese de que no haya espacios adicionales antes y después del encabezado. Su archivo de asignación debería ser similar al mostrado en el siguiente ejemplo:

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

Para usuarios de acceso total:

1. Acceda al entorno de origen.

2. Utilice la Búsqueda avanzada para buscar usuarios.

3. Seleccione Usar vista guardada > Usuarios con acceso completo y luego seleccione Editar columnas.

4. Eliminar todas las columnas excepto la columna Nombre completo.

5. Seleccione Agregar columnas > Windows Live ID.

6. Seleccione OK > Resultados para ver la lista de usuarios con acceso completo.

7. Seleccione todos los registros, seleccione Exportar usuarios en la cinta y luego elija Hoja de trabajo estática.

8. Siga los pasos 1 a 7 anteriores para el inquilino de destino, si es posible. Ahora debería tener dos hojas de Excel independientes: una para el origen y otra para el inquilino de destino.

9. Abra los archivos de Excel para editarlos.

10. Comenzando con la hoja de origen de Excel, copie los registros debajo de la columna Windows Live ID en el Bloc de notas. No copie el encabezado.

11. Guarde el archivo del bloc de notas.

12. Ingrese el Windows Live ID (UPN) de destino en el mismo documento del Bloc de notas a la derecha del UPN de origen correspondiente. Asegúrese de separar los UPN de origen y de destino con una coma (,).

    Ejemplo:

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

13. Guarde el archivo como CSV.

Para usuarios con acceso administrativo:

1. Acceda al entorno de origen.
2. Utilice la Búsqueda avanzada para buscar usuarios.
3. Seleccione Usar vista guardada > Usuarios con acceso administrativo y luego seleccione Resultados para ver la lista de usuarios con acceso administrativo.
4. Si decide no incluir a ninguno de estos usuarios, omita los siguientes pasos. De lo contrario, para incluir a estos usuarios en el archivo de asignación, haga lo siguiente:
   1. Busque los usuarios correspondientes en el inquilino de destino.
   2. Asegúrese de que se asigne una licencia válida al usuario de destino en el inquilino de destino.

      Nota

      Si al usuario de destino no se le asigna ninguna licencia, la migración fallará.

   3. Guarde el archivo CSV que tiene asignados tanto los usuarios de acceso completo como los usuarios de acceso administrativo.

Migración

Antes de continuar con la migración, asegúrese de haber revisado y completado el proceso de preparación. Una vez que haya completado el proceso de preparación, complete las siguientes secciones para migrar.

Instalar PowerShell para administradores de Power Platform (tanto de origen como de destino)

El PowerShell para el módulo de administradores de Power Platform es el módulo de PowerShell recomendado para interactuar con las capacidades de administrador. Para obtener información que le ayude a comenzar con el módulo PowerShell para administradores de Power Platform, vaya a Introducción a PowerShell para administradores de Power Platform e Instalación de PowerShell para administradores de Power Platform.

Instale o actualice el módulo necesario mediante uno de los siguientes comandos:

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

Instalar Azure PowerShell en Windows (tanto para administradores de origen como de destino)

El módulo Azure PowerShell es un módulo consolidado. Al instalar el módulo Azure PowerShell, se descargan los módulos disponibles con carácter general y sus cmdlets están disponibles para su uso. Obtenga más información en Instalar Azure PowerShell en Windows.

Use el cmdlet Install-Module para instalar el módulo Azure PowerShell:

Install-Module -Name Az -Repository PSGallery -Force

Inicie sesión en Microsoft Power Platform (administradores de origen y destino)

Inicie sesión en Microsoft Power Platform. Este paso permite a los administradores autenticarse y acceder al entorno de Power Platform.

Add-PowerAppsAccount

Enviar solicitud de migración (administrador de origen)

Para iniciar una migración de inquilino a inquilino, el administrador del inquilino de origen de Dynamics 365 o Power Platform debe enviar una solicitud al inquilino de destino mediante el siguiente comando y proporcionar el identificador de nombre de entorno y el identificador de inquilino.

Debe tener credenciales de administrador de Power Platform o de administrador de Dynamics 365 para completar este paso.

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

Puede ver el estado y MigrationID mediante el siguiente comando.

TenantToTenant-ViewMigrationRequest

Nota

Registre el MigrationID, que se utiliza en otros comandos de migración. El MigrationID del inquilino de origen es diferente del MigrationID del inquilino de destino

Ver y aprobar una solicitud de migración (administrador de destino)

El administrador del inquilino de destino debe ejecutar el siguiente comando para ver todas las solicitudes y el estado de la migración. El administrador puede revisar todas las solicitudes de migración y las opciones para aprobar o rechazar.

Add-PowerAppsAccount

TenantToTenant-ViewApprovalRequest

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

Una vez que se aprueba una solicitud, el administrador del inquilino de destino puede notificar al administrador del inquilino de origen para continuar con el siguiente paso de la migración.

Generar una dirección URL de firma de acceso compartido (SAS) (administrador de origen)

Este paso implica la creación de la dirección URL de SAS, que se utiliza posteriormente para cargar el archivo de asignación de usuarios. Ejecute el siguiente comando PowerShell, sustituyendo EnvironmentId por el identificador de entorno real.

GenerateResourceStorage-PowerAppEnvironment –EnvironmentName {EnvironmentId}

Importante

Asegúrese de que el entorno no esté en modo de administrador y de que el usuario tenga asignado el rol de usuario básico en el entorno.

Salida de muestra

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

Cargue el archivo de asignación de usuarios (administrador de origen)

El siguiente paso consiste en transferir el archivo de asignación de usuarios a la dirección URL de SAS establecida anteriormente. Para ello, ejecute los siguientes comandos en Windows PowerShell ISE, asegurándose de que los parámetros SASUri y FileToUpload contengan la información adecuada sobre su entorno. Este paso es crucial para cargar el mapeo de los usuarios con precisión en el sistema.

Nota

Se requiere la instalación del módulo Azure para ejecutar el script mencionado. Complete los pasos siguientes con Windows PowerShell ISE.

$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

Preparar la migración del entorno (administrador de origen)

El siguiente paso implica la realización de validaciones exhaustivas para garantizar que todos los usuarios enumerados en el archivo de asignación de usuarios estén comprobados y actualmente activos en el inquilino de destino.

MigrationId se puede ver mediante el comando "TenantToTenant-ViewMigrationRequest" en el inquilino de origen.

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

Nota

Al pasar el valor SASUri, debe proporcionar el parámetro de la siguiente manera: https://dynamics.blob.core.windows.net/20240604t000000z73e18df430fe40059290dsddc25d783.

Salida de muestra

Code        : 202
Description : Accepted

La duración de este paso varía en función del número de usuarios en el archivo de asignación de usuarios. Puede supervisar el progreso de este paso mediante el comando TenantToTenant-GetStatus, que se proporciona a continuación.

Comprobar estado (administrador de origen)

TenantToTenant-GetMigrationStatus -MigrationId {MigrationId}

Salida de muestra

• Validar migración de inquilino a inquilino: En ejecución
• Validar migración de inquilino a inquilino: Con éxito
• Error de validación; los errores se actualizan en blob aquí: SASURI

Errores y cómo resolverlos

• Si recibe un error que dice: El archivo de asignación de usuario proporcionado para la migración de inquilino a inquilino no es válido, compruebe si el nombre del archivo de asignación de usuarios es correcto y si el archivo de asignación de usuarios tiene una coma para separar los valores.
• Línea '{números de línea}' tienen el mismo '{emailID}': Asegúrese de que no haya entradas duplicadas.
• Formato de correo electrónico no válido '{emailid}': Asegúrese de que el formato de correo electrónico sea el correcto testuser@tenantdomain.com.
• El destino en línea '{linenumber}' es el mismo que el emailId de origen: asegúrese de que el correo electrónico de destino sea diferente del correo electrónico de origen.
• Cada línea debe tener exactamente dos columnas: '{números de línea}': asegúrese de que cada fila tenga solo dos columnas: la columna de origen y la de destino. Elimine las comas adicionales, si las hubiera.

Después de corregir los errores de asignación de usuarios, debe volver a cargar el archivo de asignación de usuarios utilizando el mismo URI de SAS.

Descargar el informe de errores (administrador de origen)

Si hay algún error en el archivo de asignación de usuarios, existe la opción de descargar un informe de errores. Esto se puede hacer copiando y pegando directamente la SasUrl proporcionada en el comando Tenant-To-Tenant-GetMigrationStatus o mediante los siguientes comandos que usan el URI de SAS del paso anterior: Comprobar el estado y la ubicación deseada para descargar el informe de errores.

Lleve a cabo los pasos siguientes.

1. Ejecute el comando siguiente 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. Solucione los problemas en el archivo de asignación de usuarios.

3. Vuelva a cargar el archivo siguiendo los pasos descritos en [Cargar el archivo de asignación de usuarios (administrador de origen)](#upload-the-user-mapping-file-(source-admin).

Después de completar correctamente Preparar la migración del entorno (administrador de origen), puede continuar con el procedimiento Migrar el entorno (administrador de origen) para migrar el entorno. Realice la migración dentro de los próximos siete días. Si no completa la migración en los próximos siete días, debe comenzar con el procedimiento Preparar la migración del entorno (administrador de origen), nuevamente.

Migrar el entorno (administrador de origen)

El MigrationId se puede ver mediante el comando TenantToTenant-ViewMigrationRequest en el inquilino de origen.

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

Obtener estado (administrador de origen)

TenantToTenant-GetMigrationStatus -EnvironmentName {EnvironmentId}

Salida de muestra

• Migrar entorno: En ejecución
• Migrar entorno: Con éxito

Nota

Si tiene algún problema para ejecutar los comandos anteriores, envíe una solicitud de soporte técnico para obtener ayuda.

Proceso post migración

Después de mover entornos a otro inquilino:

• La URL del entorno, el ID de la organización (OrgID) y el nombre no cambian.
• El entorno de origen no tiene Dataverse.
• Los usuarios no incluidos en el archivo de asignación no serán migrados ni asignados después de la migración.

Complete los siguientes procedimientos para Power Automate, Power Apps, Copilot Studio, Power Pages.

Proceso post migración para Power Automate

Una vez completada la migración, recorra la sección Revisar componentes como una lista de comprobación para ajustar y activar los flujos y otros componentes. Los pasos clave son:

1. Cree conexiones para todas las referencias de conexión.
2. Inicie todos los flujos, incluido el inicio de los flujos secundarios antes que los primarios.
3. Para cualquier flujo desencadenado por HTTP, recupere la nueva dirección URL y colóquela en las aplicaciones o flujos de llamada para actualizar esas referencias.

Proceso post migración para Power Apps

Para aplicaciones compatibles con soluciones:

1. Seleccione el nuevo entorno en Power Apps y navegue a la página Soluciones.
2. Seleccione Importar y use el selector de archivos para elegir los paquetes exportados de los pasos anteriores.
3. Confirme que la importación se completó correctamente verificando el contenido de la solución en el entorno migrado.

Para las aplicaciones que no son compatibles con las soluciones:

1. Vaya a Power Apps.
2. Seleccione el entorno nuevo en la lista desplegable Entorno.
3. Seleccione Aplicaciones.
4. Seleccione Importar aplicación de lienzo.
5. Cargar el archivo de paquete de la aplicación.
6. Complete todas las selecciones de opciones de importación y luego seleccione Importar.
7. Repita estos pasos hasta que se hayan importado todas las aplicaciones.

Proceso post migración para Copilot Studio

1. Seleccione el nuevo entorno en Power Apps y navegue a la página Soluciones.
2. Seleccione Importar y use el selector de archivos para elegir los paquetes exportados de los pasos anteriores.
3. Confirme que la importación se completó correctamente verificando el contenido de la solución en el entorno migrado.

Proceso post migración para Power Pages

Se deben completar los siguientes pasos para cada sitio web del entorno.

1. Inicie sesión en el entorno.
2. Abra el Centro de Administración.
3. Aprovisione el sitio web con el mismo tipo de portal e idioma.

Después de completar todos los pasos anteriores y la migración, puede validar el entorno en el inquilino de destino y, más tarde, puede eliminar el entorno de origen en el centro de administración de Power Platform.

Preguntas frecuentes

¿Están habilitadas las operaciones en segundo plano durante la migración de inquilino a inquilino? El modo de administración está habilitado durante la migración de inquilino a inquilino, por lo que las operaciones en segundo plano no se ejecutan. Más información en Modo de administración.

¿Podemos migrar todos los usuarios de la organización Dataverse? Podemos migrar todos los usuarios de la organización de Dataverse solo si existen usuarios en el inquilino de destino. Por ejemplo:

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