Azure Virtual Desktop PowerShell

Wichtig

Dieser Inhalt gilt für Azure Virtual Desktop mit Azure Virtual Desktop-Objekten für Azure Resource Manager. Wenn Sie Azure Virtual Desktop (klassisch) ohne Azure Resource Manager-Objekte verwenden, finden Sie weitere Informationen in diesem Artikel.

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: New-AzRoleAssignment: Die angegebenen Informationen stimmen mit keiner AD-Objekt-ID überein.

New-AzRoleAssignment -SignInName "admins@contoso.com" -RoleDefinitionName "Desktop Virtualization User" -ResourceName "0301HP-DAG" -ResourceGroupName 0301RG -ResourceType 'Microsoft.DesktopVirtualization/applicationGroups'

Ursache: Der durch den Parameter -SignInName angegebene Benutzer kann nicht im Microsoft Entra gefunden werden, das der Azure Virtual Desktop-Umgebung zugeordnet ist.

Behebung: Stellen Sie Folgendes sicher.

  • Der Benutzer sollte mit Microsoft Entra ID synchronisiert werden.
  • Der Benutzer ist nicht mit B2C (Business-to-Consumer) oder B2B (Business-to-Business) Commerce verknüpft.
  • Die Azure Virtual Desktop-Umgebung ist der richtigen Microsoft Entra ID zugeordnet.

Error: New-AzRoleAssignment: „Der Client mit der Objekt-ID hat keine Berechtigung zum Ausführen der Aktion über Bereich (Code: AuthorizationFailed)“

Ursache 1: Das verwendete Konto hat keine Besitzerberechtigungen für das Abonnement.

Behebung 1: Ein Benutzer mit Besitzerberechtigungen muss die Rollenzuweisung ausführen. Alternativ muss der Benutzer der Rolle „Benutzerzugriffsadministrator“ zugewiesen werden, um einen Benutzer einer Anwendungsgruppe zuzuweisen.

Ursache 2: Das verwendete Konto hat Besitzerrechte, 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.

Error: New-AzWvdHostPool: Der Speicherort ist für den Ressourcentyp nicht verfügbar.

New-AzWvdHostPool_CreateExpanded: The provided location 'southeastasia' is not available for resource type 'Microsoft.DesktopVirtualization/hostpools'. List of available regions for the resource type is 'eastus,eastus2,westus,westus2,northcentralus,southcentralus,westcentralus,centralus'.

Ursache: Azure Virtual Desktop unterstützt die Auswahl des Speicherorts von Hostpools, Anwendungsgruppen und Arbeitsbereichen, um Dienstmetadaten an bestimmten Orten zu speichern. Ihre Optionen sind darauf beschränkt, wo diese Funktion verfügbar ist. Dieser Fehler bedeutet, dass das Feature nicht an dem von Ihnen ausgewählten Speicherort verfügbar ist.

Behebung: In der Fehlermeldung wird eine Liste der unterstützten Regionen veröffentlicht. Verwenden Sie stattdessen eine der unterstützten Regionen.

Error: New-AzWvdApplicationGroup muss sich am gleichen Speicherort wie der Hostpool befinden

New-AzWvdApplicationGroup_CreateExpanded: ActivityId: e5fe6c1d-5f2c-4db9-817d-e423b8b7d168 Error: ApplicationGroup must be in same location as associated HostPool

Ursache: Der Speicherort stimmt nicht überein. Alle Hostpools, Anwendungsgruppen und Arbeitsbereiche verfügen über einen Speicherort zum Speichern von Dienstmetadaten. Alle Objekte, die Sie erstellen, die einander zugeordnet sind, müssen sich am gleichen Speicherort befinden. Wenn sich ein Hostpool beispielsweise in eastus befindet, müssen Sie auch die Anwendungsgruppen in eastuserstellen. Wenn Sie einen Arbeitsbereich erstellen, in dem diese Anwendungsgruppen registriert werden, muss sich dieser Arbeitsbereich ebenfalls in eastus befinden.

Behebung: Rufen Sie den Speicherort ab, in dem der Hostpool erstellt wurde, und weisen Sie dann die zu erstellende Anwendungsgruppe dem gleichen Speicherort zu.

Nächste Schritte