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 . |
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.