Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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:
| Client | Versie |
|---|---|
| Extern bureaublad-client voor Windows | 1.2.4065 en hoger |
|
Windows App voor Windows alleen ms-avd |
2.0.804.0 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.
Belangrijk
Als zowel extern bureaublad-client als Windows App versie 2.0.804.0 of hoger op een apparaat zijn geïnstalleerd, start het ms-avd-protocol een Windows App.
ms-avd:connect
ms-avd:connectzoekt 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 van een hostgroep, werkruimte, toepassingsgroep of toepassing ophalen om de waarde van de object-id op te halen met behulp van PowerShell. U kunt ook REST API's voor desktopvirtualisatie gebruiken. Vereist in Extern bureaublad-client Niet ondersteund in Windows App |
| 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 van een hostgroep, werkruimte, toepassingsgroep of toepassing ophalen om de waarde van de object-id op te halen met behulp van PowerShell. U kunt ook REST API's voor desktopvirtualisatie gebruiken. Vereist in Extern bureaublad-client en Windows App |
| gebruiker | User Principal Name (UPN), bijvoorbeeld user@contoso.com. |
Geef een geldige gebruiker op met toegang tot de opgegeven resource. Vereist in Extern bureaublad-client en Windows App |
| Env |
avdarm (commerciële Azure) usgov (Azure Government) |
Geef de Azure cloud op waar resources zich bevinden. Optioneel in extern bureaublad-client Niet ondersteund in Windows App. |
| Versie | 0 | Geef de versie op van het verbindings-URI-schema dat u wilt gebruiken. Vereist in Extern bureaublad-client Niet ondersteund in Windows App. |
| launchpartnerid | GUID. | Geef de partner- of door de klant opgegeven id op die u kunt gebruiken met Azure Virtual Desktop Diagnostics om te helpen bij het oplossen van problemen. U wordt aangeraden een GUID te gebruiken, die u kunt genereren met de PowerShell-cmdlet New-Guid . Optioneel in extern bureaublad-client Niet ondersteund in Windows App. |
| peeractivityid | GUID. | Geef de partner- of door de klant opgegeven id op die u kunt gebruiken met Azure Virtual Desktop Diagnostics om te helpen bij het oplossen van problemen. U wordt aangeraden een GUID te gebruiken, die u kunt genereren met de PowerShell-cmdlet New-Guid . Optioneel in extern bureaublad-client Niet ondersteund in Windows App. |
| usemultimon | waar of onwaar | Geef op of de externe sessie een of meer beeldschermen van de lokale computer gebruikt. Optioneel in extern bureaublad-client en Windows App |
Voorbeeld:
ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1&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 u ms-rd: zonder 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.