Automatická migrace z Azure Virtual Desktopu (Classic)

Článek
10/18/2023

Nástroj modulu migrace umožňuje automatickou migraci vaší organizace ze služby Azure Virtual Desktop (Classic) na službu Azure Virtual Desktop. V tomto článku se dozvíte, jak nástroj používat.

Požadavky

Než použijete modul migrace, ujistěte se, že máte připravené následující věci:

Předplatné Azure, ve kterém vytvoříte nové objekty služby Azure.
Abyste mohli vytvářet objekty Azure ve vašem předplatném, musíte mít přiřazenou roli Přispěvatel a roli User Access Správa istrator přiřadit uživatele ke skupinám aplikací.
Oprávnění přispěvatele vzdálené plochy (RDS) v tenantovi RDS nebo konkrétních fondech hostitelů, které migrujete.
Nejnovější verze modulu Microsoft.RdInfra.RDPowershell PowerShell.
Nejnovější verze modulu Az.DesktopVirtualization PowerShell.
Nejnovější verze modulu Az.Resources PowerShell.
Nainstalujte modul migrace do počítače.
PowerShell nebo prostředí PowerShell ISE ke spuštění skriptů, které najdete v tomto článku. Modul Microsoft.RdInfra.RDPowershell nefunguje v PowerShellu Core.

Důležité

Migrace vytváří pouze objekty služby v zeměpisné oblasti USA. Pokud se pokusíte migrovat objekty služby do jiné geografické oblasti, nebude fungovat. Pokud máte ve svém nasazení Azure Virtual Desktopu (Classic) více než 500 skupin aplikací, nebudete moct migrovat. Migraci budete moct provést pouze v případě, že prostředí znovu sestavíte, abyste snížili počet skupin aplikací v rámci tenanta Microsoft Entra.

Příprava prostředí PowerShellu

Nejprve budete muset připravit prostředí PowerShellu na proces migrace.

Příprava prostředí PowerShell:

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

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

Pokud ne, budete muset moduly nainstalovat a importovat spuštěním těchto rutin:

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

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

Potom pomocí této rutiny nainstalujte modul RDPowerShell:

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

Po dokončení instalace všeho spusťte tuto rutinu, abyste měli jistotu, že máte správné verze modulů:
```
Get-Module Microsoft.RDInfra.RDPowershell
```

Teď nainstalujme a naimportujme 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ž to budete hotovi, přihlaste se k Azure Virtual Desktopu (Classic) v okně PowerShellu:
```
Add-RdsAccount -DeploymentUrl https://rdbroker.wvd.microsoft.com
```
Přihlaste se k Azure Resource Manageru:
```
Login-AzAccount
```
Pokud máte více předplatných, vyberte předplatné, na které chcete migrovat prostředky pomocí této rutiny:
```
Select-AzSubscription -Subscriptionid <subID>
```
Zaregistrujte poskytovatele prostředků na webu Azure Portal pro vybrané předplatné.
Nakonec budete muset poskytovatele zaregistrovat. Můžete to udělat dvěma způsoby:
- Pokud chcete použít PowerShell, spusťte tuto rutinu:
```
Register-AzResourceProvider -ProviderNamespace Microsoft.DesktopVirtualization
```
- Pokud raději použijete Azure Portal, otevřete web Azure Portal a přihlaste se k webu Azure Portal, 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í se zatím nic nezmění, ale prostředí PowerShellu by teď mělo být připravené ke spuštění modulu.

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

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

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

Pokud chcete před migrací pochopit, jak se stávající klasické prostředky mapují na nové prostředky Azure Resource Manageru, spusťte tuto rutinu:
```
Get-RdsHostPoolMigrationMapping
```
Pomocí Get-RdsHostPoolMigrationMapping můžete vytvořit soubor CSV, který mapuje, kam budou vaše prostředky chodit. 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říklad:
```
Start-RdsHostPoolMigration -Tenant Contoso -Location WestUS
```
Pokud chcete migrovat prostředky do konkrétního fondu hostitelů, zadejte název fondu hostitelů. Pokud například chcete přesunout fond hostitelů s názvem "Office", spusťte příkaz podobný tomuto:
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments $false -Location EastUS
```
Pokud nezadáte název pracovního prostoru, modul vám ho automaticky vytvoří na základě názvu tenanta. Pokud ale chcete raději použít konkrétní pracovní prostor, můžete zadat 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
```
Budete také muset zadat režim přiřazení uživatele pro stávající přiřazení uživatelů:
- Pomocí příkazu Kopírovat zkopírujte všechna přiřazení uživatelů ze starých skupin aplikací do skupin aplikací Azure Resource Manageru. 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 uživatelům nebo skupinám uživatelů přiřadit skupiny aplikací pomocí webu Azure Portal, PowerShellu nebo rozhraní API. Uživatelé uvidí informační kanály jenom pomocí klientů Azure Virtual Desktopu (Classic).
Můžete zkopírovat jenom 2 000 uživatelských přiřazení na předplatné, takže váš limit bude záviset na tom, kolik přiřazení už máte v předplatném. Modul vypočítá limit na základě toho, kolik přiřazení už máte. Pokud nemáte dostatek přiřazení ke kopírování, zobrazí se chybová zpráva " Nedostatečná kvóta přiřazení role ke kopírování přiřazení uživatelů. Znovu spusťte 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 všechna přiřazení uživatelů, přidá se to do doby, kterou modul potřebuje k dokončení nastavení všeho.

Po dokončení rutiny Start-RdsHostPoolMigration byste měli vidět následující věci:
- Objekty služby Azure pro tenanta nebo fond hostitelů, které jste zadali.
- Dvě nové skupiny prostředků:
  - Skupina prostředků s názvem Název tenanta, 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 zabránilo výpadkům uživatelů během procesu migrace. To umožňuje uživatelům připojit se ke stejné uživatelské relaci.
Vzhledem k tomu, že tyto nové objekty služby Azure jsou objekty Azure Resource Manageru, modul u nich nemůže nastavit oprávnění řízení přístupu na základě role (RBAC) ani nastavení diagnostiky. Proto budete muset oprávnění a nastavení RBAC pro tyto objekty aktualizovat ručně.

Jakmile modul ověří počáteční uživatelská připojení, můžete skupinu aplikací publikovat i 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. Znovu budete muset 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 Complete-RdsHostPoolMigration . Tato rutina odstraní všechny objekty Azure Virtual Desktopu (classic) a ponechá jenom nové objekty Azure. Uživatelé uvidí informační kanál jenom pro nově vytvořené skupiny aplikací na svých klientech. Po dokončení tohoto příkazu můžete proces bezpečně odstranit tenanta Služby Azure Virtual Desktop (Classic).

Příklad:
```
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 dokončit fond hostitelů s názvem "Office", použili byste příkaz podobný tomuto:
```
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ůstanete jenom s novými objekty Azure a uživatelé uvidí kanál jenom pro nově vytvořené skupiny aplikací na svých klientech. Jakmile dokončíte dokončení migrace, musíte tenanta explicitně odstranit ve službě Azure Virtual Desktop (Classic).
Pokud jste změnili názor na migraci a chcete proces vrátit zpět, spusťte rutinu Revert-RdsHostPoolMigration .

Příklad:
```
Revert-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
Pokud chcete vrátit konkrétní fond hostitelů, můžete do příkazu zahrnout název fondu hostitelů. Pokud například chcete vrátit fond hostitelů s názvem Office, zadejte 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í informační kanál jenom pro objekty Azure Virtual Desktopu (klasické) ve svých klientech.

Rutina ale neodstraní pracovní prostor, který modul vytvořil nebo jeho přidruženou skupinu prostředků. Abyste je mohli 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říklad:
```
Set-RdsHostPoolHidden -Tenant Contoso -Hostpool Office -Hidden $true -Location WestUS
```
Nastavení stavu na true skryje prostředky Služby Azure Virtual Desktop (Classic). Když ho nastavíte na false, zobrazí se uživatelům prostředky.

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 místo odstranění skryje informační kanál uživatelů a objekty služby Azure Virtual Desktop (Classic). Obvykle se ale používá jenom k testování a nezapočítává 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í zpět spuštěním příkazu Revert-RdsHostPoolMigration.

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

Tato část vysvětluje, jak řešit běžné problémy v modulu migrace.

Nemůžu získat přístup k tenantovi

Nejprve 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 v tenantovi spustit Rutinu Get-RdsTenant .

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

Vytvořte kontext RDS spuštěním rutiny Add-RdsAccount .
Vyhledejte kontext RDS v globální proměnné $rdMgmtContext.
Vyhledejte 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 chcete zjistit, jak místo toho migrovat nasazení ručně, přečtěte si téma Ruční migrace z Azure Virtual Desktopu (Classic).

Po migraci se dozvíte, jak Azure Virtual Desktop funguje, a to v našich kurzech. Další informace o pokročilých možnostech správy najdete v tématu Rozbalení existujícího fondu hostitelů a přizpůsobení vlastností protokolu RDP.

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

Sdílet prostřednictvím