Migrar automaticamente do Azure Virtual Desktop (clássico)

2025-06-20

A ferramenta de módulo de migração permite-lhe migrar a sua organização do Azure Virtual Desktop (clássico) para o Azure Virtual Desktop automaticamente. Este artigo irá mostrar-lhe como utilizar a ferramenta.

Pré-requisitos

Antes de utilizar o módulo de migração, certifique-se de que tem os seguintes itens prontos:

Uma subscrição do Azure onde irá criar novos objetos de serviço do Azure.
Tem de lhe ser atribuída a função Contribuidor para criar objetos do Azure na sua subscrição e a função Administrador de Acesso de Utilizadores para atribuir utilizadores a grupos de aplicações.
Pelo menos, permissões de Contribuidor dos Serviços de Ambiente de Trabalho Remoto (RDS) num inquilino rds ou nos conjuntos de anfitriões específicos que está a migrar.
A versão mais recente do módulo Do PowerShell Microsoft.RdInfra.RDPowershell.
A versão mais recente do módulo Az.DesktopVirtualization do PowerShell.
A versão mais recente do módulo Az.Resources do PowerShell.
Instale o módulo de migração no seu computador.
PowerShell ou ISE do PowerShell para executar os scripts que verá neste artigo. O módulo Microsoft.RdInfra.RDPowershell não funciona no PowerShell Core.

Importante

A migração só cria objetos de serviço na geografia dos EUA. Se tentar migrar os objetos de serviço para outra geografia, não funcionará. Além disso, se tiver mais de 500 grupos de aplicações na sua implementação do Azure Virtual Desktop (clássico), não poderá migrar. Só poderá migrar se reconstruir o seu ambiente para reduzir o número de grupos de aplicações no seu inquilino Microsoft Entra.

Preparar o ambiente do PowerShell

Primeiro, terá de preparar o ambiente do PowerShell para o processo de migração.

Para preparar o ambiente do PowerShell:

Antes de começar, certifique-se de que tem a versão mais recente dos módulos Az.Desktop Virtualization e Az.Resources ao executar os seguintes cmdlets:

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

Se não o fizer, terá de instalar e importar os módulos ao executar estes cmdlets:

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

Em seguida, desinstale o módulo do PowerShell de RDInfra atual ao executar este cmdlet:
```
Uninstall-Module -Name Microsoft.RDInfra.RDPowershell -AllVersions
```

Depois disso, instale o módulo RDPowershell com este cmdlet:

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

Depois de instalar tudo, execute este cmdlet para se certificar de que tem as versões corretas dos módulos:
```
Get-Module Microsoft.RDInfra.RDPowershell
```

Agora, vamos instalar e importar o módulo de migração ao executar estes 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

Quando terminar, inicie sessão no Azure Virtual Desktop (clássico) na janela do PowerShell:
```
Add-RdsAccount -DeploymentUrl https://rdbroker.wvd.microsoft.com
```
Inicie sessão no Azure Resource Manager:
```
Login-AzAccount
```
Se tiver várias subscrições, selecione aquela para a qual pretende migrar os recursos com este cmdlet:
```
Select-AzSubscription -Subscriptionid <subID>
```
Registe o Fornecedor de Recursos no portal do Azure da subscrição selecionada.
Por fim, terá de registar o fornecedor. Há duas maneiras de fazer isso:
- Se quiser utilizar o PowerShell, execute este cmdlet:
```
Register-AzResourceProvider -ProviderNamespace Microsoft.DesktopVirtualization
```
- Se preferir utilizar o portal do Azure, abra e inicie sessão no portal do Azure, aceda a Subscrições e selecione o nome da subscrição que pretende utilizar. Depois disso, aceda a Fornecedor> de RecursosMicrosoft.DesktopVirtualização e selecione Voltar a registar. Ainda não verá nenhuma alteração na IU, mas o ambiente do PowerShell deverá estar pronto para executar o módulo.

Migrar recursos do Azure Virtual Desktop (clássico) para o Azure Resource Manager

Agora que o ambiente do PowerShell está pronto, pode iniciar o processo de migração.

Para migrar os recursos do Azure Virtual Desktop (clássico) para o Azure Resource Manager:

Antes de migrar, se quiser compreender como os recursos Clássicos existentes serão mapeados para novos recursos do Azure Resource Manager, execute este cmdlet:
```
Get-RdsHostPoolMigrationMapping
```
Com Get-RdsHostPoolMigrationMapping, pode criar um ficheiro CSV que mapeia para onde irão os seus recursos. Por exemplo, se o nome do seu inquilino for "Contoso" e quiser armazenar o ficheiro de mapeamento no ficheiro "contosouser", teria de executar um cmdlet com o seguinte aspeto:
```
Get-RdsHostPoolMigrationMapping -Tenant Contoso -HostPool Office -Location EastUS -OutputFile 'C:\\Users\contosouser\OneDrive - Microsoft\Desktop\mapping.csv'
```
Em seguida, execute o cmdlet Start-RdsHostPoolMigration para escolher se pretende migrar um único conjunto de anfitriões ou todos os conjuntos de anfitriões num inquilino.

Por exemplo:
```
Start-RdsHostPoolMigration -Tenant Contoso -Location WestUS
```
Se quiser migrar os seus recursos para um conjunto de anfitriões específico, inclua o nome do conjunto de anfitriões. Por exemplo, se quiser mover o conjunto de anfitriões denominado "Office", execute um comando como este:
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments $false -Location EastUS
```
Se não atribuir um nome de área de trabalho, o módulo irá criar automaticamente um para si com base no nome do inquilino. No entanto, se preferir utilizar uma área de trabalho específica, pode introduzir o respetivo ID de recurso da seguinte forma:
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments -Location EastUS -Workspace <Resource ID of workspacename>
```
Se quiser utilizar uma área de trabalho específica, mas não souber o respetivo ID de recurso, execute este cmdlet:
```
Get-AzWvdWorkspace -WorkspaceName <workspace> -ResourceGroupName <resource group> |fl
```
Também terá de especificar um modo de atribuição de utilizador para as atribuições de utilizador existentes:
- Utilize Copiar para copiar todas as atribuições de utilizadores dos grupos de aplicações antigos para o Azure Resource Manager grupos de aplicações. Os utilizadores poderão ver feeds para ambas as versões dos clientes.
- Utilize Nenhuma se não quiser alterar as atribuições de utilizador. Mais tarde, pode atribuir utilizadores ou grupos de utilizadores a grupos de aplicações com o portal do Azure, o PowerShell ou a API. Os utilizadores só poderão ver feeds com os clientes do Azure Virtual Desktop (clássico).
Só pode copiar 2000 atribuições de utilizador por subscrição, pelo que o seu limite dependerá do número de atribuições que já se encontram na sua subscrição. O módulo calcula o limite com base no número de atribuições que já tem. Se não tiver atribuições suficientes para copiar, receberá uma mensagem de erro a indicar "Quota de atribuição de funções insuficiente para copiar atribuições de utilizadores. Execute novamente o comando sem o comutador -CopyUserAssignments para migrar."
Depois de executar os comandos, o módulo demorará até 15 minutos a criar os objetos de serviço. Se copiou ou moveu quaisquer atribuições de utilizador, isso irá aumentar o tempo que o módulo demora a concluir a configuração de tudo.

Após a conclusão do cmdlet Start-RdsHostPoolMigration , deverá ver os seguintes aspetos:
- Objetos de serviço do Azure para o inquilino ou conjunto de anfitriões que especificou.
- Dois novos grupos de recursos:
  - Um grupo de recursos chamado "Tenantname", que contém a área de trabalho.
  - Um grupo de recursos chamado "Tenantname_originalHostPoolName", que contém o conjunto de anfitriões e os grupos de aplicações de ambiente de trabalho.
- Todos os utilizadores que publicou nos grupos de aplicações criados recentemente.
- As máquinas virtuais estarão disponíveis nos conjuntos de anfitriões existentes e novos para evitar períodos de indisponibilidade do utilizador durante o processo de migração. Isto permite que os utilizadores se liguem à mesma sessão de utilizador.
Uma vez que estes novos objetos de serviço do Azure são objetos de Resource Manager do Azure, o módulo não consegue definir permissões de diagnóstico ou permissões de Controle de Acesso baseadas em funções (RBAC) nos mesmos. Por conseguinte, terá de atualizar manualmente as permissões e definições RBAC para estes objetos.

Assim que o módulo validar as ligações iniciais do utilizador, também pode publicar o grupo de aplicações para mais utilizadores ou grupos de utilizadores, se quiser.

Observação

Após a migração, se mover grupos de aplicações para um grupo de recursos diferente depois de atribuir permissões aos utilizadores, removerá todas as funções RBAC. Terá de reatribuir as permissões RBAC dos utilizadores novamente.
Se quiser eliminar todos os objetos de serviço do Azure Virtual Desktop (clássico), execute Complete-RdsHostPoolMigration para concluir o processo de migração. Este cmdlet irá eliminar todos os objetos do Azure Virtual Desktop (clássico), deixando apenas os novos objetos do Azure. Os utilizadores só poderão ver o feed dos grupos de aplicações recentemente criados nos seus clientes. Assim que este comando estiver concluído, pode eliminar com segurança o inquilino do Azure Virtual Desktop (clássico) para concluir o processo.

Por exemplo:
```
Complete-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Se quiser concluir um conjunto de anfitriões específico, pode incluir o nome do conjunto de anfitriões no cmdlet . Por exemplo, se quiser concluir um conjunto de anfitriões com o nome "Office", utilizará um comando como este:
```
Complete-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
Isto eliminará todos os objetos de serviço criados pelo Azure Virtual Desktop (clássico). Só lhe serão deixados os novos objetos do Azure e os utilizadores só poderão ver o feed dos grupos de aplicações criados recentemente nos seus clientes. Quando terminar de finalizar a migração, terá de eliminar explicitamente o inquilino no Azure Virtual Desktop (clássico).
Se tiver mudado de ideias sobre a migração e quiser reverter o processo, execute o cmdlet Revert-RdsHostPoolMigration.

Por exemplo:
```
Revert-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Se quiser reverter um conjunto de anfitriões específico, pode incluir o nome do conjunto de anfitriões no comando . Por exemplo, se quiser reverter um conjunto de anfitriões com o nome "Office", introduza algo assim:
```
Revert-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
Este cmdlet irá eliminar todos os objetos de serviço do Azure criados recentemente. Os seus utilizadores só verão o feed para objetos do Azure Virtual Desktop (clássico) nos seus clientes.

No entanto, o cmdlet não eliminará a área de trabalho que o módulo criou ou o grupo de recursos associado. Terá de eliminar manualmente esses itens para os eliminar.
Se ainda não quiser eliminar os objetos de serviço do Azure Virtual Desktop (clássico), mas quiser testar a migração, pode executar Set-RdsHostPoolHidden.

Por exemplo:
```
Set-RdsHostPoolHidden -Tenant Contoso -Hostpool Office -Hidden $true -Location WestUS
```
Definir o status como "verdadeiro" irá ocultar os recursos do Azure Virtual Desktop (clássico). Defini-lo como "falso" irá revelar os recursos aos seus utilizadores.

O parâmetro -Hostpool é opcional. Pode utilizar este parâmetro se quiser ocultar um conjunto de anfitriões específico do Azure Virtual Desktop (clássico).

Este cmdlet irá ocultar o feed de utilizador e os objetos de serviço do Azure Virtual Desktop (clássico) em vez de os eliminar. No entanto, normalmente, isto só é utilizado para testes e não conta como uma migração concluída. Para concluir a migração, terá de executar o comando Complete-RdsHostPoolMigration . Caso contrário, reverter a sua implementação ao executar Revert-RdsHostPoolMigration.

Resolver problemas de migração automática

Esta secção explica como resolver problemas frequentemente encontrados no módulo de migração.

Não consigo aceder ao inquilino

Primeiro, experimente estas duas coisas:

Certifique-se de que a sua conta de administrador tem as permissões necessárias para aceder ao inquilino.
Experimente executar Get-RdsTenant no inquilino.

Se estas duas coisas funcionarem, experimente executar o cmdlet Set-RdsMigrationContext para definir o Contexto de RDS e o Contexto da ADAL para a migração:

Crie o Contexto RDS ao executar o cmdlet Add-RdsAccount .
Localize o Contexto de RDS na variável global $rdMgmtContext.
Localize o Contexto da ADAL na variável global $AdalContext.

Execute Set-RdsMigrationContext com as variáveis que encontrou neste formato:

Set-RdsMigrationContext -RdsContext <rdscontext> -AdalContext <adalcontext>

Próximas etapas

Se quiser saber como migrar a sua implementação manualmente, veja Migrar manualmente a partir do Azure Virtual Desktop (clássico).

Depois de migrar, saiba como funciona o Azure Virtual Desktop ao consultar os nossos tutoriais. Saiba mais sobre as capacidades de gestão avançadas em Expandir um conjunto de anfitriões existente e Personalizar propriedades RDP.

Para saber mais sobre objetos de serviço, marcar ambiente do Azure Virtual Desktop.