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) | Identyfikator 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) | Identyfikator 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. |
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 Połączenie do usługi Azure Virtual Desktop przy użyciu klienta pulpitu zdalnego dla systemu Windows.