Delen via


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.
usemultimon waar of onwaar Geef op of voor de externe sessie een of meer beeldschermen van de lokale computer worden gebruikt.

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.

Volgende stappen

Meer informatie over verbinding maken met Azure Virtual Desktop met de Extern bureaublad-client voor Windows.