ホスト プールのリモート デスクトップ プロトコル (RDP) プロパティをカスタマイズする

重要

この内容は、Azure Resource Manager Azure Virtual Desktop オブジェクトを含む Azure Virtual Desktop に適用されます。 Azure Resource Manager オブジェクトを含まない Azure Virtual Desktop (クラシック) を使用している場合は、こちらの記事を参照してください。

マルチ モニター エクスペリエンスやオーディオ リダイレクトなど、ホスト プールのリモート デスクトップ プロトコル (RDP) のプロパティをカスタマイズして、ニーズに基づいてユーザーに最適なエクスペリエンスを提供できます。 既定の RDP ファイルのプロパティを変更する場合は、Azure portal を使用するか、Update-AzWvdHostPool コマンドレットで -CustomRdpProperty パラメーターを使用して、Azure Virtual Desktop の RDP プロパティをカスタマイズできます。

サポートされているプロパティとその既定値の一覧については、「Azure Virtual Desktop でサポートされる RDP プロパティ」を参照してください。

既定の RDP ファイルのプロパティ

RDP ファイルには、既定で次のプロパティがあります。

RDP プロパティ デスクトップと RemoteApp の両方
マルチモニター モード Enabled
リダイレクト有効 ドライブ、クリップボード、プリンター、COM ポート、スマート カード、デバイス、usbdevicestore、および WebAuthn
リモート オーディオ モード ローカルで再生
VideoPlayback Enabled
EnableCredssp Enabled

Note

  • マルチモニター モードは、デスクトップ アプリ グループに対してのみ有効になり、RemoteApp アプリ グループの場合は無視されます。
  • 既定の RDP ファイルのプロパティは、すべて Azure Portal で公開されています。
  • CustomRdpProperty フィールドが null の場合は、すべての既定の RDP プロパティがホスト プールに適用されます。 CustomRdpProperty フィールドが空の場合は、既定の RDP プロパティがいずれもホスト プールに適用されません。

前提条件

作業を開始する前に、Azure Virtual Desktop PowerShell モジュールの設定に関するページの手順に従って、PowerShell モジュールを設定し、Azure にサインインしてください。

Azure portal で RDP プロパティを構成する

Azure portal で RDP プロパティを構成するには

  1. Azure portal にサインインします。
  2. 検索バーに「Azure Virtual Desktop」と入力します。
  3. [サービス] の下にある [Azure Virtual Desktop] を選択します。
  4. [Azure Virtual Desktop] ページで、画面の左側にあるメニューの [ホスト プール] を選択します。
  5. 更新するホスト プールの名前を選択します。
  6. 画面の左側にあるメニューで [RDP プロパティ] を選択します。
  7. 必要なプロパティを設定します。
    • または、 [詳細] タブを開き、次のセクションの PowerShell の例のように、セミコロンで区切られた形式で RDP プロパティを追加できます。
  8. 完了したら、 [保存] を選択して変更を保存します。

次のセクションでは、PowerShell でカスタム RDP プロパティを手動で編集する方法について説明します。

単一のカスタム RDP プロパティを追加または編集する

単一のカスタム RDP プロパティを追加または編集するには、次の PowerShell コマンドレットを実行します。

Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -CustomRdpProperty <property>

注意

Azure Virtual Desktop サービスでは、有効なカスタム RDP プロパティ名として、セミコロンやコロンなどのエスケープ文字は受け入れられません。

実行したコマンドレットでプロパティを更新したかどうかを確認するには、次のコマンドレットを実行します。

Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | format-list Name, CustomRdpProperty

Name              : <hostpoolname>
CustomRdpProperty : <customRDPpropertystring>

たとえば、0301HP という名前のホスト プールで "audiocapturemode" プロパティを確認している場合は、次のコマンドレットを入力します。

Get-AzWvdHostPool -ResourceGroupName 0301rg -Name 0301hp | format-list Name, CustomRdpProperty

Name              : 0301HP
CustomRdpProperty : audiocapturemode:i:1;

複数のカスタム RDP プロパティを追加または編集する

複数のカスタム RDP プロパティを追加または編集するには、カスタム RDP プロパティをセミコロンで区切った文字列として指定して、次の PowerShell コマンドレットを実行します。

$properties="<property1>;<property2>;<property3>"
Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -CustomRdpProperty $properties

注意

Azure Virtual Desktop サービスでは、有効なカスタム RDP プロパティ名として、セミコロンやコロンなどのエスケープ文字は受け入れられません。

次のコマンドレットを実行して、RDP プロパティが追加されたことを確認できます。

Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | format-list Name, CustomRdpProperty

Name              : <hostpoolname>
CustomRdpProperty : <customRDPpropertystring>

前のコマンドレットの例に基づいて、0301HP ホスト プールに複数の RDP プロパティを設定した場合、コマンドレットは次のようになります。

Get-AzWvdHostPool -ResourceGroupName 0301rg -Name 0301hp | format-list Name, CustomRdpProperty

Name              : 0301HP
CustomRdpProperty : audiocapturemode:i:1;audiomode:i:0;

すべてのカスタム RDP プロパティをリセットする

単一のカスタム RDP プロパティを追加または編集する」の手順に従って、個々のカスタム RDP プロパティを既定値にリセットできます。 次の PowerShell コマンドレットを実行して、ホスト プールのすべてのカスタム RDP プロパティをリセットすることもできます。

Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -CustomRdpProperty ""

設定が正常に削除されたことを確認するには、次のコマンドレットを入力します。

Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | format-list Name, CustomRdpProperty

Name              : <hostpoolname>
CustomRdpProperty : <CustomRDPpropertystring>

次のステップ

特定のホスト プールの RDP プロパティをカスタマイズしたので、Azure Virtual Desktop クライアントにサインインして、それらをユーザー セッションの一部としてテストできます。 次の攻略ガイドでは、選択したクライアントを使用してセッションに接続する方法を説明します。