Freigeben über

Azure Virtual Desktop (klassisch) PowerShell

  • Artikel

Wichtig

Dieser Inhalt gilt für Azure Virtual Desktop (klassisch), der Azure Resource Manager Azure Virtual Desktop-Objekte nicht unterstützt. Wenn Sie versuchen, Azure Resource Manager Azure-Virtual-Desktop-Objekte zu verwalten, lesen Sie den Artikel .

Verwenden Sie diesen Artikel, um Fehler und Probleme bei der Verwendung von PowerShell mit Azure Virtual Desktop zu beheben. Weitere Informationen zu PowerShell für Remotedesktopdienste finden Sie unter Azure Virtual Desktop PowerShell.

Feedback geben

Besuchen Sie die Azure Virtual Desktop Tech Community, um den Azure Virtual Desktop-Dienst mit dem Produktteam und aktiven Communitymitgliedern zu besprechen.

PowerShell-Befehle, die während der Azure Virtual Desktop-Einrichtung verwendet werden

In diesem Abschnitt werden PowerShell-Befehle aufgeführt, die normalerweise beim Einrichten von Azure Virtual Desktop verwendet werden, und bietet Möglichkeiten zum Beheben von Problemen, die bei der Verwendung auftreten können.

Fehler: Add-RdsAppGroupUser -- Der angegebene UserPrincipalName ist bereits einer RemoteApp-App-Gruppe im angegebenen Hostpool zugewiesen.

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

Ursache: Der verwendete Benutzername wurde bereits einer Anwendungsgruppe eines anderen Typs zugewiesen. Benutzern kann nicht sowohl eine Remotedesktop- als auch eine RemoteApp-Anwendungsgruppe innerhalb desselben Sitzungshostpools zugewiesen werden.

Fix: Wenn der Benutzer sowohl eine RemoteApp als auch einen Desktop benötigt, erstellen Sie unterschiedliche Hostpools oder gewähren Sie nur Benutzerzugriff auf den Remotedesktop, wodurch die Verwendung einer Anwendung auf der Sitzungshost-VM möglich ist.

Fehler: Add-RdsAppGroupUser Befehl -- Der angegebene UserPrincipalName existiert nicht in der Microsoft Entra-ID, die dem Remote-Desktop-Mandanten zugeordnet ist.

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

Ursache: Der vom -UserPrincipalName angegebene Benutzer kann nicht in Microsoft Entra gefunden werden, das dem Azure Virtual Desktop-Mandanten zugeordnet ist.

Fix: Bestätigen Sie die Elemente in der folgenden Liste.

  • Der Benutzer wird mit der Microsoft Entra-ID synchronisiert.
  • Der Benutzer ist nicht an Business-to-Consumer (B2C) oder Business-to-Business (B2B)-Commerce gebunden.
  • Der Azure Virtual Desktop Mandant ist an die richtige Microsoft Entra-ID gebunden.

Fehler: Get-RdsDiagnosticActivities - Der Benutzer ist nicht berechtigt, den Verwaltungsdienst abzufragen.

Get-RdsDiagnosticActivities -ActivityId <ActivityId>

Ursache: -TenantName Parameter

Beheben: Problem Get-RdsDiagnosticActivities mit -TenantName <TenantName>.

Fehler: Get-RdsDiagnosticActivities : Der Benutzer ist nicht berechtigt, den Verwaltungsdienst abzufragen.

Get-RdsDiagnosticActivities -Deployment -username <username>

Ursache: Verwenden des Schalters -Deployment.

Fix: -Deployment Switch kann nur von Bereitstellungsadministratoren verwendet werden. Diese Administratoren sind in der Regel Mitglieder des Remotedesktopdienste- und Azure Virtual Desktop-Teams. Ersetzen Sie den Schalter -Deployment mit -TenantName <TenantName>.

Fehler: New-RdsRoleAssignment : Der Benutzer ist nicht berechtigt, den Verwaltungsdienst abzufragen.

Ursache 1: Das verwendete Konto besitzt keine Besitzerberechtigungen für die Remotedesktopdienste des Mandanten.

Fix 1: Ein Benutzer mit Besitzerberechtigungen für Remotedesktopdienste muss die Rollenzuweisung ausführen.

Ursache 2: Das verwendete Konto verfügt über Besitzerberechtigungen für Remote-Desktop-Dienste, ist aber nicht Teil der Microsoft Entra-ID des Mandanten oder verfügt nicht über Berechtigungen, um die Microsoft Entra-ID abzufragen, in der sich der Benutzer befindet.

Fix 2: Ein Benutzer mit Active Directory-Berechtigungen muss die Rollenzuweisung ausführen.

Anmerkung

New-RdsRoleAssignment kann keine Berechtigungen für einen Benutzer erteilen, der nicht in der Microsoft Entra-ID vorhanden ist.

Fehler: SessionHostPool konnte nicht gelöscht werden.

Dieser Fehler tritt in der Regel auf, wenn Sie den folgenden Befehl ausführen, um zu versuchen, einen Sitzungshost zu entfernen.

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

Ursache: Wenn Sie den Befehl vor dem Löschen der Blattobjekte des Hostpools ausführen, funktioniert dies nicht.

Fix: Führen Sie den folgenden Befehl aus, um den Sitzungshost zu löschen.

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

Wenn Sie den Befehl "force" verwenden, können Sie den Sitzungshost auch dann löschen, wenn ihm Benutzer zugewiesen wurden.

Nächste Schritte