Udostępnij za pośrednictwem


Ujednolicone schematy identyfikatorów zasobów z klientem pulpitu zdalnego dla usługi Azure Virtual Desktop

Można użyć schematów uniform Resource Identifier (URI), aby wywołać klienta pulpitu zdalnego z określonymi poleceniami, parametrami i wartościami do użycia z usługą Azure Virtual Desktop. Możesz na przykład zasubskrybować obszar roboczy lub połączyć się z określonym pulpitem lub usługą RemoteApp.

Ten artykuł zawiera szczegółowe informacje o dostępnych poleceniach i parametrach wraz z kilkoma przykładami.

Obsługiwani klienci

W poniższej tabeli wymieniono obsługiwanych klientów do użycia z schematami identyfikatorów URI:

Klient Wersja
Klient pulpitu zdalnego dla systemu Windows 1.2.4065 i nowsze

Dostępne schematy identyfikatorów URI

Istnieją dwa schematy identyfikatorów URI dla obsługiwanych klientów pulpitu zdalnego, ms-avd i ms-rd. Za pomocą biblioteki ms-avd można określić konkretny zasób usługi Azure Virtual Desktop i użytkownika, z którym chcesz nawiązać połączenie. Dzięki funkcji ms-rd można automatycznie subskrybować obszar roboczy w kliencie pulpitu zdalnego, zamiast ręcznie dodawać obszar roboczy.

W poniższych sekcjach opisano polecenia i parametry, których można używać z każdym schematem identyfikatorów URI.

ms-avd

Schemat ms-avd Uniform Resource Identifier dla usługi Azure Virtual Desktop jest teraz ogólnie dostępny. Oto lista aktualnie obsługiwanych poleceń dla ms-avd i ich odpowiednich parametrów.

ms-avd:connect

ms-avd:connect lokalizuje określony zasób usługi Azure Virtual Desktop i inicjuje sesję protokołu RDP, bezpośrednio łącząc określonego użytkownika z tym zasobem.

Nazwa polecenia: połącz

Parametry polecenia:

Parametr Wartości opis
identyfikator obszaru roboczego Identyfikator obiektu (GUID). Określ identyfikator obiektu prawidłowego obszaru roboczego.

Aby uzyskać wartość identyfikatora obiektu przy użyciu programu PowerShell, zobacz Pobieranie identyfikatora obiektu puli hostów, obszaru roboczego, grupy aplikacji lub aplikacji. Możesz również użyć interfejsów API REST wirtualizacji pulpitu.
resourceid Identyfikator obiektu (GUID). Określ identyfikator obiektu opublikowanego zasobu zawartego w obszarze roboczym. Wartość może być dla pulpitu lub usługi RemoteApp.

Aby uzyskać wartość identyfikatora obiektu przy użyciu programu PowerShell, zobacz Pobieranie identyfikatora obiektu puli hostów, obszaru roboczego, grupy aplikacji lub aplikacji. Możesz również użyć interfejsów API REST wirtualizacji pulpitu.
Użytkownik Główna nazwa użytkownika (UPN), na przykład user@contoso.com. Określ prawidłowego użytkownika z dostępem do określonego zasobu.
env (opcjonalnie) avdarm (komercyjna platforma Azure)
avdgov (Azure Government)
Określ chmurę platformy Azure, w której znajdują się zasoby.
version 0 Określ wersję schematu identyfikatora URI łączenia do użycia.
launchpartnerid (opcjonalnie) GUID. Określ identyfikator partnera lub podanego przez klienta, którego można użyć z diagnostyką usługi Azure Virtual Desktop, aby ułatwić rozwiązywanie problemów. Zalecamy użycie identyfikatora GUID, który można wygenerować za pomocą polecenia cmdlet New-Guid programu PowerShell.
peeractivityid (opcjonalnie) GUID. Określ identyfikator partnera lub podanego przez klienta, którego można użyć z diagnostyką usługi Azure Virtual Desktop, aby ułatwić rozwiązywanie problemów. Zalecamy użycie identyfikatora GUID, który można wygenerować za pomocą polecenia cmdlet New-Guid programu PowerShell.
usemultimon prawda lub fałsz Określ, czy sesja zdalna będzie używać jednego lub wielu ekranów z komputera lokalnego.

Przykład:

ms-avd:connect?workspaceId=1638e073-63b2-46d8-bd84-ea02ea905467&resourceid=c2f5facc-196f-46af-991e-a90f3252c185&username=user@contoso.com&version=0

ms-rd

Oto lista aktualnie obsługiwanych poleceń dla biblioteki ms-rd i ich odpowiednich parametrów.

Napiwek

Użycie ms-rd: bez żadnych poleceń powoduje uruchomienie klienta pulpitu zdalnego.

ms-rd:subskrybuj

ms-rd:subscribe uruchamia klienta pulpitu zdalnego i uruchamia proces subskrypcji.

Nazwa polecenia: subskrybuj

Parametry polecenia:

Parametr Wartości opis
Adres URL Prawidłowy adres URL, taki jak https://rdweb.wvd.microsoft.com. Określ adres URL obszaru roboczego.

Przykład:

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

Znane ograniczenia

Poniżej przedstawiono znane ograniczenia dotyczące schematów identyfikatorów URI:

  • Nie można skonfigurować właściwości wyświetlania za pomocą identyfikatora URI. Właściwości wyświetlania można skonfigurować jako administrator w puli hostów lub użytkownicy końcowi mogą skonfigurować właściwości wyświetlania w kliencie usługi Azure Virtual Desktop.

Następne kroki

Dowiedz się, jak nawiązać połączenie z usługą Azure Virtual Desktop przy użyciu klienta pulpitu zdalnego dla systemu Windows.