Jednolite schematy identyfikatorów zasobów z klientem pulpitu zdalnego dla Azure Virtual Desktop

Schematy identyfikatora URI (Uniform Resource Identifier) umożliwiają wywoływanie klienta pulpitu zdalnego przy użyciu określonych poleceń, parametrów i wartości do użycia z usługą Azure Virtual Desktop. Możesz na przykład subskrybować obszar roboczy lub nawiązać połączenie z określonym pulpitem lub aplikacją zdalną.

W tym artykule opisano dostępne polecenia i parametry wraz z kilkoma przykładami.

Obsługiwani klienci

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

Klient Wersja
Klient pulpitu zdalnego dla systemu Windows 1.2.4065 i nowsze
aplikacja dla systemu Windows dla systemu Windows
Tylko ms-avd
2.0.804.0 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ą polecenia ms-avd można określić określony zasób usługi Virtual Desktop Azure i użytkownika, z którym ma zostać nawiązane połączenie. Za pomocą usługi ms-rd można automatycznie subskrybować obszar roboczy w kliencie pulpitu zdalnego, zamiast ręcznie dodawać obszar roboczy.

W poniższych sekcjach szczegółowo opisano polecenia i parametry, których można użyć z każdym schematem identyfikatora URI.

ms-avd

Schemat jednolitego identyfikatora zasobu ms-avd dla Azure Virtual Desktop jest teraz ogólnie dostępny. Oto lista aktualnie obsługiwanych poleceń dla ms-avd i ich odpowiednich parametrów.

Ważna

Jeśli na urządzeniu zainstalowano zarówno klienta usług pulpitu zdalnego, jak i aplikacja dla systemu Windows wersji 2.0.804.0 lub nowszej, protokół ms-avd uruchomi aplikacja dla systemu Windows.

ms-avd:connect

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

Nazwa polecenia: połącz

Parametry polecenia:

Parametr Wartości Opis
workspaceid 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.

Wymagane w kliencie pulpitu zdalnego
Nieobsługiwane w aplikacja dla systemu Windows
Resourceid Identyfikator obiektu (GUID). Określ identyfikator obiektu opublikowanego zasobu zawartego w obszarze roboczym. Wartość może dotyczyć aplikacji klasycznej lub zdalnej.

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.

Wymagane w kliencie pulpitu zdalnego i aplikacja dla systemu Windows
Użytkownika 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.

Wymagane w kliencie pulpitu zdalnego i aplikacja dla systemu Windows
Env avdarm (komercyjna Azure)
usgov (Azure Government)
Określ chmurę Azure, w której znajdują się zasoby.

Opcjonalne w kliencie pulpitu zdalnego
Nieobsługiwane w aplikacja dla systemu Windows.
Wersja 0 Określ wersję schematu identyfikatora URI połączenia do użycia.

Wymagane w kliencie pulpitu zdalnego
Nieobsługiwane w aplikacja dla systemu Windows.
launchpartnerid Identyfikator guid. Określ identyfikator podany przez partnera lub klienta, którego można użyć w Azure diagnostyki pulpitu wirtualnego, aby ułatwić rozwiązywanie problemów. Zalecamy użycie identyfikatora GUID, który można wygenerować za pomocą polecenia cmdlet programu PowerShell New-Guid .

Opcjonalne w kliencie pulpitu zdalnego
Nieobsługiwane w aplikacja dla systemu Windows.
peeractivityid Identyfikator guid. Określ identyfikator podany przez partnera lub klienta, którego można użyć w Azure diagnostyki pulpitu wirtualnego, aby ułatwić rozwiązywanie problemów. Zalecamy użycie identyfikatora GUID, który można wygenerować za pomocą polecenia cmdlet programu PowerShell New-Guid .

Opcjonalne w kliencie pulpitu zdalnego
Nieobsługiwane w aplikacja dla systemu Windows.
usemultimon true lub false Określ, czy sesja zdalna będzie używać jednego lub wielu wyświetlaczy z komputera lokalnego.

Opcjonalne w kliencie i aplikacja dla systemu Windows pulpitu zdalnego

Przykład:

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

ms-rd

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

Porada

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

ms-rd:subscribe

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

Nazwa polecenia: subskrybowanie

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 identyfikatora URI:

  • Nie można skonfigurować właściwości wyświetlania za pośrednictwem identyfikatora URI. Właściwości wyświetlania można skonfigurować jako administrator w puli hostów lub użytkownicy końcowi mogą konfigurować 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.