Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Sie können URI-Schemas (Uniform Resource Identifier) verwenden, um den Remotedesktopclient mit bestimmten Befehlen, Parametern und Werten für die Verwendung mit Azure Virtual Desktop aufzurufen. Beispielsweise können Sie einen Arbeitsbereich abonnieren oder eine Verbindung mit einem bestimmten Desktop oder einer 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 einen Bestimmten 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 ms-avd Uniform Resource Identifier-Schema für Azure Virtual Desktop ist jetzt allgemein verfügbar. Dies ist die Liste der derzeit unterstützten Befehle für ms-avd und die entsprechenden Parameter.
ms-avd:connect
ms-avd:connect sucht eine angegebene Azure Virtual Desktop-Ressource und initiiert die RDP-Sitzung, wobei 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 Objekt-ID-Werts 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 Objekt-ID-Werts 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. |
| Benutzer | Benutzerprinzipalname (USER Principal Name, 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 kundenseitig 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 PowerShell-Cmdlet New-Guid generieren können. |
| peeractivityid (optional) | GUID. | Geben Sie die vom Partner oder kundenseitig 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 PowerShell-Cmdlet New-Guid generieren können. |
| usemultimon | true oder false | Geben Sie an, ob die Remotesitzung eine oder mehrere Anzeigen des lokalen Computers 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
Dies ist die Liste der derzeit unterstützten Befehle für ms-rd und die entsprechenden Parameter.
Tipp
Wenn Sie ms-rd: ohne Befehle verwenden, wird der Remotedesktopclient gestartet.
ms-rd:subscribe
ms-rd:subscribe startet den Remotedesktopclient und den Abonnementprozess.
Befehlsname: subscribe
Befehlsparameter:
| Parameter | Werte | Beschreibung |
|---|---|---|
| url | Eine gültige URL, z https://rdweb.wvd.microsoft.com. B. . | Geben Sie eine Arbeitsbereichs-URL an. |
Beispiel:
ms-rd:subscribe?url=https://rdweb.wvd.microsoft.com
Bekannte Einschränkungen
Hier sind die bekannten Einschränkungen für die URI-Schemas:
- Anzeigeeigenschaften können nicht über den URI konfiguriert werden. Sie können Anzeigeeigenschaften als Administrator für einen Hostpool konfigurieren, oder Endbenutzer können Anzeigeeigenschaften im Azure Virtual Desktop-Client konfigurieren.
Nächste Schritte
Erfahren Sie, wie Sie über den Remotedesktopclient für Windows eine Verbindung mit Azure Virtual Desktop herstellen.