Uniform Resource Identifier mit dem Remotedesktopclient für Azure Virtual Desktop

Artikel
06/03/2024

Sie können Uniform Resource Identifier-Schemas (URI-Schemas) verwenden, um den Remotedesktopclient mit bestimmten Befehlen, Parametern und Werten für die Verwendung mit Azure Virtual Desktop aufzurufen. Sie können beispielsweise einen Arbeitsbereich abonnieren oder eine Verbindung mit einem bestimmten Desktop oder RemoteApp herstellen.

In diesem Artikel werden die verfügbaren Befehle und Parameter sowie einige Beispiele beschrieben.

Unterstützte Clients

In der folgenden Tabelle sind die unterstützten Clients für die Verwendung mit den URI-Schemas aufgeführt:

Client	Version
Remotedesktopclient für Windows	1.2.4065 und höher

Verfügbare URI-Schemas

Es gibt zwei URI-Schemas für unterstützte Remotedesktopclients: ms-avd und ms-rd. Mit ms-avd können Sie eine bestimmte Azure Virtual Desktop-Ressource und Benutzer angeben, mit dem eine Verbindung hergestellt werden soll. Mit ms-rd können Sie automatisch einen Arbeitsbereich im Remotedesktopclient abonnieren, anstatt den Arbeitsbereich manuell hinzufügen zu müssen.

In den folgenden Abschnitten werden die Befehle und Parameter beschrieben, die Sie mit jedem URI-Schema verwenden können.

ms-avd

Das Uniform Resource Identifier-Schema ms-avd für Azure Virtual Desktop ist jetzt allgemein verfügbar. Hier ist eine Liste der derzeit unterstützten Befehle für ms-avd und dessen entsprechenden Parametern.

ms-avd:connect

ms-avd:connect sucht nach einer angegebenen Azure Virtual Desktop-Ressource und initiiert die RDP-Sitzung, bei der ein angegebener Benutzer direkt mit dieser Ressource verbunden wird.

Befehlsname: Connect

Befehlsparameter:

Parameter	Werte	BESCHREIBUNG
WorkspaceID	Objekt-ID (GUID).	Geben Sie die Objekt-ID eines gültigen Arbeitsbereichs an. Informationen zum Abrufen des Werts der Objekt-ID mithilfe von PowerShell finden Sie unter Abrufen der Objekt-ID eines Hostpools, Arbeitsbereichs, einer Anwendungsgruppe oder einer Anwendung. Sie können auch Desktop Virtualization-REST-APIs verwenden.
resourceId	Objekt-ID (GUID).	Geben Sie die Objekt-ID einer veröffentlichten Ressource an, die im Arbeitsbereich enthalten ist. Der Wert kann für einen Desktop oder eine RemoteApp sein. Informationen zum Abrufen des Werts der Objekt-ID mithilfe von PowerShell finden Sie unter Abrufen der Objekt-ID eines Hostpools, Arbeitsbereichs, einer Anwendungsgruppe oder einer Anwendung. Sie können auch Desktop Virtualization-REST-APIs verwenden.
user	Benutzerprinzipalname (UPN), z. B. `user@contoso.com`.	Geben Sie einen gültigen Benutzer mit Zugriff auf die angegebene Ressource an.
env (optional)	avdarm (kommerzielles Azure) usgov (Azure Government)	Geben Sie die Azure-Cloud an, in der sich Ressourcen befinden.
version	0	Geben Sie die Version des zu verwendenden Verbindungs-URI-Schemas an.
launchpartnerid (optional)	GUID.	Geben Sie die vom Partner oder Kunden bereitgestellte ID an, die Sie mit der Azure Virtual Desktop-Diagnose verwenden können, um die Problembehandlung zu unterstützen. Es wird empfohlen, eine GUID zu verwenden, die Sie mit dem New-GuidPowerShell Cmdlet generieren können.
peeractivityid (optional)	GUID.	Geben Sie die vom Partner oder Kunden bereitgestellte ID an, die Sie mit der Azure Virtual Desktop-Diagnose verwenden können, um die Problembehandlung zu unterstützen. Es wird empfohlen, eine GUID zu verwenden, die Sie mit dem New-GuidPowerShell Cmdlet generieren können.
usemultimon	true oder false	Geben Sie an, ob die Remotesitzung eine oder mehrere Displays vom lokalen Computer verwendet.

Beispiel:

ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1&username=user@contoso.com&version=0

ms-rd

Hier ist eine Liste der derzeit unterstützten Befehle für ms-avd und dessen entsprechenden Parametern.

Tipp

Bei Verwendung von ms-rd: ohne Befehle wird der Remotedesktopclient gestartet.

ms-rd:subscribe

ms-rd:subscribe startet den Remotedesktopclient und beginnt mit dem Abonnementprozess.

Befehlsname: subscribe

Befehlsparameter:

Parameter	Werte	Beschreibung
url	Eine gültige URL, z. B. https://rdweb.wvd.microsoft.com.	Geben Sie eine Arbeitsbereichs-URL an.

Beispiel:

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

Bekannte Einschränkungen

Hier sind bekannte Einschränkungen für die URI-Schemas:

Anzeigeeigenschaften können nicht über URI konfiguriert werden. Sie können Anzeigeeigenschaften als Administrator für einen Hostpool konfigurieren, oder Endbenutzer können Anzeigeeigenschaften im Azure Virtual Desktopclient konfigurieren.

Nächste Schritte

Hier erfahren Sie, wie Sie Mithilfe des Remotedesktopclients für Windows eine Verbindung mit Azure Virtual Desktop herstellen.

Freigeben über