Azure Virtual Desktop (クラシック) から自動的に移行する

[アーティクル]
04/21/2023

移行モジュールツールを使用すると、組織を Azure Virtual Desktop (クラシック) から Azure Virtual Desktop に自動的に移行できます。この記事では、このツールを使用する方法を示します。

前提条件

移行モジュールを使用する前に、次のものが準備できていることを確認してください。

新しい Azure サービスオブジェクトを作成する Azure サブスクリプション。
サブスクリプションで Azure オブジェクトを作成するための共同作成者ロールと、アプリケーショングループにユーザーを割り当てるためのユーザーアクセス管理者ロールが割り当てられている必要があります。
RDS テナント、または移行している特定のホストプールに対する少なくともリモートデスクトップサービス (RDS) 共同作成者のアクセス許可。
最新バージョンの Microsoft.RdInfra.RDPowershell PowerShell モジュール。
最新バージョンの Az.DesktopVirtualization PowerShell モジュール。
最新バージョンの Az.Resources PowerShell モジュール。
コンピューターに移行モジュールをインストールする。
この記事で説明するスクリプトを実行するための PowerShell または PowerShell ISE。 PowerShell Core では Microsoft.RdInfra.RDPowershell モジュールが動作しません。

重要

移行では、米国地域内のサービスオブジェクトのみが作成されます。サービスオブジェクトを別の地域に移行しようとしても、そのオブジェクトは動作しません。また、Azure Virtual Desktop (クラシック) デプロイに 500 を超えるアプリケーショングループがある場合も移行できません。移行できるのは、その環境を再構築して Microsoft Entra テナント内のアプリケーショングループの数を削減した場合だけてす。

PowerShell 環境を準備する

まず、移行プロセス用の PowerShell 環境を準備する必要があります。

PowerShell 環境を準備するには:

開始する前に、次のコマンドレットを実行して、最新バージョンの Az.Desktop Virtualization および Az.Resources モジュールがあることを確認します。
```
Get-Module Az.Resources
Get-Module Az.DesktopVirtualization
https://www.powershellgallery.com/packages/Az.DesktopVirtualization/
https://www.powershellgallery.com/packages/Az.Resources/
```
ない場合は、次のコマンドレットを実行して、これらのモジュールをインストールしてインポートする必要があります。
```
Install-module Az.Resources
Import-module Az.Resources
Install-module Az.DesktopVirtualization
Import-module Az.DesktopVirtualization
```
次に、次のコマンドレットを実行して、現在の RDInfra PowerShell モジュールをアンインストールします。
```
Uninstall-Module -Name Microsoft.RDInfra.RDPowershell -AllVersions
```

その後、次のコマンドレットを使用して RDPowershell モジュールをインストールします。

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

インストールをすべて完了したら、次のコマンドレットを実行して、適切なバージョンのモジュールがあることを確認します。
```
Get-Module Microsoft.RDInfra.RDPowershell
```

ここで、次のコマンドレットを実行して、移行モジュールをインストールしてインポートしましょう。

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

完了したら、PowerShell ウィンドウで Azure Virtual Desktop (クラシック) にサインインします。
```
Add-RdsAccount -DeploymentUrl https://rdbroker.wvd.microsoft.com
```
Azure Resource Manager にサインインします。
```
Login-AzAccount
```
複数のサブスクリプションがある場合は、次のコマンドレットを使用して、リソースの移行先のサブスクリプションを選択します。
```
Select-AzSubscription -Subscriptionid <subID>
```
選択したサブスクリプションの Azure portal で、リソースプロバイダーを登録します。
最後に、プロバイダーを登録する必要があります。これを実行するには、次の 2 つの方法があります。
- PowerShell を使用する場合は、次のコマンドレットを実行します。
```
Register-AzResourceProvider -ProviderNamespace Microsoft.DesktopVirtualization
```
- 代わりに Azure portal を使用する場合は、Azure portal を開いてサインインした後、 [サブスクリプション] に移動し、使用するサブスクリプションの名前を選択します。その後、 [リソースプロバイダー]>[Microsoft.DesktopVirtualization] の順に移動し、 [再登録] を選択します。 UI にはまだ何も変更が表示されませんが、これで、PowerShell 環境でこのモジュールを実行する準備ができました。

Azure Virtual Desktop (クラシック) リソースを Azure Resource Manager に移行する

これで PowerShell 環境の準備ができたので、移行プロセスを開始できます。

Azure Virtual Desktop (クラシック) リソースを Azure Resource Manager に移行するには:

移行する前に、既存のクラシックリソースが新しい Azure Resource Manager リソースにどのようにマップされるかを理解したい場合は、次のコマンドレットを実行します。
```
Get-RdsHostPoolMigrationMapping
```
Get-RdsHostPoolMigrationMapping を使用すると、リソースの行先をマップする CSV ファイルを作成できます。たとえば、テナントの名前が "Contoso" であり、マッピングファイルを "contosouser" ファイルに格納する場合は、次のようなコマンドレットを実行します。
```
Get-RdsHostPoolMigrationMapping -Tenant Contoso -HostPool Office -Location EastUS -OutputFile 'C:\\Users\contosouser\OneDrive - Microsoft\Desktop\mapping.csv'
```
次に、Start-RdsHostPoolMigration コマンドレットを実行して、1 つのホストプールまたはテナント内のすべてのホストプールのどちらを移行するかを選択します。

次に例を示します。
```
Start-RdsHostPoolMigration -Tenant Contoso -Location WestUS
```
特定のホストプールのリソースを移行する場合は、ホストプール名を含めます。たとえば、"Office" という名前のホストプールを移行する場合は、次のようなコマンドを実行します。
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments $false -Location EastUS
```
ワークスペース名が指定されない場合、このモジュールでは、テナント名に基づいて自動的に作成されます。ただし、特定のワークスペースを使用する場合は、そのリソース ID を次のように入力できます。
```
Start-RdsHostPoolMigration -Tenant Contoso -HostPool Office -CopyUserAssignments -Location EastUS -Workspace <Resource ID of workspacename>
```
特定のワークスペースを使用したいが、そのリソース ID がわからない場合は、次のコマンドレットを実行します。
```
Get-AzWvdWorkspace -WorkspaceName <workspace> -ResourceGroupName <resource group> |fl
```
また、既存のユーザー割り当てのユーザー割り当てモードも指定する必要があります。
- 古いアプリケーショングループのすべてのユーザー割り当てを Azure Resource Manager アプリケーショングループにコピーするには、[コピー] を使用します。ユーザーは、自分のクライアントの両方のバージョンのフィードを表示できます。
- ユーザー割り当てを変更しない場合は、[なし] を使用します。後で、Azure portal、PowerShell、または API を使用して、ユーザーまたはユーザーグループをアプリケーショングループに割り当てることができます。ユーザーは、Azure Virtual Desktop (クラシック) クライアントを使用したフィードのみを表示できます。
サブスクリプションあたり 2,000 のユーザー割り当てしかコピーできないため、実際の制限は、サブスクリプションに既に存在する割り当ての数によって異なります。このモジュールでは、既に存在する割り当ての数に基づいて制限を計算します。コピーするための十分な割り当てがない場合は、次のエラーメッセージが表示されます。"ユーザー割り当てをコピーするためのロールの割り当てクォータが不足しています。 -CopyUserAssignments スイッチなしでコマンドを再実行して移行してください。"
コマンド実行後、モジュールによってサービスオブジェクトを作成するまで、最大 15 分かかります。ユーザー割り当てをコピーまたは移動した場合は、それにより、このモジュールがすべての設定を完了するためにかかる時間が追加されます。

Start-RdsHostPoolMigration コマンドレットを実行すると、次の結果が得られます。
- 指定したテナントまたはホストプールの Azure サービスオブジェクト。
- 2 つの新しいリソースグループ:
  - ワークスペースを含む、"Tenantname" という名前のリソースグループ。
  - ホストプールとデスクトップアプリケーショングループを含む、"Tenantname_originalHostPoolName" という名前のリソースグループ。
- 新しく作成されたアプリケーショングループに公開したすべてのユーザー。
- 移行プロセス中のユーザーのダウンタイムを回避するために、仮想マシンは既存と新規の両方のホストプールで使用できます。これにより、ユーザーは同じユーザーセッションに接続できます。
これらの新しい Azure サービスオブジェクトは Azure Resource Manager オブジェクトであるため、このモジュールは、それらに対してロールベースのアクセス制御 (RBAC) アクセス許可や診断設定を設定できません。そのため、これらのオブジェクトの RBAC アクセス許可および設定を手動で更新する必要があります。

このモジュールで初期のユーザー接続が検証されたら、必要に応じて、アプリケーショングループをさらに多くのユーザーまたはユーザーグループに公開することもできます。

Note

移行の後、ユーザーにアクセス許可を割り当てた後にアプリケーショングループを別のリソースグループに移動すると、それによってすべての RBAC ロールが削除されます。ユーザーの RBAC アクセス許可を始めから再割り当てする必要があります。
すべての Azure Virtual Desktop (クラシック) サービスオブジェクトを削除する場合は、Complete-RdsHostPoolMigration を実行して移行プロセスを完了します。このコマンドレットでは、すべての Azure Virtual Desktop (クラシック) オブジェクトを削除し、新しい Azure オブジェクトのみを残します。ユーザーは、新しく作成されたアプリケーショングループのフィードのみを自分のクライアントに表示できます。このコマンドが完了したら、Azure Virtual Desktop (クラシック) テナントを安全に削除してプロセスを完了できます。

次に例を示します。
```
Complete-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
特定のホストプールを完了する場合は、このコマンドレットにホストプール名を含めることができます。たとえば、"Office" という名前のホストプールを完了する場合は、次のようなコマンドを使用します。
```
Complete-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
これにより、Azure Virtual Desktop (クラシック) によって作成されたすべてのサービスオブジェクトが削除されます。新しい Azure オブジェクトのみが残され、ユーザーは、新しく作成されたアプリケーショングループのフィードのみを自分のクライアントに表示できます。移行の最終処理を完了したら、Azure Virtual Desktop (クラシック) 内のテナントを明示的に削除する必要があります。
移行について気が変わり、プロセスを元に戻したい場合は、Revert-RdsHostPoolMigration コマンドレットを実行します。

次に例を示します。
```
Revert-RdsHostPoolMigration -Tenant Contoso -Location EastUS
```
特定のホストプールを元に戻す場合は、このコマンドにホストプール名を含めることができます。たとえば、"Office" という名前のホストプールを元に戻す場合は、次のように入力します。
```
Revert-RdsHostPoolMigration -Tenant Contoso -HostPool Office -Location EastUS
```
このコマンドレットでは、新しく作成されたすべての Azure サービスオブジェクトを削除します。ユーザーのクライアントには、Azure Virtual Desktop (クラシック) オブジェクトのフィードのみが表示されます。

ただし、このコマンドレットでは、このモジュールが作成したワークスペースやそれに関連付けられているリソースグループは削除されません。それを削除するには、これらの項目を手動で削除する必要があります。
Azure Virtual Desktop (クラシック) サービスオブジェクトをまだ削除せずに、移行をテストする場合は、Set-RdsHostPoolHidden を実行できます。

次に例を示します。
```
Set-RdsHostPoolHidden -Tenant Contoso -Hostpool Office -Hidden $true -Location WestUS
```
状態を "true" に設定すると、Azure Virtual Desktop (クラシック) リソースが非表示になります。これを "false" に設定すると、リソースがユーザーに表示されます。

-Hostpool パラメーターは省略可能です。非表示にしたい特定の Azure Virtual Desktop (クラシック) ホストプールがある場合は、このパラメーターを使用できます。

このコマンドレットでは、Azure Virtual Desktop (クラシック) ユーザーのフィードやサービスオブジェクトを削除するのではなく、非表示にします。ただし、これは通常、テストのためにのみ使用され、完了した移行としては見なされません。移行を完了するには、Complete-RdsHostPoolMigration コマンドを実行する必要があります。それ以外の場合は、Revert-RdsHostPoolMigration を実行してデプロイを元に戻します。

自動移行をトラブルシューティングする

このセクションでは、移行モジュールでよく発生する問題を解決する方法について説明します。

テナントにアクセスできない

まず、次の 2 つのことを試してください。

管理者アカウントにテナントへのアクセスに必要なアクセス許可があることを確認してください。
テナントで Get-RdsTenant を実行してみてください。

これらの 2 つのことが機能する場合は、移行のための RDS コンテキストと ADAL コンテキストを設定するために Set-RdsMigrationContext コマンドレットを実行してみてください。

Add-RdsAccount コマンドレットを実行して RDS コンテキストを作成します。
グローバル変数 $rdMgmtContext で RDS コンテキストを見つけます。
グローバル変数 $AdalContext で ADAL コンテキストを見つけます。
見つかった変数を次の形式で使用して Set-RdsMigrationContext を実行します。
```
Set-RdsMigrationContext -RdsContext <rdscontext> -AdalContext <adalcontext>
```

次のステップ

代わりに手動でデプロイを移行する方法を知りたい場合は、「Azure Virtual Desktop (クラシック) から手動で移行する」を参照してください。

移行が完了した後、チュートリアルを確認して、Azure Virtual Desktop がどのように動作するかを理解します。「既存のホストプールを展開する」とRDP のプロパティのカスタマイズに関する記事で、高度な管理機能について学習します。

サービスオブジェクトの詳細については、「Azure Virtual Desktop の環境」を確認してください。