Azure Virtual Desktop 用リモート デスクトップ クライアントでの Uniform Resource Identifier スキーム

  • [アーティクル]

URI (Uniform Resource Identifier) スキームを使用して、特定のコマンド、パラメーター、および値を使用してリモート デスクトップ クライアントを呼び出し、Azure Virtual Desktop とともに使用することができます。 たとえば、ワークスペースにサブスクライブする、または特定のデスクトップか RemoteApp に接続することができます。

この記事では、使用可能なコマンドとパラメーターを、いくつかの例と一緒に詳しく説明します。

サポートされるクライアント

次の表に、URI スキームで使用するためにサポートされているクライアントを示します。

Client Version
Windows 用のリモート デスクトップ クライアント 1.2.4065 以降

使用可能な URI スキーム

サポートされているリモート デスクトップ クライアントには、ms-avd と ms-rd の 2 つの URI スキームがあります。 ms-avd を使用すると、接続する特定の Azure Virtual Desktop リソースとユーザーを指定できます。 ms-rd を使用すると、手動でワークスペースを追加するのではなく、リモート デスクトップ クライアントでワークスペースに自動的にサブスクライブできます。

次のセクションでは、各 URI スキームで使用できるコマンドとパラメーターについて詳しく説明します。

ms-avd

Azure Virtual Desktop の ms-avd Uniform Resource Identifier スキームが一般提供になりました。 ms-avd に現在サポートされているコマンドとそれに対応するパラメーターの一覧を次に示します。

ms-avd:connect

ms-avd:connect は、指定された Azure Virtual Desktop リソースを検索し、RDP セッションを開始し、指定されたユーザーをそのリソースに直接接続します。

コマンド名: connect

コマンドのパラメーター:

パラメーター 値 説明
WorkspaceID オブジェクト ID (GUID)。 有効なワークスペースのオブジェクト ID を指定します。

PowerShell を使用してオブジェクト ID 値を取得するには、「ホスト プール、ワークスペース、アプリケーション グループ、またはアプリケーションのオブジェクト ID を取得する」を参照してください。 デスクトップ仮想化 REST API を使用することもできます。
resourceid オブジェクト ID (GUID)。 ワークスペースに含まれる発行済みリソースのオブジェクト ID を指定します。 この値は、デスクトップまたは RemoteApp に対して指定できます。

PowerShell を使用してオブジェクト ID 値を取得するには、「ホスト プール、ワークスペース、アプリケーション グループ、またはアプリケーションのオブジェクト ID を取得する」を参照してください。 デスクトップ仮想化 REST API を使用することもできます。
ユーザー ユーザー プリンシパル名。例: user@contoso.com。 指定されたリソースにアクセスできる有効なユーザーを指定します。
env (省略可能) avdarm (商用 Azure)
avdgov (Azure Government)		 リソースが配置されている Azure クラウドを指定します。
version 0 使用する接続 URI スキームのバージョンを指定します。
launchpartnerid (省略可能) GUID。 トラブルシューティングに役立つ Azure Virtual Desktop の診断で使用できる、パートナーまたはカスタマー指定の ID を指定します。 New-Guid PowerShell コマンドレットを使用して生成できる GUID を使用することをお勧めします。
peeractivityid (省略可能) GUID。 トラブルシューティングに役立つ Azure Virtual Desktop の診断で使用できる、パートナーまたはカスタマー指定の ID を指定します。 New-Guid PowerShell コマンドレットを使用して生成できる GUID を使用することをお勧めします。
usemultimon true または false リモート セッションでローカル コンピューターの 1 つまたは複数のディスプレイを使用するかどうかを指定します。

例:

ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=c2f5facc-196f-46af-991e-a90f3252c185&username=user@contoso.com&version=0

ms-rd

ms-rd に現在サポートされているコマンドとそれに対応するパラメーターの一覧を次に示します。

ヒント

コマンドを指定せずに ms-rd: を使用すると、リモート デスクトップ クライアントが起動されます。

ms-rd:subscribe

ms-rd:subscribe は、リモート デスクトップ クライアントを起動し、サブスクリプション プロセスを開始します。

コマンド名: subscribe

コマンドのパラメーター:

パラメーター 値 説明
url https://rdweb.wvd.microsoft.com などの有効な URL。 ワークスペースの URL を指定します。

例:

ms-rd:subscribe?url=https://rdweb.wvd.microsoft.com

既知の制限事項

URI スキームに関する既知の制限事項を次に示します。

次の手順

Windows 用リモート デスクトップ クライアントを使用して Azure Virtual Desktop に接続する方法を確認します。