Partager via

Azure Virtual Desktop (classique) PowerShell

  • Article

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