Uniform Resource Identifier-schema's met de Extern bureaublad-client voor Azure Virtual Desktop
U kunt URI-schema's (Uniform Resource Identifier) gebruiken om de Extern bureaublad-client aan te roepen met specifieke opdrachten, parameters en waarden voor gebruik met Azure Virtual Desktop. U kunt zich bijvoorbeeld abonneren op een werkruimte of verbinding maken met een bepaald bureaublad of RemoteApp.
In dit artikel worden de beschikbare opdrachten en parameters beschreven, samen met enkele voorbeelden.
Ondersteunde clients
De volgende tabel bevat de ondersteunde clients voor gebruik met de URI-schema's:
| Klant | Versie |
|---|---|
| Extern bureaublad-client voor Windows | 1.2.4065 en hoger |
Beschikbare URI-schema's
Er zijn twee URI-schema's voor ondersteunde Extern bureaublad-clients, ms-avd en ms-rd. Met ms-avd kunt u een bepaalde Azure Virtual Desktop-resource en -gebruiker opgeven waarmee verbinding moet worden gemaakt. Met ms-rd kunt u zich automatisch abonneren op een werkruimte in de Extern bureaublad-client in plaats van de werkruimte handmatig toe te voegen.
In de volgende secties worden de opdrachten en parameters beschreven die u met elk URI-schema kunt gebruiken.
ms-avd
Het schema ms-avd Uniform Resource Identifier voor Azure Virtual Desktop is nu algemeen beschikbaar. Hier volgt de lijst met momenteel ondersteunde opdrachten voor ms-avd en de bijbehorende parameters.
ms-avd:connect
ms-avd:connect zoekt een opgegeven Azure Virtual Desktop-resource en initieert de RDP-sessie, waarbij een opgegeven gebruiker rechtstreeks verbinding maakt met die resource.
Opdrachtnaam: verbinding maken
Opdrachtparameters:
| Parameter | Waarden | Beschrijving |
|---|---|---|
| workspaceid | Object-id (GUID). | Geef de object-id van een geldige werkruimte op. Zie De object-id ophalen van een hostgroep, werkruimte, toepassingsgroep of toepassing om de waarde van de object-id op te halen met behulp van PowerShell. U kunt ook REST API's voor desktopvirtualisatie gebruiken. |
| Resourceid | Object-id (GUID). | Geef de object-id op van een gepubliceerde resource in de werkruimte. De waarde kan voor een bureaublad of RemoteApp zijn. Zie De object-id ophalen van een hostgroep, werkruimte, toepassingsgroep of toepassing om de waarde van de object-id op te halen met behulp van PowerShell. U kunt ook REST API's voor desktopvirtualisatie gebruiken. |
| Gebruiker | User Principal Name (UPN), bijvoorbeeld user@contoso.com. |
Geef een geldige gebruiker op met toegang tot de opgegeven resource. |
| env (optioneel) | avdarm (commercieel Azure) avdgov (Azure Government) |
Geef de Azure-cloud op waar resources zich bevinden. |
| version | 0 | Geef de versie van het verbindings-URI-schema op dat moet worden gebruikt. |
| launchpartnerid (optioneel) | GUID. | Geef de door de partner of de klant verstrekte id op die u kunt gebruiken met Diagnostische gegevens van Azure Virtual Desktop om u te helpen bij het oplossen van problemen. U wordt aangeraden een GUID te gebruiken, die u kunt genereren met de Cmdlet New-Guid PowerShell. |
| peeractivityid (optioneel) | GUID. | Geef de door de partner of de klant verstrekte id op die u kunt gebruiken met Diagnostische gegevens van Azure Virtual Desktop om u te helpen bij het oplossen van problemen. U wordt aangeraden een GUID te gebruiken, die u kunt genereren met de Cmdlet New-Guid PowerShell. |
Voorbeeld:
ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=c2f5facc-196f-46af-991e-a90f3252c185&username=user@contoso.com&version=0
ms-rd
Hier volgt de lijst met momenteel ondersteunde opdrachten voor ms-rd en de bijbehorende parameters.
Tip
Als ms-rd: u geen opdrachten gebruikt, wordt de Extern bureaublad-client gestart.
ms-rd:subscribe
ms-rd:subscribe start de Extern bureaublad-client en start het abonnementsproces.
Opdrachtnaam: abonneren
Opdrachtparameters:
| Parameter | Waarden | Beschrijving |
|---|---|---|
| url | Een geldige URL, zoals https://rdweb.wvd.microsoft.com. | Geef een werkruimte-URL op. |
Voorbeeld:
ms-rd:subscribe?url=https://rdweb.wvd.microsoft.com
Bekende beperkingen
Hier volgen bekende beperkingen met de URI-schema's:
- Weergave-eigenschappen kunnen niet worden geconfigureerd via URI. U kunt weergave-eigenschappen configureren als beheerder in een hostgroep of eindgebruikers kunnen weergave-eigenschappen configureren in de Azure Virtual Desktop-client.