ホストプールにセッションホストを追加する

[アーティクル]
03/14/2023

ホストプール、ワークスペース、およびアプリケーショングループを作成したら、ユーザーが接続するためのセッションホストをホストプールに追加する必要があります。さらに容量を増やすために、セッションホストを追加する必要がある場合もあります。

セッションホストとして使用する新しい仮想マシンを作成し、Azure portal の Azure Virtual Desktop サービスを使用して、それらをネイティブにホストプールに追加できます。または、自動化されたパイプラインなど、Azure Virtual Desktop サービスの外部に仮想マシンを作成し、それらをセッションホストとしてホストプールに追加することもできます。 Azure CLI または Azure PowerShell を使用する場合は、Azure Virtual Desktop の外部に仮想マシンを作成し、それらをセッションホストとしてホストプールに個別に追加する必要があります。

この記事では、Azure portal、Azure CLI、または Azure PowerShell を使用して登録キーを生成する方法、Azure Virtual Desktop サービスを使用してセッションホストをホストプールに追加する方法、またはセッションホストをホストプールに個別に追加する方法について説明します。

前提条件

オペレーティングシステム、仮想ネットワーク、ID プロバイダーなど、必要要件の概要については、「Azure Virtual Desktop の前提条件」を参照してください。さらに、次のものが必要になります。

既存のホストプール。
ホストプールに既存のセッションホストがある場合は、仮想マシンのサイズ、イメージ、および使用された名前のプレフィックスをメモします。ホストプール内のすべてのセッションホストは、同じ ID プロバイダーを含め、同じ構成にする必要があります。たとえば、ホストプールには、Azure AD に参加しているセッションホストと、Active Directory ドメインに参加しているセッションホストを含めることはできません。

使用する Azure アカウントに、少なくともリソースグループに対する、次の組み込みのロールベースのアクセス制御 (RBAC) ロールが必要です。

アクション	RBAC ロール (1 つまたは複数)
ホストプールの登録キーを生成する	Desktop Virtualization Host Pool Contributor
Azure portal を使用してセッションホストを作成して追加する	Desktop Virtualization Host Pool Contributor Virtual Machine Contributor

または、共同作成者 RBAC ロールを割り当てることができます。

PowerShell DSC で必要であるため、Azure portal を使用してセッションホストを作成および追加するときは、Windows リモート管理 (WinRM) を無効にしないでください。
Azure CLI または Azure PowerShell をローカルで使用する場合は、「Azure Virtual Desktop で Azure CLI と Azure PowerShell を使用する」を参照して、desktopvirtualization Azure CLI 拡張機能または Az.DesktopVirtualization PowerShell モジュールがインストールされていることを確認してください。別の方法として、Azure Cloud Shell を使用します。

重要

Azure Active Directory 参加済みセッションホストを作成する場合は、Azure Virtual Desktop サービスで Azure portal を使用する場合にのみサポートされます。

登録キーの生成

セッションホストをホストプールに追加する場合は、まず登録キーを生成する必要があります。登録キーはホストプールごとに生成する必要があり、セッションホストがそのホストプールに参加することを認可します。これは、指定した期間のみ有効です。既存の登録キーの有効期限が切れている場合は、次の手順を使用して新しいキーを生成することもできます。

登録キーを生成するには、シナリオに関連するタブを選択し、手順に従います。

Azure portal を使用して登録キーを生成する方法を次に示します。

Azure portal にサインインします。
検索バーに「Azure Virtual Desktop」と入力し、一致するサービスエントリを選択します。
[ホストプール] を選択し、登録キーを生成するホストプールの名前を選択します。
ホストプールの概要で、[登録キー] を選択します。
[新しいキーの生成] を選択し、有効期限を入力して [OK] を選択します。登録キーが作成されます。
[ダウンロード] を選択して登録キーを含むテキストファイルをダウンロードするか、登録キーをクリップボードにコピーして後で使用します。ホストプールの概要に戻って、後で登録キーを取得することもできます。

Azure CLI の desktopvirtualization 拡張機能を使用して登録キーを生成する方法を次に示します。

重要

次の例では、<placeholder> を独自の値に変更する必要があります。

Bash ターミナルの種類を指定して、Azure portal で Azure Cloud Shell を起動するか、ローカルデバイスで Azure CLI を実行します。
1. Cloud Shell を使用している場合は、使用するサブスクリプションに Azure コンテキストが設定されていることを確認します。
2. Azure CLI をローカルで使用している場合は、まず Azure CLI でサインインしてから、使用するサブスクリプションに Azure コンテキストが設定されていることを確認します。

次の例で az desktopvirtualization workspace update コマンドを使用して、24 時間有効な登録キーを生成します。

az desktopvirtualization hostpool update \
    --name <Name> \
    --resource-group <ResourceGroupName> \
    --registration-info expiration-time=$(date -d '+24 hours' --iso-8601=ns) registration-token-operation="Update"

登録キーを取得し、後で使用するためにクリップボードにコピーします。登録キーが有効な間は、いつでもこのコマンドを再度実行することで、登録キーを後で取得することもできます。
```
az desktopvirtualization hostpool retrieve-registration-token \
    --name <Name> \
    --resource-group <ResourceGroupName> \
    --query token --output tsv
```

Az.DesktopVirtualization PowerShell モジュールを使用して登録キーを生成する方法を次に示します。

重要

次の例では、<placeholder> を独自の値に変更する必要があります。

PowerShell ターミナルの種類を指定して、Azure portal で Azure Cloud Shell を起動するか、ローカルデバイスで Azure CLI を実行します。
1. Cloud Shell を使用している場合は、使用するサブスクリプションに Azure コンテキストが設定されていることを確認します。
2. Azure PowerShell をローカルで使用している場合は、まず Azure PowerShell でサインインしてから、使用するサブスクリプションに Azure コンテキストが設定されていることを確認します。

次の例で New-AzWvdRegistrationInfo コマンドレットを使用して、24 時間有効な登録キーを生成します。

$parameters = @{
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
    ExpirationTime = $((Get-Date).ToUniversalTime().AddHours(24).ToString('yyyy-MM-ddTHH:mm:ss.fffffffZ'))
}

New-AzWvdRegistrationInfo @parameters

登録キーを取得し、後で使用するためにクリップボードにコピーします。登録キーが有効な間は、いつでもこのコマンドを再度実行することで、登録キーを後で取得することもできます。
```
$parameters = @{
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
}

(Get-AzWvdHostPoolRegistrationToken @parameters).Token
```

Azure Virtual Desktop サービスにセッションホストを作成して登録する

Azure Virtual Desktop サービスでは、Azure portal または ARM テンプレートを使用して、セッションホストの作成とホストプールへの登録を単一のエンドツーエンドプロセスで行うことができます。 ARM テンプレートの例は、GitHub リポジトリにあります。

重要

自動パイプラインなど、Azure Virtual Desktop の外部で別の方法を使用して仮想マシンを作成する場合は、それらをセッションホストとしてホストプールに個別に登録する必要があります。「セッションホストをホストプールに登録する」セクションに進みます。

セッションホストを作成し、Azure portal の Azure Virtual Desktop サービスを使用してホストプールに登録する方法を次に示します。最初に登録キーが生成されていることを確認します。

Azure portal にサインインします。
検索バーに「Azure Virtual Desktop」と入力し、一致するサービスエントリを選択します。
[ホストプール] を選択し、セッションホストを追加するホストプールの名前を選択します。
ホストプールの概要で、[セッションホスト] を選択し、[+ 追加] を選択します。
既存のホストプールを使用しているため、[基本] タブはグレー表示されます。 [次へ: 仮想マシン ] を選びます。

[仮想マシン] タブで、次の情報を記入します。

パラメーター	値/説明
Resource group	これにより、ホストプールと同じリソースグループが自動的に既定で設定されますが、ドロップダウンリストから別の既存のリソースグループを選択することもできます。
名前のプレフィックス	セッションホストの名前を入力します (例: aad-hp01-sh)。これは、セッションホスト VM のプレフィックスとして使用されます。各セッションホストにはハイフンのサフィックスと数値が末尾に追加されます (例: aad-hp01-sh-0)。この名前プレフィックスは最大 11 文字で、オペレーティングシステムのコンピュータ名で使用されます。プレフィックスとサフィックスの組み合わせには、最大 15 文字を指定できます。セッションホスト名は一意である必要があります。
仮想マシンの場所	セッションホスト VM がデプロイされる Azure リージョンを選択します。これは仮想ネットワークが存在するリージョンと同じでなければなりません。
可用性のオプション	[可用性ゾーン]、[可用性セット]、または[インフラストラクチャの依存関係は必要ありません] から選択します。可用性ゾーンまたは可用性セットを選択した場合は、表示される追加のパラメーターを完了します。
セキュリティの種類	[標準]、[トラステッド起動仮想マシン]、または [機密の仮想マシン] から選択します。
Image	一覧から使用する OS イメージを選択するか、[すべてのイメージを表示] を選択して詳細を表示します。これには、Azure Compute Gallery の共有イメージまたはマネージドイメージとして作成および保存したイメージが含まれます。
仮想マシンのサイズ	SKU を選択します。別の SKU を使用する場合は、[サイズの変更] を選択し、一覧から選択します。
[Number of VMs](VM の数)	デプロイする仮想マシンの数を入力します。必要に応じて、この時点で最大 400 個のセッションホスト VM をデプロイできます (サブスクリプションクォータによって異なります)。後でさらに追加することもできます。詳しくは、「Azure Virtual Desktop サービスの制限」および「Virtual Machines の制限」をご覧ください。
OS ディスクの種類	セッションホストに使用するディスクの種類を選択します。運用環境のワークロードには Premium SSD のみを使用することをお勧めします。
ブート診断	ブート診断を有効にするかどうかを選択します。
ネットワークとセキュリティ
仮想ネットワーク	仮想ネットワークを選択します。サブネットを選択するオプションが表示されます。
Subnet	仮想ネットワークからサブネットを選択します。
ネットワークセキュリティグループ	ネットワークセキュリティグループ (NSG) を使用するかどうかを選択します。 - [基本] では、VM NIC 用の新しい NSG が作成されます。 - [詳細設定] を使用すると、既存の NSG を選択できます。
パブリック受信ポート	[いいえ] を選択することをお勧めします。
参加するドメイン
参加したいディレクトリを選択する	[Azure Active Directory] または [Active Directory] から選択し、選択したオプションに関連するパラメーターを入力します。セッションホストを Azure AD に参加させる方法の詳細については、「Azure AD 参加済みセッションホスト」を参照してください。
仮想マシンの管理者アカウント
ユーザー名	新しいセッションホスト VM のローカル管理者アカウントとして使用する名前を入力します。
Password	ローカル管理者アカウントのパスワードを入力します。
[パスワードの確認入力]	パスワードをもう一度入力します。
カスタム構成
ARM テンプレートファイルの URL	デプロイ中に追加の ARM テンプレートを使用する場合は、ここに URL を入力できます。
ARM テンプレートパラメーターファイルの URL	ARM テンプレートのパラメーターファイルの URL を入力します。

このタブに記入し終わったら、[次へ: タグ] を選択します。

[タグ] タブで、オプションで必要な名前と値のペアを入力し、[次へ: 次へ: レビュー + 作成] を選択できます。
[確認と作成] タブで、検証に合格したことを確認し、デプロイ中に使用される情報を確認します。検証に合格しない場合は、エラーメッセージを確認し、各タブに入力した内容を確認します。
［作成］ を選択しますデプロイが完了すると、セッションホストがホストプールに表示されます。

重要

Azure Virtual Desktop サービスを使用してセッションホストを追加したら、「デプロイ後」セクションに進んで、必要な追加設定を行ってください。

ホストプールにセッションホストを登録する

自動パイプラインなど、Azure Virtual Desktop の外部で別の方法を使用して仮想マシンを作成した場合は、それらをセッションホストとしてホストプールに個別に登録する必要があります。セッションホストをホストプールに登録するには、各仮想マシンに Azure Virtual Desktop エージェントと Azure Virtual Desktop エージェントブートローダーをインストールし、生成した登録キーを使用する必要があります。セッションホストをホストプールに登録するには、エージェントインストーラーのグラフィカルユーザーインターフェイス (GUI) を使用するか、コマンドラインから msiexec を使用します。完了すると、インストールされているアプリケーションとして次の 4 つのアプリケーションが一覧表示されます。

リモートデスクトップエージェントブートローダー。
リモートデスクトップサービスインフラストラクチャエージェント。
リモートデスクトップサービスインフラストラクチャ Geneva エージェント。
リモートデスクトップサービス SxS ネットワークスタック。

シナリオの関連タブを選択し、手順に従います。

GUI
コマンドライン

セッションホストとして使用する仮想マシンが、Azure Active Directory または Active Directory Domain (AD DS または Azure AD DS) に参加していることを確認します。
仮想マシンで Windows Server OS が実行されている場合は、リモートデスクトップセッションホスト ロールをインストールしてから、仮想マシンを再起動する必要があります。詳細については、「役割と機能の追加ウィザードを使用して役割、役割サービス、および機能をインストールする」をご覧ください。
仮想マシンに管理者としてサインインします。
次のリンクを使用して、エージェントとエージェントブートローダのインストールファイルをダウンロードします。ブロックを解除する必要がある場合があります。各ファイルを右クリックして [プロパティ] を選択し、[ブロック解除] を選択し、最後に [OK] を選択します。
- Azure Virtual Desktop エージェント
- Azure Virtual Desktop エージェントブートローダー
ヒント

これは、非検証環境での Azure Virtual Desktop エージェントのダウンロード可能な最新バージョンです。エージェントの新しいバージョンのロールアウトの詳細については、「Azure Virtual Desktop エージェントの新機能」を参照してください。
Microsoft.RDInfra.RDAgent.Installer-x64-<version>.msi ファイルを実行して、リモートデスクトップサービスインフラストラクチャエージェントをインストールします。
プロンプトに従い、インストーラーによって登録トークンの入力が求められたら、テキストボックスに貼り付けます。これは 1 行で表示されます。 [次へ] を選択し、インストールを完了します。
Microsoft.RDInfra.RDAgentBootLoader.Installer-x64.msi ファイルを実行して、残りのコンポーネントをインストールします。
画面に表示される指示に従って、インストールを完了します。
しばらくすると、仮想マシンがホストプール内のセッションホストとして一覧表示されます。セッションホストの状態は、最初は「Unavailable」(使用不可) と表示され、使用可能な新しいエージェントバージョンがある場合は、自動的にアップグレードされます。
セッションホストの状態が「Available」(使用可能) になったら、仮想マシンを再起動します。

msiexec を使用すると、Microsoft エンドポイントマネージャーの Intune や Configuration Manager などの自動デプロイツールを使用して、コマンドラインからエージェントとブートローダーをインストールできます。

重要

次の例では、<placeholder> を独自の値に変更する必要があります。

セッションホストとして使用する仮想マシンが、Azure Active Directory または Active Directory Domain (AD DS または Azure AD DS) に参加していることを確認します。
仮想マシンで Windows Server OS が実行されている場合は、管理者として次のコマンドを実行して、リモートデスクトップセッションホスト ロールをインストールする必要があります。これにより、仮想マシンも再起動されます。
```
Install-WindowsFeature -Name RDS-RD-Server -Restart
```

エージェントとエージェントブートローダーのインストールファイルをダウンロードし、次のコマンドを実行してブロックを解除します。

$uris = @(
    "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RWrmXv"
    "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RWrxrH"
)

$installers = @()
foreach ($uri in $uris) {
    $download = Invoke-WebRequest -Uri $uri

    $fileName = ($download.Headers.'Content-Disposition').Split('=')[1].Replace('"','')
    $output = [System.IO.FileStream]::new("$pwd\$fileName", [System.IO.FileMode]::Create)
    $output.write($download.Content, 0, $download.RawContentLength)
    $output.close()
    $installers += $output.Name
}

foreach ($installer in $installers) {
    Unblock-File -Path "$installer"
}

ヒント

これは、非検証環境での Azure Virtual Desktop エージェントのダウンロード可能な最新バージョンです。エージェントの新しいバージョンのロールアウトの詳細については、「Azure Virtual Desktop エージェントの新機能」を参照してください。

リモートデスクトップサービスインフラストラクチャエージェントをインストールするには、管理者として次のコマンドを実行します。
```
msiexec /i Microsoft.RDInfra.RDAgent.Installer-x64-<version>.msi /quiet REGISTRATIONTOKEN=<RegistrationToken>
```
残りのコンポーネントをインストールするには、管理者として次のコマンドを実行します。
```
msiexec /i Microsoft.RDInfra.RDAgentBootLoader.Installer-x64.msi /quiet
```
しばらくすると、仮想マシンがホストプール内のセッションホストとして一覧表示されます。セッションホストの状態は、最初は「Unavailable」(使用不可) と表示され、使用可能な新しいエージェントバージョンがある場合は、自動的にアップグレードされます。
セッションホストの状態が「Available」(使用可能) になったら、仮想マシンを再起動します。

デプロイ後

セッションホストもホストプールに追加したら、追加の構成が必要になる場合があります。これについては、次のセクションで説明します。

ライセンス

セッションホストにライセンスが正しく適用されていることを確認するには、次のタスクを実行する必要があります。

Azure Virtual Desktop ワークロードを実行するための適切なライセンスがある場合は、Windows または Windows Server のライセンスを Azure Virtual Desktop の一部としてセッションホストに適用し、別のライセンスを支払わずに実行できます。これは、Azure Virtual Desktop サービスを使用してセッションホストを作成するときに自動的に適用されますが、Azure Virtual Desktop の外部でセッションホストを作成する場合は、ライセンスを個別に適用する必要がある場合があります。詳細については、「セッションホスト仮想マシンに Windows ライセンスを適用する」を参照してください。
セッションホストが Windows Server OS を実行している場合は、リモートデスクトップライセンスサーバーからリモートデスクトップサービス (RDS) クライアントアクセスライセンス (CAL) も発行する必要があります。詳細については、「クライアントアクセスライセンス (CAL) を使用して RDS デプロイをライセンスする」を参照してください。

Azure AD 参加済みセッションホスト

ユーザーが Azure Active Directory 参加済みセッションホストに接続する場合は、次のタスクを実行する必要があります。

ユーザーが Azure Active Directory 参加済みセッションホストに接続する場合は、各仮想マシン、仮想マシンを含むリソースグループ、またはサブスクリプションのいずれかで、仮想マシンユーザーログインまたは仮想マシン管理者ログインの RBAC ロールを割り当てる必要があります。セッションホストを含むリソースグループの仮想マシンユーザーログインの RBAC ロールを、アプリケーショングループに割り当てるのと同じユーザーグループに割り当てることをお勧めします。詳細については、「Azure AD を使用して Azure の Windows 仮想マシンにログインする」を参照してください。
Azure AD に参加していない Windows デバイスや非 Windows デバイスから接続するユーザーの場合は、カスタム RDP プロパティをホストプールの RDP プロパティ targetisaadjoined:i:1 に追加します。これらの接続は、セッションホストにサインインするときにユーザー名とパスワードの資格情報を入力するように制限されています。詳細については、ホストプールの RDP プロパティのカスタマイズに関する記事を参照してください。

Azure AD に参加しているセッションホストの使用の詳細については、「Azure AD 参加済みセッションホスト」を参照してください。

次のステップ

既存のホストプールを拡張したので、Azure Virtual Desktop クライアントにサインインして、ユーザーセッションの一部としてそれらをテストできるようになりました。次のいずれかのクライアントとのセッションに接続できます。

ホストプールにセッションホストを追加する

前提条件

登録キーの生成

Azure Virtual Desktop サービスにセッションホストを作成して登録する

ホストプールにセッションホストを登録する

デプロイ後

ライセンス

Azure AD 参加済みセッションホスト

次のステップ

その他のリソース

その他のリソース

ホスト プールにセッション ホストを追加する

前提条件

登録キーの生成

Azure Virtual Desktop サービスにセッション ホストを作成して登録する

ホスト プールにセッション ホストを登録する

デプロイ後

ライセンス

Azure AD 参加済みセッション ホスト

次のステップ

その他のリソース

その他のリソース

ホストプールにセッションホストを追加する

Azure Virtual Desktop サービスにセッションホストを作成して登録する

ホストプールにセッションホストを登録する

Azure AD 参加済みセッションホスト