Azure Virtual Desktop (classic) PowerShell

Důležité

Tento obsah platí pro Azure Virtual Desktop (Classic), který nepodporuje objekty Azure Virtual Desktopu Azure Resource Manageru. Pokud se pokoušíte spravovat objekty Azure Resource Manageru azure Virtual Desktopu, přečtěte si tento článek.

Tento článek slouží k řešení chyb a problémů při používání PowerShellu se službou Azure Virtual Desktop. Další informace o PowerShellu služby Vzdálená plocha najdete v tématu Azure Virtual Desktop PowerShell.

Poskytnutí názorů

Navštivte technickou komunitu Azure Virtual Desktopu a prodiskutujte službu Azure Virtual Desktop s produktovým týmem a aktivními členy komunity.

Příkazy PowerShellu používané při nastavování služby Azure Virtual Desktop

Tato část obsahuje seznam příkazů PowerShellu, které se obvykle používají při nastavování služby Azure Virtual Desktop, a poskytuje způsoby řešení problémů, ke kterým může dojít při jejich používání.

Chyba: Příkaz Add-RdsAppGroupUser -- Zadaný userPrincipalName je již přiřazen ke skupině aplikací RemoteApp v zadaném fondu hostitelů.

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

Příčina: Použité uživatelské jméno již bylo přiřazeno ke skupině aplikací jiného typu. Uživatelé se nedají přiřadit ke vzdálené ploše i ke skupině aplikací RemoteApp ve stejném fondu hostitelů relací.

Oprava: Pokud uživatel potřebuje RemoteApp i plochu, vytvořte různé fondy hostitelů nebo udělte uživateli přístup pouze ke vzdálené ploše, což umožní použití jakékoli aplikace na virtuálním počítači hostitele relace.

Chyba: Příkaz Add-RdsAppGroupUser -- Zadaný userPrincipalName neexistuje v ID Microsoft Entra přidruženém k tenantovi vzdálené plochy.

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

Příčina: Uživatel zadaný parametrem -UserPrincipalName nebyl nalezen v microsoft Entra vázaném na tenanta Služby Azure Virtual Desktop.

Oprava: Potvrďte položky v následujícím seznamu.

  • Uživatel se synchuje s Microsoft Entra ID.
  • Uživatel není svázaný s obchodem se spotřebiteli (B2C) ani obchodem B2B (business-to-business).
  • Tenant Služby Azure Virtual Desktop je svázaný s opravou ID Microsoft Entra.

Chyba: Get-RdsDiagnosticActivities – Uživatel nemá oprávnění k dotazování služby pro správu

Get-RdsDiagnosticActivities -ActivityId <ActivityId>

Příčina: parametr -TenantName

Oprava: Problém Get-RdsDiagnosticActivities s parametrem -TenantName><

Chyba: Get-RdsDiagnosticActivities – uživatel nemá oprávnění k dotazování služby pro správu.

Get-RdsDiagnosticActivities -Deployment -username <username>

Příčina: Použití přepínače -Deployment

Oprava: Přepínač nasazení lze používat pouze správci nasazení. Tito správci jsou obvykle členy týmu Vzdálené plochy nebo Azure Virtual Desktopu. Nahraďte přepínač -Deployment názvem tenanta -TenantName<>.

Chyba: New-RdsRoleAssignment – uživatel nemá oprávnění k dotazování služby pro správu.

Příčina 1: Použitý účet nemá v tenantovi oprávnění vlastníka služby Vzdálená plocha.

Oprava 1: Uživatel s oprávněními vlastníka služby Vzdálená plocha musí provést přiřazení role.

Příčina 2: Použitý účet má oprávnění vlastníka služby Vzdálená plocha, ale není součástí ID Microsoft Entra tenanta nebo nemá oprávnění dotazovat se na ID Microsoft Entra, kde se uživatel nachází.

Oprava 2: Uživatel s oprávněními služby Active Directory musí provést přiřazení role.

Poznámka:

New-RdsRoleAssignment nemůže udělit oprávnění uživateli, který v ID Microsoft Entra neexistuje.

Chyba: Fond hostitelů relací nelze odstranit.

K této chybě obvykle dochází při spuštění následujícího příkazu, který se pokusí odebrat hostitele relace.

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

Příčina: Pokud příkaz spustíte před odstraněním objektů typu list fondu hostitelů, nebude fungovat.

Oprava: Spuštěním následujícího příkazu odstraňte hostitele relace.

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

Pomocí příkazu force můžete hostitele relace odstranit i v případě, že má přiřazené uživatele.

Další kroky