Udostępnij przez


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
Windows App 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 Windows App wersji 2.0.804.0 lub nowszej, protokół ms-avd uruchomi Windows App.

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 Windows App
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 Windows App
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.

Wymagane w kliencie pulpitu zdalnego i Windows App
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 Windows App.
Wersja 0 Określ wersję schematu identyfikatora URI połączenia do użycia.

Wymagane w kliencie pulpitu zdalnego
Nieobsługiwane w Windows App.
launchpartnerid 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 Windows App.
peeractivityid 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 Windows App.
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 Windows App 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.