Migración automática desde Azure Virtual Desktop (clásico)

La herramienta de módulo de migración le permite migrar su organización de Azure Virtual Desktop (clásico) a Azure Virtual Desktop automáticamente. En este artículo se muestra cómo usar la herramienta.

Requisitos previos

Antes de usar el módulo de migración, asegúrese de que tiene listos los siguientes elementos:

Una suscripción de Azure donde creará nuevos objetos de servicio de Azure.
Debe tener asignado el rol Colaborador para crear objetos de Azure en la suscripción y el rol Administrador de acceso de usuario para asignar usuarios a grupos de aplicaciones.
Al menos permisos de colaborador de Servicios de Escritorio remoto (RDS) en un inquilino de RDS o en los grupos de hosts específicos que va a migrar.
La versión más reciente del módulo de PowerShell Microsoft.RdInfra.RDPowershell.
La versión más reciente del módulo Az.DesktopVirtualization de PowerShell.
La versión más reciente del módulo Az.Resources de PowerShell.
Instale el módulo de migración en el equipo.
PowerShell o PowerShell ISE para ejecutar los scripts que verá en este artículo. El módulo Microsoft.RdInfra.RDPowershell no funciona en PowerShell Core.

Importante

La migración solo crea objetos de servicio en la geografía de EE. UU. Si intenta migrar los objetos de servicio a otra geografía, no funcionará. Además, si tiene más de 500 grupos de aplicaciones en la implementación de Azure Virtual Desktop (clásico), no podrá migrar. Solo podrá migrar si recompila el entorno para reducir el número de grupos de aplicaciones dentro del inquilino de Microsoft Entra.

Preparación del entorno de PowerShell

En primer lugar, deberá preparar el entorno de PowerShell para el proceso de migración.

Para preparar el entorno de PowerShell:

Antes de empezar, asegúrese de que tiene la versión más reciente de los módulos Az.Desktop Virtualization y Az.Resources mediante la ejecución de los siguientes cmdlets:

Get-Module Az.Resources
Get-Module Az.DesktopVirtualization
https://www.powershellgallery.com/packages/Az.DesktopVirtualization/
https://www.powershellgallery.com/packages/Az.Resources/

Si no lo hace, tendrá que instalar e importar los módulos mediante la ejecución de estos cmdlets:

Install-module Az.Resources
Import-module Az.Resources
Install-module Az.DesktopVirtualization
Import-module Az.DesktopVirtualization

A continuación, desinstale el módulo de PowerShell RDInfra actual mediante la ejecución de este cmdlet:
```
Uninstall-Module -Name Microsoft.RDInfra.RDPowershell -AllVersions
```

Después, instale el módulo RDPowershell con este cmdlet:

Install-Module -Name Microsoft.RDInfra.RDPowershell -RequiredVersion 1.0.3414.0 -force
Import-module Microsoft.RDInfra.RDPowershell

Una vez que haya terminado de instalar todo, ejecute este cmdlet para asegurarse de que tiene las versiones correctas de los módulos:
```
Get-Module Microsoft.RDInfra.RDPowershell
```

Ahora, vamos a instalar e importar el módulo de migración mediante la ejecución de estos cmdlets:

Install-Module -Name PackageManagement -Repository PSGallery -Force
Install-Module -Name PowerShellGet -Repository PSGallery -Force
# Then restart shell
Install-Module -Name Microsoft.RdInfra.RDPowershell.Migration -AllowClobber
Import-Module <Full path to the location of the migration module>\Microsoft.RdInfra.RDPowershell.Migration.psd1

Una vez que haya terminado, inicie sesión en Azure Virtual Desktop (clásico) en la ventana de PowerShell:
```
Add-RdsAccount -DeploymentUrl https://rdbroker.wvd.microsoft.com
```
Inicie sesión en Azure Resource Manager:
```
Login-AzAccount
```
Si tiene varias suscripciones, seleccione la a la que desea migrar los recursos con este cmdlet:
```
Select-AzSubscription -Subscriptionid <subID>
```
Registre el proveedor de recursos en Azure Portal para la suscripción seleccionada.
Por último, tendrá que registrar el proveedor. Hay dos formas de hacerlo:
- Si desea usar PowerShell, ejecute este cmdlet:
```
Register-AzResourceProvider -ProviderNamespace Microsoft.DesktopVirtualization
```
- Si prefiere usar el Azure Portal, abra e inicie sesión en el Azure Portal, vaya a Suscripciones y seleccione el nombre de la suscripción que desea usar. Después, vaya a Proveedor> de recursosMicrosoft.DesktopVirtualization y seleccione Volver a registrarse. Todavía no verá ningún cambio en la interfaz de usuario, pero el entorno de PowerShell debería estar listo para ejecutar el módulo.

Migración de recursos de Azure Virtual Desktop (clásico) a Azure Resource Manager

Ahora que el entorno de PowerShell está listo, puede comenzar el proceso de migración.

Para migrar los recursos de Azure Virtual Desktop (clásico) a Azure Resource Manager:

Antes de migrar, si desea comprender cómo se asignarán los recursos clásicos existentes a los nuevos recursos de Azure Resource Manager, ejecute este cmdlet:
```
Get-RdsHostPoolMigrationMapping
```
Con Get-RdsHostPoolMigrationMapping, puede crear un archivo CSV que asigne a dónde irán los recursos. Por ejemplo, si el nombre del inquilino es "Contoso" y desea almacenar el archivo de asignación en el archivo "contosouser", ejecutaría un cmdlet similar al siguiente:
```
Get-RdsHostPoolMigrationMapping -Tenant Contoso -HostPool Office -Location EastUS -OutputFile 'C:\\Users\contosouser\OneDrive - Microsoft\Desktop\mapping.csv'
```
A continuación, ejecute el cmdlet Start-RdsHostPoolMigration para elegir si desea migrar un único grupo host o todos los grupos de hosts dentro de un inquilino.

Por ejemplo:
```
Start-RdsHostPoolMigration -Tenant Contoso -Location WestUS
```
Si desea migrar los recursos a un grupo de hosts específico, incluya el nombre del grupo de hosts. Por ejemplo, si desea mover el grupo host denominado "Office", ejecute un comando como este:
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments $false -Location EastUS
```
Si no asigna un nombre de área de trabajo, el módulo creará automáticamente uno en función del nombre del inquilino. Sin embargo, si prefiere usar un área de trabajo específica, puede escribir su identificador de recurso de la siguiente manera:
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments -Location EastUS -Workspace <Resource ID of workspacename>
```
Si desea usar un área de trabajo específica pero no conoce su identificador de recurso, ejecute este cmdlet:
```
Get-AzWvdWorkspace -WorkspaceName <workspace> -ResourceGroupName <resource group> |fl
```
También deberá especificar un modo de asignación de usuario para las asignaciones de usuario existentes:
- Use Copiar para copiar todas las asignaciones de usuarios de los grupos de aplicaciones antiguos en azure Resource Manager grupos de aplicaciones. Los usuarios podrán ver fuentes para ambas versiones de sus clientes.
- Use None si no desea cambiar las asignaciones de usuario. Más adelante, puede asignar usuarios o grupos de usuarios a grupos de aplicaciones con la Azure Portal, PowerShell o API. Los usuarios solo podrán ver fuentes mediante los clientes de Azure Virtual Desktop (clásico).
Solo puede copiar 2000 asignaciones de usuarios por suscripción, por lo que el límite dependerá del número de asignaciones que ya haya en la suscripción. El módulo calcula el límite en función del número de asignaciones que ya tiene. Si no tiene suficientes asignaciones para copiar, recibirá un mensaje de error que indica "Cuota insuficiente de asignación de roles para copiar asignaciones de usuario. Vuelva a ejecutar el comando sin el modificador -CopyUserAssignments para migrar".
Después de ejecutar los comandos, el módulo tardará hasta 15 minutos en crear los objetos de servicio. Si copió o movió las asignaciones de usuario, se agregará al tiempo que tarda el módulo en finalizar la configuración.

Una vez que haya terminado el cmdlet Start-RdsHostPoolMigration , debería ver lo siguiente:
- Objetos de servicio de Azure para el inquilino o el grupo de hosts especificados.
- Dos nuevos grupos de recursos:
  - Un grupo de recursos denominado "Tenantname", que contiene el área de trabajo.
  - Un grupo de recursos denominado "Tenantname_originalHostPoolName", que contiene el grupo de hosts y los grupos de aplicaciones de escritorio.
- Los usuarios que haya publicado en los grupos de aplicaciones recién creados.
- Las máquinas virtuales estarán disponibles en grupos de hosts existentes y nuevos para evitar tiempos de inactividad del usuario durante el proceso de migración. Esto permite a los usuarios conectarse a la misma sesión de usuario.
Dado que estos nuevos objetos de servicio de Azure son objetos de Azure Resource Manager, el módulo no puede establecer permisos de Access Control basado en rol (RBAC) ni configuración de diagnóstico en ellos. Por lo tanto, deberá actualizar manualmente los permisos y la configuración de RBAC para estos objetos.

Una vez que el módulo valida las conexiones de usuario iniciales, también puede publicar el grupo de aplicaciones en más usuarios o grupos de usuarios, si lo desea.

Nota:

Después de la migración, si mueve grupos de aplicaciones a otro grupo de recursos después de asignar permisos a los usuarios, quitará todos los roles de RBAC. Tendrá que volver a reasignar los permisos de RBAC de los usuarios.
Si desea eliminar todos los objetos de servicio de Azure Virtual Desktop (clásico), ejecute Complete-RdsHostPoolMigration para finalizar el proceso de migración. Este cmdlet eliminará todos los objetos de Azure Virtual Desktop (clásico), dejando solo los nuevos objetos de Azure. Los usuarios solo podrán ver la fuente de los grupos de aplicaciones recién creados en sus clientes. Una vez completado este comando, puede eliminar de forma segura el inquilino de Azure Virtual Desktop (clásico) para finalizar el proceso.

Por ejemplo:
```
Complete-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Si desea completar un grupo de hosts específico, puede incluir el nombre del grupo de hosts en el cmdlet . Por ejemplo, si desea completar un grupo host denominado "Office", usaría un comando como este:
```
Complete-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
Esto eliminará todos los objetos de servicio creados por Azure Virtual Desktop (clásico). Solo se le quedarán los nuevos objetos de Azure y los usuarios solo podrán ver la fuente de los grupos de aplicaciones recién creados en sus clientes. Una vez que haya terminado de finalizar la migración, debe eliminar explícitamente el inquilino en Azure Virtual Desktop (clásico).
Si ha cambiado de opinión sobre la migración y quiere revertir el proceso, ejecute el cmdlet Revert-RdsHostPoolMigration .

Por ejemplo:
```
Revert-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Si desea revertir un grupo de hosts específico, puede incluir el nombre del grupo de hosts en el comando . Por ejemplo, si quiere revertir un grupo host denominado "Office", escribiría algo parecido a esto:
```
Revert-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
Este cmdlet eliminará todos los objetos de servicio de Azure recién creados. Los usuarios solo verán la fuente de objetos de Azure Virtual Desktop (clásico) en sus clientes.

Sin embargo, el cmdlet no eliminará el área de trabajo que creó el módulo ni su grupo de recursos asociado. Tendrá que eliminar manualmente esos elementos para deshacerse de ellos.
Si aún no desea eliminar los objetos de servicio de Azure Virtual Desktop (clásico), pero quiere probar la migración, puede ejecutar Set-RdsHostPoolHidden.

Por ejemplo:
```
Set-RdsHostPoolHidden -Tenant Contoso -Hostpool Office -Hidden $true -Location WestUS
```
Al establecer el estado en "true", se ocultarán los recursos de Azure Virtual Desktop (clásico). Si se establece en "false", se mostrarán los recursos a los usuarios.

El parámetro -Hostpool es opcional. Puede usar este parámetro si hay un grupo de hosts de Azure Virtual Desktop (clásico) específico que desea ocultar.

Este cmdlet ocultará los objetos de servicio y fuente de usuario de Azure Virtual Desktop (clásico) en lugar de eliminarlos. Sin embargo, esto normalmente solo se usa para pruebas y no cuenta como una migración completada. Para completar la migración, deberá ejecutar el comando Complete-RdsHostPoolMigration . De lo contrario, revierta la implementación ejecutando Revert-RdsHostPoolMigration.

Solución de problemas de migración automática

En esta sección se explica cómo resolver problemas comunes en el módulo de migración.

No puedo acceder al inquilino.

En primer lugar, pruebe estas dos cosas:

Asegúrese de que la cuenta de administrador tiene los permisos necesarios para acceder al inquilino.
Pruebe a ejecutar Get-RdsTenant en el inquilino.

Si esas dos cosas funcionan, pruebe a ejecutar el cmdlet Set-RdsMigrationContext para establecer el contexto de RDS y el contexto de ADAL para la migración:

Cree el contexto de RDS mediante la ejecución del cmdlet Add-RdsAccount .
Busque el contexto de RDS en la variable global $rdMgmtContext.
Busque el contexto de ADAL en la variable global $AdalContext.
Ejecute Set-RdsMigrationContext con las variables que ha encontrado en este formato:
```
Set-RdsMigrationContext -RdsContext <rdscontext> -AdalContext <adalcontext>
```

Pasos siguientes

Si desea obtener información sobre cómo migrar la implementación manualmente, consulte Migración manual desde Azure Virtual Desktop (clásico).

Una vez que haya migrado, consulte nuestros tutoriales para conocer el funcionamiento de Azure Virtual Desktop. Obtenga información sobre las funcionalidades de administración avanzada en Expandir un grupo de hosts existente y Personalizar las propiedades de RDP.

Para más información sobre los objetos de servicio, consulte Entorno de Azure Virtual Desktop.

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-06-20