Migrar automaticamente da Área de Trabalho Virtual do Azure (clássica)

Importante

O clássico da Área de Trabalho Virtual do Azure será desativado em 30 de setembro de 2026. As conexões com recursos clássicos serão bloqueadas após a desativação.

Para evitar interrupções, migre os recursos clássicos restantes para pools de host baseados em Azure Resource Manager antes de 30 de setembro de 2026.

A ferramenta de módulo de migração permite migrar sua organização da Área de Trabalho Virtual do Azure (clássica) para a Área de Trabalho Virtual do Azure automaticamente. Este artigo mostrará como usar a ferramenta.

Pré-requisitos

Antes de usar o módulo de migração, certifique-se de ter o seguinte item pronto:

Uma assinatura do Azure em que você criará novos objetos de serviço do Azure.
Você deve receber a função de Colaborador para criar objetos do Azure em sua assinatura e a função de Administrador de Acesso do Usuário para atribuir usuários a grupos de aplicativos.
Pelo menos permissões de Colaborador dos Serviços de Área de Trabalho Remota (RDS) em um locatário do RDS ou nos pools de host específicos que você está migrando.
A versão mais recente do módulo Microsoft.RdInfra.RDPowershell do PowerShell.
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 você 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 você tentar migrar seus objetos de serviço para outra geografia, não funcionará. Além disso, se você tiver mais de 500 grupos de aplicativos na implantação da Área de Trabalho Virtual do Azure (clássica), não poderá migrar. Você só poderá migrar se recriar seu ambiente para reduzir o número de grupos de aplicativos em seu locatário do Microsoft Entra.

Preparar seu ambiente do PowerShell

Primeiro, você precisará preparar seu ambiente do PowerShell para o processo de migração.

Para preparar seu ambiente do PowerShell:

Antes de começar, verifique se você tem a versão mais recente dos módulos Az.Desktop Virtualization e Az.Resources executando 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/

Caso contrário, você terá que instalar e importar os módulos executando estes cmdlets:

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

Em seguida, desinstale o módulo RDInfra PowerShell atual executando 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

Quando terminar de instalar tudo, execute este cmdlet para garantir que você tenha as versões corretas dos módulos:
```
Get-Module Microsoft.RDInfra.RDPowershell
```

Agora, vamos instalar e importar o módulo de migração executando 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, entre na Área de Trabalho Virtual do Azure (clássica) na janela do PowerShell:
```
Add-RdsAccount -DeploymentUrl https://rdbroker.wvd.microsoft.com
```
Entre no Azure Resource Manager:
```
Login-AzAccount
```
Se você tiver várias assinaturas, selecione aquela para a qual deseja migrar seus recursos com este cmdlet:
```
Select-AzSubscription -Subscriptionid <subID>
```
Registre o Provedor de Recursos no portal do Azure para a assinatura selecionada.
Por fim, você precisará registrar o provedor. Há duas maneiras de fazer isso:
- Se você quiser usar o PowerShell, execute este cmdlet:
```
Register-AzResourceProvider -ProviderNamespace Microsoft.DesktopVirtualization
```
- Se você preferir usar o portal do Azure, abra e entre no portal do Azure, acesse Assinaturas e selecione o nome da assinatura que você deseja usar. Depois disso, vá para o Provedor de Recursos>Microsoft.DesktopVirtualization e selecione Registrar novamente. Você não verá nada alterar na interface do usuário ainda, mas seu ambiente do PowerShell agora deve estar pronto para executar o módulo.

Migrar recursos da Área de Trabalho Virtual do Azure (clássica) para o Azure Resource Manager

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

Para migrar seus recursos da Área de Trabalho Virtual do Azure (clássico) para Azure Resource Manager:

Antes de migrar, se você quiser entender como os recursos clássicos existentes serão mapeados para novos recursos Azure Resource Manager, execute este cmdlet:
```
Get-RdsHostPoolMigrationMapping
```
Com o Get-RdsHostPoolMigrationMapping, você pode criar um arquivo CSV que mapeia para onde seus recursos irão. Por exemplo, se o nome do locatário for "Contoso" e você quiser armazenar o arquivo de mapeamento no arquivo "contosouser", execute um cmdlet parecido com este:
```
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 deseja migrar um único pool de host ou todos os pools de host em um locatário.

Por exemplo:
```
Start-RdsHostPoolMigration -Tenant Contoso -Location WestUS
```
Se você quiser migrar seus recursos para um pool de hosts específico, inclua o nome do pool de hosts. Por exemplo, se quiser mover o pool de host chamado "Office", execute um comando como este:
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments $false -Location EastUS
```
Se você não fornecer um nome de workspace, o módulo criará um automaticamente para você com base no nome do locatário. No entanto, se preferir usar um workspace específico, você poderá inserir a ID do recurso da seguinte forma:
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments -Location EastUS -Workspace <Resource ID of workspacename>
```
Se você quiser usar um espaço de trabalho específico, mas não souber sua ID de recurso, execute este cmdlet:
```
Get-AzWvdWorkspace -WorkspaceName <workspace> -ResourceGroupName <resource group> |fl
```
Você também precisará especificar um modo de atribuição de usuário para as atribuições de usuário existentes:
- Use Copiar para copiar todas as atribuições de usuário de seus grupos de aplicativos antigos para Azure Resource Manager grupos de aplicativos. Os usuários poderão ver feeds para ambas as versões de seus clientes.
- Use Nenhum se não quiser alterar as atribuições do usuário. Posteriormente, você poderá atribuir usuários ou grupos de usuários a grupos de aplicativos com o portal do Azure, o PowerShell ou a API. Os usuários só poderão ver feeds usando os clientes da Área de Trabalho Virtual do Azure (clássica).
Você só pode copiar 2.000 atribuições de usuário por assinatura, portanto, seu limite dependerá de quantas atribuições já estão em sua assinatura. O módulo calcula o limite com base em quantas atribuições você já tem. Se você não tiver atribuições suficientes para copiar, receberá uma mensagem de erro que diz "Cota de atribuição de função insuficiente para copiar atribuições de usuário. Execute novamente o comando sem a opção -CopyUserAssignments para migrar."
Depois de executar os comandos, levará até 15 minutos para o módulo criar os objetos de serviço. Se você copiou ou moveu alguma atribuição de usuário, isso aumentará o tempo necessário para o módulo concluir a configuração de tudo.

Depois que o cmdlet Start-RdsHostPoolMigration for feito, você deverá ver as seguintes coisas:
- Objetos de serviço do Azure para o locatário ou pool de host que você especificou.
- Dois novos grupos de recursos:
  - Um grupo de recursos chamado "Tenantname", que contém seu workspace.
  - Um grupo de recursos chamado "Tenantname_originalHostPoolName", que contém o pool de host e os grupos de aplicativos da área de trabalho.
- Todos os usuários publicados nos grupos de aplicativos recém-criados.
- As máquinas virtuais estarão disponíveis em pools de host existentes e novos para evitar o tempo de inatividade do usuário durante o processo de migração. Isso permite que os usuários se conectem à mesma sessão de usuário.
Como esses novos objetos de serviço de Azure são objetos Azure Resource Manager, o módulo não pode definir permissões de RBAC (Controle de Acesso baseado em Função) ou configurações de diagnóstico neles. Portanto, você precisará atualizar as permissões e configurações RBAC para esses objetos manualmente.

Depois que o módulo valida as conexões de usuário iniciais, você também pode publicar o grupo de aplicativos para mais usuários ou grupos de usuários, se desejar.

Observação

Após a migração, se você mover grupos de aplicativos para um grupo de recursos diferente depois de atribuir permissões aos usuários, todas as funções RBAC serão removidas. Você precisará reatribuir as permissões RBAC dos usuários novamente.
Se você quiser excluir todos os objetos de serviço da Área de Trabalho Virtual do Azure (clássico), execute Complete-RdsHostPoolMigration para concluir o processo de migração. Este cmdlet excluirá todos os objetos da Área de Trabalho Virtual do Azure (clássica), deixando somente os novos objetos do Azure. Os usuários só poderão ver o feed dos grupos de aplicativos recém-criados em seus clientes. Depois que esse comando for feito, você poderá excluir com segurança o locatário da Área de Trabalho Virtual do Azure (clássica) para concluir o processo.

Por exemplo:
```
Complete-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Se você quiser concluir um pool de host específico, poderá incluir o nome do pool de host no cmdlet. Por exemplo, se você quiser concluir um pool de hosts chamado "Office", use um comando como este:
```
Complete-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
Isso excluirá todos os objetos de serviço criados pela Área de Trabalho Virtual do Azure (clássica). Você ficará apenas com os novos objetos do Azure, e os usuários só poderão ver o feed dos grupos de aplicativos recém-criados em seus clientes. Quando terminar de finalizar sua migração, você precisa excluir explicitamente o locatário na Área de Trabalho Virtual do Azure (clássica).
Se você mudou de ideia sobre a migração e deseja reverter o processo, execute o cmdlet Revert-RdsHostPoolMigration.

Por exemplo:
```
Revert-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Se você quiser reverter um pool de host específico, poderá incluir o nome do pool de host no comando. Por exemplo, se você quiser reverter um pool de hosts chamado "Office", insira algo assim:
```
Revert-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
Esse cmdlet excluirá todos os objetos de serviço do Azure recém-criados. Seus usuários verão apenas o feed para objetos da Área de Trabalho Virtual do Azure (clássica) em seus clientes.

No entanto, o cmdlet não excluirá o espaço de trabalho criado pelo módulo ou seu grupo de recursos associado. Você precisará excluir manualmente esses itens para se livrar deles.
Se você ainda não quiser excluir seus objetos de serviço da Área de Trabalho Virtual do Azure (clássico), mas quiser testar a migração, poderá executar Set-RdsHostPoolHidden.

Por exemplo:
```
Set-RdsHostPoolHidden -Tenant Contoso -Hostpool Office -Hidden $true -Location WestUS
```
Definir o status como "true" ocultará os recursos da Área de Trabalho Virtual do Azure (clássica). Defini-lo como "false" revelará os recursos aos usuários.

O parâmetro -Hostpool é opcional. Use esse parâmetro se houver um pool de host específico da Área de Trabalho Virtual do Azure (clássica) que você queira ocultar.

Esse cmdlet ocultará o feed do usuário e os objetos de serviço da Área de Trabalho Virtual do Azure (clássica) em vez de excluí-los. No entanto, isso geralmente é usado apenas para testes e não conta como uma migração concluída. Para concluir a migração, você precisará executar o comando Complete-RdsHostPoolMigration . Caso contrário, reverta sua implantação executando Revert-RdsHostPoolMigration.

Solucionar problemas de migração automática

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

Não consigo acessar o locatário

Primeiro, tente estas duas coisas:

Verifique se sua conta de administrador tem as permissões necessárias para acessar o locatário.
Tente executar Get-RdsTenant no locatário.

Se essas duas coisas funcionarem, tente executar o cmdlet Set-RdsMigrationContext para definir o Contexto do RDS e o Contexto ADAL para sua migração:

Crie o Contexto do RDS executando o cmdlet Add-RdsAccount .
Localize o contexto do RDS na variável global $rdMgmtContext.
Localize o Contexto ADAL na variável global $AdalContext.

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

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

Próximas etapas

Se você quiser saber como migrar sua implantação manualmente, consulte Migrar manualmente da Área de Trabalho Virtual do Azure (clássico).

Após a migração, saiba como a Área de Trabalho Virtual do Azure funciona conferindo nossos tutoriais. Saiba mais sobre os recursos avançados de gerenciamento em Expandir um pool de host existente e Personalizar propriedades RDP.

Para saber mais sobre objetos de serviço, marcar Ambiente da Área de Trabalho Virtual do Azure.

Comentários

Esta página foi útil?

Last updated on 2026-08-22