Partager via


Schémas URI (Uniform Resource Identifier) avec le client Bureau à distance pour Azure Virtual Desktop

Vous pouvez utiliser des schémas URI (Uniform Resource Identifier) pour appeler le client Bureau à distance avec des commandes, des paramètres et des valeurs spécifiques utilisables avec Azure Virtual Desktop. Par exemple, vous pouvez vous abonner à un espace de travail ou vous connecter à un poste de travail particulier ou à RemoteApp.

Cet article présente les commandes et paramètres disponibles, ainsi que quelques exemples.

Clients pris en charge

Le tableau suivant répertorie les clients pris en charge et utilisables avec les schémas URI :

Client Version
Client Bureau à distance pour Windows 1.2.4065 et versions ultérieures

Schémas URI disponibles

Il existe deux schémas URI pour les clients Bureau à distance pris en charge, ms-avd et ms-rd. Avec ms-avd, vous pouvez spécifier une ressource particulière Azure Virtual Desktop et un utilisateur avec lequel vous souhaitez vous connecter. Avec ms-rd, vous pouvez vous abonner automatiquement à un espace de travail du client Bureau à distance, au lieu d’ajouter manuellement l’espace de travail.

Les sections suivantes décrivent les commandes et paramètres que vous pouvez utiliser avec chaque schéma URI.

ms-avd

Le schéma URI (Uniform Resource Identifier) ms-avd pour Azure Virtual Desktop est généralement disponible. Voici la liste des commandes actuellement prises en charge pour ms-avd et leurs paramètres correspondants.

ms-avd:connect

ms-avd:connect localise une ressource Azure Virtual Desktop spécifiée et lance la session RDP, en connectant directement un utilisateur spécifié à ladite ressource.

Nom de commande : connect

Paramètres de la commande :

Paramètre Valeurs Description
WorkspaceID ID d’objet (GUID). Indiquez l’ID d’objet d’un espace de travail valide.

Pour obtenir la valeur de l’ID d’objet au moyen de PowerShell, consultez Récupérer l’ID d’objet d’un pool d’hôtes, d’un espace de travail, d’un groupe d’applications ou d’une application. Vous pouvez aussi utiliser les API REST Virtualisation des services Bureau.
resourceid ID d’objet (GUID). Indiquez l’ID d’objet d’une ressource publiée contenue dans l’espace de travail. La valeur peut être destinée à un bureau ou RemoteApp.

Pour obtenir la valeur de l’ID d’objet au moyen de PowerShell, consultez Récupérer l’ID d’objet d’un pool d’hôtes, d’un espace de travail, d’un groupe d’applications ou d’une application. Vous pouvez aussi utiliser les API REST Virtualisation des services Bureau.
utilisateur Nom d’utilisateur principal (UPN), par exemple user@contoso.com. Indiquez un utilisateur valide ayant accès à la ressource spécifiée.
env (facultatif) avdarm (Azure commercial)
avdgov (Azure Governmental)
Indiquez le cloud Azure où se trouvent les ressources.
version 0 Indiquez la version du schéma URI de connexion à utiliser.
launchpartnerid (facultatif) GUID (identificateur global unique). Spécifiez l’ID fourni par le partenaire ou le client que vous pouvez utiliser avec les diagnostics Azure Virtual Desktop pour faciliter la résolution des problèmes. Nous recommandons d’utiliser un GUID que vous pouvez générer avec l’applet de commande PowerShell New-Guid .
peeractivityid (facultatif) GUID (identificateur global unique). Spécifiez l’ID fourni par le partenaire ou le client que vous pouvez utiliser avec les diagnostics Azure Virtual Desktop pour faciliter la résolution des problèmes. Nous recommandons d’utiliser un GUID que vous pouvez générer avec l’applet de commande PowerShell New-Guid .
usemultimon true ou false Spécifiez si la session distante utilise un ou plusieurs affichages à partir de l’ordinateur local.

Exemple :

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

ms-rd

Voici la liste des commandes actuellement prises en charge pour ms-rd et leurs paramètres correspondants.

Conseil

L’utilisation de ms-rd: sans commande lance le client Bureau à distance.

ms-rd:subscribe

ms-rd:subscribe lance le client Bureau à distance et démarre le processus d’abonnement.

Nom de la commande : subscribe

Paramètres de la commande :

Paramètre Valeurs Description
url URL valide, par exemple, https://rdweb.wvd.microsoft.com. Spécifiez une URL de l’espace de travail.

Exemple :

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

Limites connues

Voici les limitations connues des schémas URI :

  • Les propriétés d’affichage ne peuvent pas être configurées au travers de l’URI. Vous pouvez configurer les propriétés d’affichage en tant qu’administrateur dans un pool d’hôtes ou les utilisateurs finaux peuvent les configurer dans le client Azure Virtual Desktop.

Étapes suivantes

Découvrez comment Se connecter à Azure Virtual Desktop en utilisant le client Bureau à distance pour Windows.