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 を使用することをお勧めします。 |
例:
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 スキームに関する既知の制限事項を次に示します。
- 表示プロパティは URI では構成できません。 ホスト プールの管理者として表示プロパティを構成できます。または、エンド ユーザーが Azure Virtual Desktop クライアントで表示プロパティを構成することもできます。
次の手順
Windows 用リモート デスクトップ クライアントを使用して Azure Virtual Desktop に接続する方法を確認します。