Automatická migrace z Azure Virtual Desktopu (Classic)

Důležité

Klasické verze služby Azure Virtual Desktop se vyřazují 30. září 2026. Připojení ke klasickým prostředkům budou po vyřazení blokovaná.

Pokud chcete zabránit přerušení, migrujte zbývající klasické prostředky do fondů hostitelů založených na Azure Resource Manager do 30. září 2026.

Nástroj modulu migrace umožňuje migrovat organizaci z Azure Virtual Desktopu (klasické) na Azure Virtual Desktop automaticky. V tomto článku se dozvíte, jak tento nástroj používat.

Požadavky

Před použitím modulu migrace připravte následující věci:

Předplatné Azure, ve kterém budete vytvářet nové objekty služby Azure.
Abyste mohli vytvářet objekty Azure ve svém předplatném, musíte mít přiřazenou roli Přispěvatel a roli Správce uživatelských přístupů, abyste mohli přiřazovat uživatele ke skupinám aplikací.
Alespoň oprávnění Přispěvatel Vzdálené plochy (RDS) pro tenanta Vzdálené plochy nebo konkrétní fondy hostitelů, které migrujete.
Nejnovější verze modulu PowerShellu Microsoft.RdInfra.RDPowershell.
Nejnovější verze modulu PowerShellu Az.DesktopVirtualization.
Nejnovější verze modulu PowerShellu Az.Resources.
Nainstalujte do počítače modul migrace.
PowerShell nebo PowerShell ISE ke spuštění skriptů, které najdete v tomto článku. Modul Microsoft.RdInfra.RDPowershell v PowerShell Core nefunguje.

Důležité

Při migraci se vytvoří jenom objekty služeb v zeměpisné oblasti USA. Pokud se pokusíte migrovat objekty služby do jiné zeměpisné oblasti, nebude to fungovat. Pokud máte v nasazení služby Azure Virtual Desktop (Classic) více než 500 skupin aplikací, nebudete moct migrovat. Migrovat budete moct jenom v případě, že prostředí znovu sestavíte, abyste snížili počet skupin aplikací v rámci tenanta aplikace Microsoft Entra.

Příprava prostředí PowerShellu

Nejdřív musíte připravit prostředí PowerShellu na proces migrace.

Příprava prostředí PowerShell:

Než začnete, spuštěním následujících rutin se ujistěte, že máte nejnovější verzi modulů Az.Desktop Virtualization a Az.Resources:

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

Pokud je nemáte, budete muset nainstalovat a importovat moduly spuštěním těchto rutin:

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

Dále odinstalujte aktuální modul RDInfra PowerShell spuštěním této rutiny:
```
Uninstall-Module -Name Microsoft.RDInfra.RDPowershell -AllVersions
```

Potom nainstalujte modul RDPowershell pomocí této rutiny:

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

Až všechno nainstalujete, spusťte tuto rutinu, abyste měli jistotu, že máte správné verze modulů:
```
Get-Module Microsoft.RDInfra.RDPowershell
```

Teď nainstalujeme a naimportujeme modul migrace spuštěním těchto rutin:

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

Až budete hotovi, přihlaste se ke službě Azure Virtual Desktop (Classic) v okně PowerShellu:
```
Add-RdsAccount -DeploymentUrl https://rdbroker.wvd.microsoft.com
```
Přihlaste se na Azure Resource Manager:
```
Login-AzAccount
```
Pokud máte více předplatných, vyberte předplatné, do kterého chcete migrovat prostředky pomocí této rutiny:
```
Select-AzSubscription -Subscriptionid <subID>
```
Zaregistrujte poskytovatele prostředků v Azure Portal pro vybrané předplatné.
Nakonec budete muset zaregistrovat poskytovatele. Můžete to udělat dvěma způsoby:
- Pokud chcete použít PowerShell, spusťte tuto rutinu:
```
Register-AzResourceProvider -ProviderNamespace Microsoft.DesktopVirtualization
```
- Pokud chcete raději používat Azure Portal, otevřete a přihlaste se k Azure Portal, pak přejděte na Předplatná a vyberte název předplatného, které chcete použít. Potom přejděte na poskytovatele> prostředkůMicrosoft.DesktopVirtualization a vyberte Znovu zaregistrovat. V uživatelském rozhraní zatím neuvidíte žádnou změnu, ale vaše prostředí PowerShell by teď mělo být připravené na spuštění modulu.

Migrace prostředků Azure Virtual Desktopu (Classic) do Azure Resource Manager

Teď, když je vaše prostředí PowerShellu připravené, můžete zahájit proces migrace.

Migrace prostředků Azure virtuální plochy (klasické) do Azure Resource Manager:

Pokud chcete před migrací zjistit, jak se stávající prostředky Classic namapují na nové prostředky Azure Resource Manager, spusťte tuto rutinu:
```
Get-RdsHostPoolMigrationMapping
```
Pomocí Get-RdsHostPoolMigrationMapping můžete vytvořit soubor CSV, který mapuje, kam vaše prostředky půjdou. Pokud je například název vašeho tenanta "Contoso" a chcete soubor mapování uložit do souboru contosouser, spustíte rutinu, která vypadá takto:
```
Get-RdsHostPoolMigrationMapping -Tenant Contoso -HostPool Office -Location EastUS -OutputFile 'C:\\Users\contosouser\OneDrive - Microsoft\Desktop\mapping.csv'
```
Dále spusťte rutinu Start-RdsHostPoolMigration a zvolte, jestli se má migrovat jeden fond hostitelů nebo všechny fondy hostitelů v rámci tenanta.

Příklady:
```
Start-RdsHostPoolMigration -Tenant Contoso -Location WestUS
```
Pokud chcete migrovat prostředky do konkrétního fondu hostitelů, uveďte název fondu hostitelů. Pokud chcete přesunout například fond hostitelů s názvem "Office", spusťte takovýto příkaz:
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments $false -Location EastUS
```
Pokud název pracovního prostoru nezadáte, modul vám ho automaticky vytvoří na základě názvu tenanta. Pokud ale chcete použít konkrétní pracovní prostor, můžete zadat jeho ID prostředku takto:
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments -Location EastUS -Workspace <Resource ID of workspacename>
```
Pokud chcete použít konkrétní pracovní prostor, ale neznáte jeho ID prostředku, spusťte tuto rutinu:
```
Get-AzWvdWorkspace -WorkspaceName <workspace> -ResourceGroupName <resource group> |fl
```
Pro stávající přiřazení uživatelů budete také muset určit režim přiřazení uživatelů:
- Pomocí příkazu Kopírovat můžete zkopírovat všechna přiřazení uživatelů ze starých skupin aplikací do Azure Resource Manager skupin aplikací. Uživatelé budou moct zobrazit informační kanály pro obě verze svých klientů.
- Pokud nechcete měnit přiřazení uživatelů, použijte možnost Žádné . Později můžete přiřadit uživatele nebo skupiny uživatelů ke skupinám aplikací pomocí Azure Portal, PowerShellu nebo rozhraní API. Uživatelé budou moct informační kanály zobrazit jenom pomocí klientů služby Azure Virtual Desktop (classic).
V rámci jednoho předplatného můžete zkopírovat jenom 2 000 přiřazení uživatelů, takže váš limit bude záviset na tom, kolik přiřazení už ve svém předplatném máte. Modul vypočítá limit na základě počtu zadání, která již máte. Pokud nemáte dostatek přiřazení ke zkopírování, zobrazí se chybová zpráva "Kvóta přiřazení rolí není dostatečná pro zkopírování přiřazení uživatelů. Znovu spustit příkaz bez přepínače -CopyUserAssignments pro migraci."
Po spuštění příkazů bude trvat až 15 minut, než modul vytvoří objekty služby. Pokud jste zkopírovali nebo přesunuli přiřazení uživatelů, prodlouží se tím doba, kterou modul potřebuje k dokončení nastavení.

Po dokončení rutiny Start-RdsHostPoolMigration by se měly zobrazit následující věci:
- Objekty služby Azure pro zadaného tenanta nebo fond hostitelů.
- Dvě nové skupiny prostředků:
  - Skupina prostředků s názvem Tenantname, která obsahuje váš pracovní prostor.
  - Skupina prostředků s názvem "Tenantname_originalHostPoolName", která obsahuje fond hostitelů a skupiny desktopových aplikací.
- Všichni uživatelé, které jste publikovali do nově vytvořených skupin aplikací.
- Virtuální počítače budou dostupné ve stávajících i nových fondech hostitelů, aby se předešlo výpadkům uživatelů během procesu migrace. To uživatelům umožní připojit se ke stejné relaci uživatele.
Vzhledem k tomu, že tyto nové objekty služby Azure jsou Azure Resource Manager objekty, modul na ně nemůže nastavit oprávnění Access Control založené na rolích (RBAC) ani nastavení diagnostiky. Proto budete muset oprávnění RBAC a nastavení pro tyto objekty aktualizovat ručně.

Jakmile modul ověří počáteční připojení uživatelů, můžete také publikovat skupinu aplikací pro více uživatelů nebo skupin uživatelů, pokud chcete.

Poznámka

Pokud po migraci přesunete skupiny aplikací do jiné skupiny prostředků po přiřazení oprávnění uživatelům, odebere se všechny role RBAC. Budete muset znovu přiřadit oprávnění RBAC uživatelů.
Pokud chcete odstranit všechny objekty služby Azure Virtual Desktop (Classic), dokončete proces migrace spuštěním příkazu Complete-RdsHostPoolMigration. Tato rutina odstraní všechny objekty služby Azure Virtual Desktop (classic) a ponechá jenom nové objekty Azure. Uživatelé uvidí informační kanál nově vytvořených skupin aplikací jenom na svých klientech. Po dokončení tohoto příkazu můžete bezpečně odstranit tenanta služby Azure Virtual Desktop (Classic) a proces dokončit.

Příklady:
```
Complete-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Pokud chcete dokončit konkrétní fond hostitelů, můžete do rutiny zahrnout název fondu hostitelů. Pokud například chcete vytvořit fond hostitelů s názvem "Office", použili byste takovýto příkaz:
```
Complete-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
Tím se odstraní všechny objekty služby vytvořené službou Azure Virtual Desktop (Classic). Zůstanou vám jenom nové objekty Azure a uživatelé uvidí informační kanál pro nově vytvořené skupiny aplikací na svých klientech. Po dokončení migrace musíte explicitně odstranit tenanta ve službě Azure Virtual Desktop (Classic).
Pokud jste si migraci rozmysleli a chcete proces vrátit zpět, spusťte rutinu Revert-RdsHostPoolMigration .

Příklady:
```
Revert-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Pokud chcete vrátit zpět konkrétní fond hostitelů, můžete do příkazu zahrnout název fondu hostitelů. Pokud například chcete vrátit zpět fond hostitelů s názvem "Office", zadali byste něco takového:
```
Revert-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
Tato rutina odstraní všechny nově vytvořené objekty služby Azure. Vaši uživatelé uvidí ve svých klientech jenom informační kanál pro objekty služby Azure Virtual Desktop (classic).

Rutina ale neodstraní pracovní prostor, který modul vytvořil, ani přidruženou skupinu prostředků. Pokud se chcete těchto položek zbavit, budete je muset odstranit ručně.
Pokud ještě nechcete odstranit objekty služby Azure Virtual Desktop (Classic), ale chcete otestovat migraci, můžete spustit Set-RdsHostPoolHidden.

Příklady:
```
Set-RdsHostPoolHidden -Tenant Contoso -Hostpool Office -Hidden $true -Location WestUS
```
Nastavení stavu na true skryje prostředky služby Azure Virtual Desktop (classic). Pokud ho nastavíte na hodnotu "false", zobrazí se prostředky vašim uživatelům.

Parametr -Hostpool je volitelný. Tento parametr můžete použít, pokud existuje konkrétní fond hostitelů služby Azure Virtual Desktop (Classic), který chcete skrýt.

Tato rutina skryje objekty informačního kanálu a služby uživatele Azure Virtual Desktopu (Classic), místo aby je odstranila. Obvykle se ale používá jenom pro testování a nepočítá se jako dokončená migrace. K dokončení migrace budete muset spustit příkaz Complete-RdsHostPoolMigration . V opačném případě vraťte nasazení spuštěním příkazu Revert-RdsHostPoolMigration.

Řešení potíží s automatickou migrací

Tato část popisuje, jak řešit běžné problémy s modulem migrace.

Nemám přístup k tenantovi

Nejdřív zkuste tyto dvě věci:

Ujistěte se, že váš účet správce má požadovaná oprávnění pro přístup k tenantovi.
Zkuste spustit Get-RdsTenant v tenantovi.

Pokud tyto dvě věci fungují, zkuste spuštěním rutiny Set-RdsMigrationContext nastavit kontext RDS a kontext ADAL pro migraci:

Vytvořte kontext RDS spuštěním rutiny Add-RdsAccount .
Najděte kontext RDS v globální proměnné $rdMgmtContext.
Najděte kontext ADAL v globální proměnné $AdalContext.
Spusťte Set-RdsMigrationContext s proměnnými, které jste našli v tomto formátu:
```
Set-RdsMigrationContext -RdsContext <rdscontext> -AdalContext <adalcontext>
```

Další kroky

Pokud se chcete dozvědět, jak místo toho migrovat nasazení ručně, přečtěte si téma Ruční migrace z Azure Virtual Desktopu (Classic).

Po dokončení migrace se v našich kurzech seznámíte s tím, jak služba Azure Virtual Desktop funguje. Informace o pokročilých možnostech správy najdete v tématech Rozšíření stávajícího fondu hostitelů a přizpůsobení vlastností protokolu RDP.

Další informace o objektech služby najdete v prostředí služby Azure Virtual Desktop.

Váš názor

Byla tato stránka užitečná?

Poslední aktualizace v 2026-09-18