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
- Pour obtenir une vue d’ensemble de la résolution des problèmes liés à Azure Virtual Desktop et aux pistes d’escalade, consultez Vue d’ensemble de la résolution des problèmes, commentaires et support.
- Pour résoudre les problèmes lors de la création d’un locataire et d’un pool d’hôtes dans un environnement Azure Virtual Desktop, consultez création de locataire et de pool d’hôtes.
- Pour résoudre les problèmes lors de la configuration d’une machine virtuelle dans Azure Virtual Desktop, consultez configuration de machine virtuelle hôte de session.
- Pour résoudre les problèmes liés aux connexions au client Azure Virtual Desktop, consultez connexions de service Azure Virtual Desktop.
- Pour résoudre les problèmes liés aux clients Bureau à distance, consultez Résoudre les problèmes liés au client Bureau à distance
- Pour en savoir plus sur le service, consultez l'environnement Bureau Virtuel Azure.
- Pour suivre un didacticiel de résolution des problèmes, consultez Tutoriel : Résoudre les problèmes de déploiements de modèles Resource Manager.
- Pour en savoir plus sur les actions d’audit, consultez Opérations d’audit avec Resource Manager.
- Pour en savoir plus sur les actions permettant de déterminer les erreurs lors du déploiement, consultez Afficher les opérations de déploiement.