Partage via


PowerShell de Bureau Virtuel Azure (classique)

Important

Ce contenu s’applique à Azure Virtual Desktop (classique), qui ne prend pas en charge les objets Azure Resource Manager Azure Virtual Desktop. Si vous essayez de gérer les objets du Gestionnaire de ressources Azure pour Azure Virtual Desktop, consultez cet article.

Utilisez cet article pour résoudre les erreurs et les problèmes liés à l’utilisation de PowerShell avec Azure Virtual Desktop. Pour plus d’informations sur PowerShell pour les services Bureau à distance, voir Azure Virtual Desktop PowerShell.

Fournir des commentaires

Visitez la Azure Virtual Desktop Tech Community pour discuter du service Azure Virtual Desktop avec l’équipe produit et les membres actifs de la communauté.

Commandes PowerShell utilisées lors de l’installation d’Azure Virtual Desktop

Cette section répertorie les commandes PowerShell généralement utilisées lors de la configuration d’Azure Virtual Desktop et fournit des moyens de résoudre les problèmes qui peuvent se produire lors de leur utilisation.

Erreur : Add-RdsAppGroupUser commande -- Le nom UserPrincipalName spécifié est déjà affecté à un groupe d’applications RemoteApp dans le pool d’hôtes spécifié

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

Cause : Le nom d’utilisateur utilisé a déjà été affecté à un groupe d’applications d’un type différent. Les utilisateurs ne peuvent pas être affectés à la fois à un groupe d’applications Bureau à distance et RemoteApp sous le même pool d’hôtes de session.

Correctif : Si l’utilisateur a besoin à la fois d’une application distante et d’un bureau, créez des pools d’hôtes différents ou accordez uniquement l’accès utilisateur au Bureau à distance, ce qui permettra d’utiliser n’importe quelle application sur la machine virtuelle hôte de session.

Erreur : commande Add-RdsAppGroupUser -- Le nom d'utilisateur principal spécifié n’existe pas dans le Microsoft Entra ID lié au locataire Bureau à distance

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

Cause : L’utilisateur spécifié par -UserPrincipalName est introuvable dans l’Entra Microsoft lié au locataire Azure Virtual Desktop.

Correction : Confirmer les éléments de la liste suivante.

  • L’utilisateur est synchronisé avec l’ID Microsoft Entra.
  • L’utilisateur n’est pas lié au commerce de consommation (B2C) ou d’entreprise (B2B).
  • Le client Azure Virtual Desktop est lié à l’ID Microsoft Entra correct.

Erreur : Get-RdsDiagnosticActivities - L’utilisateur n’est pas autorisé à interroger le service de gestion

Get-RdsDiagnosticActivities -ActivityId <ActivityId>

Cause : paramètre -TenantName

correctif : problème Get-RdsDiagnosticActivities avec -TenantName <nom_locataire>.

Erreur : Get-RdsDiagnosticActivities : l’utilisateur n’est pas autorisé à interroger le service de gestion

Get-RdsDiagnosticActivities -Deployment -username <username>

Cause : à l’aide du commutateur -Deployment.

Correctif : -Deployment commutateur ne peut être utilisé que par les administrateurs de déploiement. Ces administrateurs sont généralement membres de l’équipe Services Bureau à distance/Azure Virtual Desktop. Remplacez le commutateur -Deployment par -TenantName <TenantName>.

Erreur : New-RdsRoleAssignment : l’utilisateur n’est pas autorisé à interroger le service de gestion

Cause 1 : Le compte utilisé n'a pas les autorisations de propriétaire des Services Bureau à distance sur le locataire.

Correctif 1 : Un utilisateur disposant des autorisations de propriétaire des services Bureau à distance doit exécuter l’attribution de rôle.

Cause 2 : Le compte utilisé dispose d’autorisations de propriétaire des services Bureau à distance, mais ne fait pas partie de l’ID Microsoft Entra du locataire ou n’a pas les autorisations nécessaires pour interroger l’ID Microsoft Entra où se trouve l’utilisateur.

Correctif 2 : Un utilisateur disposant des autorisations Active Directory doit exécuter l’attribution de rôle.

Note

New-RdsRoleAssignment ne peut pas accorder d’autorisations à un utilisateur qui n’existe pas dans l’ID Microsoft Entra.

Erreur : SessionHostPool n’a pas pu être supprimé

Cette erreur se produit généralement lorsque vous exécutez la commande suivante pour essayer de supprimer un hôte de session.

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

Cause : Si vous exécutez la commande avant de supprimer les objets feuille du pool d’hôtes, cela ne fonctionnera pas.

Correctif : exécuter la commande suivante pour supprimer l’hôte de session.

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

L’utilisation de la commande force vous permet de supprimer l’hôte de session même s’il a affecté des utilisateurs.

Étapes suivantes