Azure Virtual Desktop (classique) PowerShell
Important
Ce contenu s’applique à Azure Virtual Desktop (classique), qui ne prend pas en charge les objets Azure Virtual Desktop pour Azure Resource Manager. Si vous essayez de gérer des objets Azure Virtual Desktop pour Azure Resource Manager, consultez cet article.
Cet article permet de résoudre les problèmes et erreurs rencontrés lors de l’utilisation de PowerShell avec Azure Virtual Desktop. Pour plus d’informations sur les Services Bureau à distance PowerShell, voir Azure Virtual Desktop PowerShell.
Fournir des commentaires
Rendez-vous sur le site Azure Virtual Desktop Tech Community pour discuter du service Azure Virtual Desktop avec l’équipe de produit et les membres actifs de la communauté.
Commandes PowerShell utilisées pendant la configuration d’Azure Virtual Desktop
Cette section présente les commandes PowerShell généralement employées pour configurer Azure Virtual Desktop. Elle explique également comment résoudre les problèmes qui peuvent se produire lors de leur utilisation.
Erreur : Commande Add-RdsAppGroupUser : le UserPrincipalName spécifié est déjà affecté à un groupe d’applications RemoteApp dans le pool d’hôte spécifié
Add-RdsAppGroupUser -TenantName <TenantName> -HostPoolName <HostPoolName> -AppGroupName 'Desktop Application Group' -UserPrincipalName <UserName>
Cause : le nom d’utilisateur utilisé a déjà été attribué à un groupe d’applications d’un type différent. Il est impossible d’attribuer des utilisateurs à un bureau à distance et à un groupe d’applications RemoteApp dans un 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 différents pools d'hôtes ou accordez uniquement l'accès utilisateur au bureau distant, ce qui permettra l'utilisation de n'importe quelle application sur la machine virtuelle hôte de session.
Erreur : Commande Add-RdsAppGroupUser : le UserPrincipalName spécifié n’existe pas dans l’instance Microsoft Entra ID associée au locataire du 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’instance Microsoft Entra liée au locataire Azure Virtual Desktop.
Correctif : Vérifiez les éléments dans la liste suivante.
- L’utilisateur est synchronisé avec Microsoft Entra ID.
- L’utilisateur n’est pas lié à commerce B2C ou B2B.
- Le locataire Azure Virtual Desktop est lié à la bonne instance Microsoft Entra ID.
Erreur : Get-RdsDiagnosticActivities : l’utilisateur n’est pas autorisé à interroger le service de gestion
Get-RdsDiagnosticActivities -ActivityId <ActivityId>
Cause : paramètre -TenantName
Correction : Envoyez Get-RdsDiagnosticActivities avec -TenantName <TenantName>.
Erreur : Get-RdsDiagnosticActivities : l’utilisateur n’est pas autorisé à interroger le service de gestion
Get-RdsDiagnosticActivities -Deployment -username <username>
Cause : utilisation du commutateur -Deployment.
Correctif : le commutateur -Deployment ne peut être utilisé que par des 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é ne dispose pas des autorisations de propriétaire de Services Bureau à distance sur le client.
Correctif 1 : Un utilisateur disposant d’autorisations de propriétaire de Services Bureau à distance doit exécuter l’attribution de rôle.
Cause 2 : Le compte utilisé dispose d’autorisations de propriétaire Services Bureau à distance, mais ne fait pas partie de l’instance Microsoft Entra ID du locataire ou n’est pas autorisé à interroger l’instance Microsoft Entra ID où se trouve l’utilisateur.
Correctif 2 : Un utilisateur disposant d’autorisations Active Directory doit exécuter l’attribution de rôle.
Remarque
New-RdsRoleAssignment ne peut pas accorder d’autorisations à un utilisateur qui n’existe pas dans l’instance Microsoft Entra ID.
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 feuilles du pool d’hôtes, cela ne fonctionnera pas.
Correctif : Exécutez 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 découvrir une vue d’ensemble de la résolution des problèmes Azure Virtual Desktop et des procédures d’escalade, consultez l’article Vue d’ensemble du dépannage, commentaires et support.
- Pour résoudre les problèmes de création d’un locataire et d’un pool d’hôtes dans un environnement Azure Virtual Desktop, consultez Création d’un locataire et d’un pool d’hôtes.
- Pour résoudre les problèmes de configuration d’une machine virtuelle dans Azure Virtual Desktop, consultez Configuration d’une machine virtuelle hôte de session.
- Pour résoudre les problèmes de connexion au client Azure Virtual Desktop, consultez Connexions au service Azure Virtual Desktop.
- Pour résoudre les problèmes liés aux clients Bureau à distance, consultez Résoudre des problèmes du client Bureau à distance.
- Pour plus d’informations sur le service, consultez Environnement Azure Virtual Desktop.
- Suivez le Didacticiel : Résoudre les problèmes liés aux 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 visant à déterminer les erreurs au cours du déploiement, consultez Voir les opérations de déploiement.