Uniform Resource Identifier (URI) スキームを使用して、Azure Virtual Desktop で使用する特定のコマンド、パラメーター、値を使用してリモート デスクトップ クライアントを呼び出すことができます。 たとえば、ワークスペースをサブスクライブしたり、特定のデスクトップまたは RemoteApp に接続したりできます。
この記事では、使用可能なコマンドとパラメーターと、いくつかの例について詳しく説明します。
サポートされるクライアント
次の表は、URI スキームで使用するためにサポートされているクライアントの一覧です。
| クライアント | バージョン |
|---|---|
| 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 セッションを開始し、指定したユーザーをそのリソースに直接接続します。
コマンド名: 接続
コマンド パラメーター:
| パラメーター | 値 | 説明 |
|---|---|---|
| workspaceid | オブジェクト ID (GUID)。 | 有効なワークスペースのオブジェクト ID を指定します。 PowerShell を使用してオブジェクト ID 値を取得するには、「 ホスト プール、ワークスペース、アプリケーション グループ、またはアプリケーションのオブジェクト ID を取得する」を参照してください。 デスクトップ仮想化 REST API を使用することもできます。 |
| resourceid | オブジェクト ID (GUID)。 | ワークスペースに含まれる発行済みリソースのオブジェクト ID を指定します。 デスクトップまたは RemoteApp の値を指定できます。 PowerShell を使用してオブジェクト ID 値を取得するには、「 ホスト プール、ワークスペース、アプリケーション グループ、またはアプリケーションのオブジェクト ID を取得する」を参照してください。 デスクトップ仮想化 REST API を使用することもできます。 |
| ユーザー | ユーザー プリンシパル名 (UPN) ( user@contoso.comなど)。 |
指定したリソースにアクセスできる有効なユーザーを指定します。 |
| env (省略可能) |
avdarm (商用 Azure) usgov (Azure Government) |
リソースが配置されている Azure クラウドを指定します。 |
| version | 0 | 使用する接続 URI スキームのバージョンを指定します。 |
| launchpartnerid (省略可能) | GUID。 | トラブルシューティングに役立つ Azure Virtual Desktop Diagnostics で使用できるパートナーまたは顧客が指定した ID を指定します。 New-Guid PowerShell コマンドレットを使用して生成できる GUID を使用することをお勧めします。 |
| peeractivityid (省略可能) | GUID。 | トラブルシューティングに役立つ Azure Virtual Desktop Diagnostics で使用できるパートナーまたは顧客が指定した ID を指定します。 New-Guid PowerShell コマンドレットを使用して生成できる GUID を使用することをお勧めします。 |
| usemultimon | true または false | リモート セッションでローカル コンピューターの 1 つまたは複数のディスプレイを使用するかどうかを指定します。 |
例:
ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1&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 に接続する方法について説明します。