Udostępnij za pośrednictwem

Program PowerShell usługi Azure Virtual Desktop (wersja klasyczna)

  • Artykuł

Ważny

Ta zawartość dotyczy usługi Azure Virtual Desktop (klasycznej), która nie obsługuje obiektów usługi Azure Resource Manager usługi Azure Virtual Desktop. Jeśli próbujesz zarządzać obiektami Azure Virtual Desktop przy użyciu Azure Resource Manager, odwiedź ten artykuł.

Skorzystaj z tego artykułu, aby rozwiązać problemy i błędy podczas korzystania z programu PowerShell w usłudze Azure Virtual Desktop. Aby uzyskać więcej informacji na temat PowerShell dla Usług Pulpitu Zdalnego, zobacz PowerShell dla Azure Virtual Desktop.

Prześlij opinię

Odwiedź społeczność techniczną Azure Virtual Desktop, aby omówić usługę Azure Virtual Desktop z zespołem produktowym i aktywnymi członkami społeczności.

Polecenia programu PowerShell używane podczas konfigurowania usługi Azure Virtual Desktop

W tej sekcji wymieniono polecenia programu PowerShell, które są zwykle używane podczas konfigurowania usługi Azure Virtual Desktop i przedstawiono sposoby rozwiązywania problemów, które mogą wystąpić podczas korzystania z nich.

Błąd: Add-RdsAppGroupUser polecenie — określona nazwa użytkownika UserPrincipalName jest już przypisana do grupy aplikacji RemoteApp w określonej puli hostów

Add-RdsAppGroupUser -TenantName <TenantName> -HostPoolName <HostPoolName> -AppGroupName 'Desktop Application Group' -UserPrincipalName <UserName>

Przyczyna: Użyta nazwa użytkownika została już przypisana do grupy aplikacji innego typu. Użytkownicy nie mogą być przypisani zarówno do pulpitu zdalnego, jak i grupy aplikacji RemoteApp w tej samej puli hostów sesji.

Poprawka: Jeśli użytkownik potrzebuje zarówno usługi RemoteApp, jak i pulpitu, utwórz różne pule hostów lub przyznaj użytkownikowi dostęp tylko do pulpitu zdalnego, co pozwoli na korzystanie z dowolnej aplikacji na maszynie wirtualnej hosta sesji.

Błąd: polecenie Add-RdsAppGroupUser — Określony UserPrincipalName nie istnieje w Microsoft Entra ID skojarzonym z dzierżawą Remote Desktop.

Add-RdsAppGroupUser -TenantName <TenantName> -HostPoolName <HostPoolName> -AppGroupName "Desktop Application Group" -UserPrincipalName <UserPrincipalName>

Przyczyna: Nie można odnaleźć użytkownika określonego przez -UserPrincipalName w usłudze Microsoft Entra powiązanej z dzierżawą usługi Azure Virtual Desktop.

Poprawka: Potwierdzić elementy na poniższej liście.

  • Użytkownik jest synchronizowany z identyfikatorem Entra firmy Microsoft.
  • Użytkownik nie jest związany wyłącznie z handlem typu business to consumer (B2C) ani business to business (B2B).
  • Środowisko usługi Azure Virtual Desktop jest powiązane z odpowiednim Microsoft Entra ID.

Błąd: Get-RdsDiagnosticActivities — użytkownik nie ma autoryzacji do wykonywania zapytań dotyczących usługi zarządzania

Get-RdsDiagnosticActivities -ActivityId <ActivityId>

Przyczyna: parametr -TenantName

Poprawka: Problem z Get-RdsDiagnosticActivities -TenantName <TenantName>.

Błąd: Get-RdsDiagnosticActivities — użytkownik nie ma autoryzacji do wykonywania zapytań dotyczących usługi zarządzania

Get-RdsDiagnosticActivities -Deployment -username <username>

Przyczyna: Używanie przełącznika -Deployment.

Poprawka: przełącznik -Deployment może być używany tylko przez administratorów wdrożenia. Administratorzy ci są zazwyczaj członkami zespołu usług pulpitu zdalnego/usługi Azure Virtual Desktop. Zastąp przełącznik -Deployment na -TenantName <TenantName>.

Błąd: New-RdsRoleAssignment — użytkownik nie ma autoryzacji do wykonywania zapytań dotyczących usługi zarządzania

Przyczyna 1: Używane konto nie ma uprawnień właściciela dla Usług Pulpitu Zdalnego w dzierżawie.

Poprawka 1: Użytkownik z uprawnieniami właściciela usług pulpitu zdalnego musi wykonać przypisanie roli.

Przyczyna 2: Używane konto ma uprawnienia właściciela usług pulpitu zdalnego, ale nie jest częścią identyfikatora Microsoft Entra dzierżawy lub nie ma uprawnień do wykonywania zapytań dotyczących identyfikatora Microsoft Entra, w którym znajduje się użytkownik.

Poprawka 2: użytkownik z uprawnieniami usługi Active Directory musi wykonać przypisanie roli.

Notatka

New-RdsRoleAssignment nie może udzielić uprawnień użytkownikowi, który nie istnieje w identyfikatorze Entra firmy Microsoft.

Błąd: Nie można usunąć puli SessionHostPool

Ten błąd zwykle występuje po uruchomieniu następującego polecenia, aby spróbować usunąć hosta sesji.

Remove-RdsHostPool -TenantName <TenantName> -Name <HostPoolName>

Przyczyna: Jeśli uruchomisz polecenie przed usunięciem elementów liściowych puli hostów, nie zadziała.

Poprawka: Uruchom następujące polecenie, aby usunąć hosta sesji.

Get-RdsSessionHost-TenantName <TenantName> -Hostpook <HostPoolName> | Remove-RdsSessionHost -Force

Użycie polecenia force pozwala usunąć hosta sesji, nawet jeśli ma przypisanych użytkowników.

Następne kroki