Dela via

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

  • Artikel

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

Den här artikeln beskriver tillgängliga kommandon och parametrar, tillsammans med några exempel.

Klienter som stöds

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

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 listan över kommandon som stöds för ms-avd och deras motsvarande parametrar.

ms-avd:connect

ms-avd:connect letar upp en angiven Azure Virtual Desktop-resurs och initierar RDP-sessionen och ansluter direkt en angiven användare till den 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 för en värdpool, arbetsyta, programgrupp eller program. Du kan också använda REST-API:er för skrivbordsvirtualisering.
resourceid Objekt-ID (GUID). Ange objekt-ID för en publicerad resurs som finns i arbetsytan. Värdet kan vara för ett skrivbord eller RemoteApp.

Information om hur du hämtar objekt-ID-värdet med PowerShell finns i Hämta objekt-ID för en värdpool, arbetsyta, programgrupp eller program. Du kan också använda REST-API:er för skrivbordsvirtualisering.
användare Användarens huvudnamn (UPN), till exempel user@contoso.com. Ange en giltig användare med åtkomst till den angivna resursen.
env (valfritt) avdarm (kommersiell Azure)
avdgov (Azure Government)		 Ange det Azure-moln där resurser finns.
version 0 Ange vilken version av anslutnings-URI-schemat som ska användas.
launchpartnerid (valfritt) GUID. Ange det partner- eller kund-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 .
peeractivityid (valfritt) GUID. Ange det partner- eller kund-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 .
usemultimon sant eller falskt Ange om fjärrsessionen ska använda en eller flera skärmar från den lokala datorn.

Exempel:

ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=c2f5facc-196f-46af-991e-a90f3252c185&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.

Dricks

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

ms-rd:subscribe

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

Kommandonamn: prenumerera

Kommandoparametrar:

Parameter Värden beskrivning
URL En giltig URL, 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.