Enhetliga resursidentifierarscheman med fjärrskrivbordsklienten för Azure Virtual Desktop

Du kan använda URI-scheman (Uniform Resource Identifier) för att anropa fjärrskrivbordsklienten med specifika kommandon, parametrar och värden för användning med Azure Virtual Desktop. Du kan till exempel prenumerera på en arbetsyta eller ansluta till ett visst skrivbord eller en viss RemoteApp.

I den här artikeln beskrivs tillgängliga kommandon och parametrar samt några exempel.

Kompatibla klienter

I följande tabell visas de klienter som stöds för användning med URI-scheman:

Klient Version
Fjärrskrivbordsklient för Windows 1.2.4065 och senare
Windows App för Windows
Endast ms-AVD
2.0.804.0 och senare

Tillgängliga URI-scheman

Det finns två URI-scheman för fjärrskrivbordsklienter som stöds, ms-avd och ms-rd. Med ms-avd kan du ange en viss Azure Virtual Desktop-resurs och användare som du vill ansluta till. Med ms-rd kan du automatiskt prenumerera på en arbetsyta i fjärrskrivbordsklienten, i stället för att behöva lägga till arbetsytan manuellt.

I följande avsnitt beskrivs de kommandon och parametrar som du kan använda med varje URI-schema.

ms-avd

ms-avd Uniform Resource Identifier-schemat för Azure Virtual Desktop är nu allmänt tillgängligt. Här är en lista över kommandon som stöds för ms-avd och deras motsvarande parametrar.

Viktigt

Om både fjärrskrivbordsklienten och Windows App version 2.0.804.0 eller senare är installerade på en enhet startar ms-avd-protokollet en Windows App.

ms-avd:connect

ms-avd:connectletar upp en angiven Azure Virtual Desktop-resurs och initierar DS-sessionen och ansluter direkt en angiven användare till resursen.

Kommandonamn: anslut

Kommandoparametrar:

Parameter Värden Beskrivning
workspaceid Objekt-ID (GUID). Ange objekt-ID för en giltig arbetsyta.

Information om hur du hämtar objekt-ID-värdet med PowerShell finns i Hämta objekt-ID:t för en värdpool, arbetsyta, programgrupp eller program. Du kan också använda REST-API:er för skrivbordsvirtualisering.

Krävs i fjärrskrivbordsklienten
Stöds inte i Windows App
resourceid Objekt-ID (GUID). Ange objekt-ID för en publicerad resurs som finns på arbetsytan. Värdet kan vara för ett skrivbord eller en RemoteApp.

Information om hur du hämtar objekt-ID-värdet med PowerShell finns i Hämta objekt-ID:t för en värdpool, arbetsyta, programgrupp eller program. Du kan också använda REST-API:er för skrivbordsvirtualisering.

Krävs i fjärrskrivbordsklienten och Windows App
användare UPN (User Principal Name), till exempel user@contoso.com. Ange en giltig användare med åtkomst till den angivna resursen.

Krävs i fjärrskrivbordsklienten och Windows App
env avdarm (kommersiell Azure)
usgov (Azure Government)
Ange det Azure moln där resurserna finns.

Valfritt i fjärrskrivbordsklienten
Stöds inte i Windows App.
Utförande 0 Ange vilken version av anslutnings-URI-schemat som ska användas.

Krävs i fjärrskrivbordsklienten
Stöds inte i Windows App.
launchpartnerid GUID. Ange det partner- eller kundangivna ID som du kan använda med Azure Virtual Desktop Diagnostics för felsökning. Vi rekommenderar att du använder ett GUID, som du kan generera med PowerShell-cmdleten New-Guid .

Valfritt i fjärrskrivbordsklienten
Stöds inte i Windows App.
peeractivityid GUID. Ange det partner- eller kundangivna ID som du kan använda med Azure Virtual Desktop Diagnostics för felsökning. Vi rekommenderar att du använder ett GUID, som du kan generera med PowerShell-cmdleten New-Guid .

Valfritt i fjärrskrivbordsklienten
Stöds inte i Windows App.
usemultimon Sant eller falskt Ange om fjärrsessionen ska använda en eller flera bildskärmar från den lokala datorn.

Valfritt i fjärrskrivbordsklienten och Windows App

Exempel:

ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1&username=user@contoso.com&version=0

ms-rd

Här är listan över kommandon som stöds för ms-rd och deras motsvarande parametrar.

Tips

Om du använder ms-rd: utan kommandon startas fjärrskrivbordsklienten.

ms-rd:prenumerera

ms-rd:subscribe startar fjärrskrivbordsklienten och startar prenumerationsprocessen.

Kommandonamn: prenumerera

Kommandoparametrar:

Parameter Värden Beskrivning
URL En giltig webbadress, till exempel https://rdweb.wvd.microsoft.com. Ange en URL för arbetsytan.

Exempel:

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

Kända begränsningar

Här är kända begränsningar med URI-scheman:

Nästa steg

Lär dig hur du ansluter till Azure Virtual Desktop med fjärrskrivbordsklienten för Windows.