Azure Virtual Desktop (klassisch): PowerShell

  • Artikel

Wichtig

Dieser Inhalt gilt für Azure Virtual Desktop (klassisch). Der Dienst unterstützt keine Azure Virtual Desktop-Objekte in Azure Resource Manager. Wenn Sie Azure Virtual Desktop-Objekte in Azure Resource Manager verwalten möchten, helfen Ihnen die Informationen in diesem Artikel weiter.

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

Feedback geben

In der Azure Virtual Desktop Tech Community können Sie sich mit dem Produktteam und aktiven Communitymitgliedern über den Azure Virtual Desktop-Dienst austauschen.

Während der Installation von Azure Virtual Desktop verwendete PowerShell-Befehle

Dieser Abschnitt listet PowerShell-Befehle auf, die typischerweise beim Einrichten von Azure Virtual Desktop verwendet werden, und bietet Lösungen für Probleme, die bei der Verwendung dieser Befehle auftreten können.

Error: Befehl Add-RdsAppGroupUser: Der angegebene UserPrincipalName ist bereits einer RemoteApp-App-Gruppe im angegebenen Hostpool zugeordnet.

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

Ursache: Der verwendete Benutzername wurde bereits einer Anwendungsgruppe eines anderen Typs zugewiesen. Benutzer*innen können nicht gleichzeitig einem Remotedesktop und einer RemoteApp-Anwendungsgruppe im selben Sitzungshostpool zugewiesen werden.

Fix: Wenn der Benutzer sowohl eine Remote-App als auch den Desktop benötigt, erstellen Sie verschiedene Hostpools, oder gewähren Sie dem Benutzer nur Zugriff auf den Remotedesktop, was die Verwendung einer beliebigen Anwendung auf der Sitzungshost-VM ermöglicht.

Fehler: Befehl Add-RdsAppGroupUser: Der angegebene UserPrincipalName ist nicht im Microsoft Entra ID vorhanden, das dem Remote Desktop-Mandanten zugeordnet ist

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

Ursache: Der durch -UserPrincipalName angegebene Benutzer kann nicht im Microsoft Entra gefunden werden, das an den Azure Virtual Desktop-Mandanten gebunden ist.

Behebung: Bestätigen Sie die einzelnen Punkte in der folgenden Liste.

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

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

Get-RdsDiagnosticActivities -ActivityId <ActivityId>

Ursache: Parameter -TenantName

Fix: Geben Sie Get-RdsDiagnosticActivities mit -TenantName <Mandantenname> aus.

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

Get-RdsDiagnosticActivities -Deployment -username <username>

Ursache: Verwendung des Schalters -Deployment.

Behebung: Der Schalter -Deployment kann nur von Bereitstellungsadministratoren verwendet werden. Diese Administratoren sind in der Regel Mitglieder des Teams für Remotedesktopdienste/Azure Virtual Desktop. Ersetzen Sie den Schalter „-Deployment“ durch „-TenantName <Mandantenname>“.

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

Ursache 1: Das verwendete Konto hat keine Remote Desktop Services-Besitzerberechtigungen für den Mandanten.

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

Ursache 2: Das verwendete Konto hat Besitzerberechtigungen für Remotedesktopdienste, ist aber nicht Teil von Microsoft Entra ID der Umgebung oder verfügt nicht über Berechtigungen zum Abfragen von Microsoft Entra ID, in dem sich der Benutzer befindet.

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

Hinweis

New-RdsRoleAssignment kann einem Benutzer keine Berechtigungen erteilen, der nicht in 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 einen Sitzungshost zu entfernen.

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

Ursache: Wenn Sie den Befehl ausführen, bevor Sie die Blattobjekte des Hostpools gelöscht haben, funktioniert er nicht.

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

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

Mit dem Befehl „force“ können Sie den Sitzungshost auch dann löschen, wenn ihm Benutzer zugewiesen sind.

Nächste Schritte