Automatiser dans les bureaux virtuels
Avec l’agent Power Automate pour les bureaux virtuels, vous pouvez automatiser les processus sur les bureaux virtuels aussi facilement que sur les appareils physiques. Si votre bureau virtuel utilise Citrix ou Microsoft Remote Desktop Protocol (RDP), vous pouvez capturer des éléments de l’interface utilisateur, déployer des actions d’automatisation de l’interface utilisateur, deployer des actions d’automatisation du navigateur et créer des flux de bureau à l’aide de l’enregistreur, comme sur votre bureau physique.
L’agent Power Automate pour les bureaux virtuels doit être exécuté à la fois lors de la conception d’un flux et lors de son exécution. L’agent démarre automatiquement lorsqu’un utilisateur se connecte au bureau virtuel. S’il ne s’exécute pas sur votre bureau virtuel, lancez l’agent manuellement. Pour lancer manuellement l’agent Power Automate pour les bureaux virtuels, double-cliquez sur le raccourci sur votre bureau ou recherchez Agent Power Automate pour les bureaux virtuels dans le menu Démarrer, puis sélectionnez le résultat correspondant, ou allez dans le répertoire d’installation de l’agent Power Automate pour les bureaux virtuels (par défaut, il s’agit de C:\Program Files (x86)\Power Automate agent for virtual desktops) et double-cliquez sur PAD.RDP.ControlAgent.exe.
Il est important d’installer Power Automate pour le bureau sur la machine sur laquelle vous développez et exécutez vos flux de bureau, et l’agent Power Automate pour les bureaux virtuels sur la machine avec laquelle le flux interagit pour les actions d’automatisation de l’interface utilisateur. Cette deuxième machine peut être un Citrix Desktop, une machine hôte pour une application virtuelle Citrix, un bureau à distance avec la communication Windows RDP ou une machine qui héberge une application Bureau à distance.
Conditions préalables
Votre appareil physique et votre machine virtuelle doivent exécuter Windows 10 Pro, Windows 10 Enterprise, Windows 11 Pro, Windows 11 Enterprise, Windows Server 2016, Windows Server 2019 ou Windows Server 2022.
Assurez-vous que la connexion Citrix ou RDP au bureau virtuel est fermée, puis installez Power Automate sur votre appareil physique.
Un appareil avec le matériel suivant (ces exigences n’incluent pas les ressources obligatoires pour les applications impliquées dans vos flux de bureau) :
Matériel minimal :
- Processeur : 1,50 GHz par session ou plus rapide avec deux cœurs ou plus.
- Stockage : 300 Mo de stockage système pour l’installation de l’agent, plus 500 Mo pour chaque utilisateur (chaque version de Power Automate pour le bureau nécessite qu’un utilisateur dispose de 500 Mo d’espace de stockage).
- RAM : 384 Mo par session.
Matériel recommandé :
- Processeur : 2,00 GHz par session ou plus rapide avec deux cœurs ou plus.
- Stockage : 300 Mo ou plus de stockage système pour l’installation de l’agent, plus 500 Mo ou plus pour chaque utilisateur (chaque version de Power Automate pour le bureau nécessite qu’un utilisateur dispose de 500 Mo d’espace de stockage).
- RAM : 512 Mo ou plus par session.
Installer l’agent Power Automate pour les bureaux virtuels
Téléchargez l’agent Power Automate pour les bureaux virtuels.
Sinon, lancez le concepteur Power Automate pour le bureau et sélectionnez Outils>Power Automate pour les bureaux virtuels.
Copiez le programme d’installation sur le bureau virtuel Citrix ou RDP.
En tant qu’administrateur, exécutez le programme d’installation.
Une fois l’installation terminée, assurez-vous que l’agent apparaît dans la zone de notification du bureau virtuel.
Si vous remarquez que l’agent ne s’exécute pas, redémarrez-le en utilisant le raccourci dans la zone de notification. Si vous rencontrez une erreur, reportez-vous à Résoudre les problèmes de l’agent Power Automate pour les bureaux virtuels.
Synchroniser les versions de Power Automate et de l’agent pour les bureaux virtuels
Pour automatiser sur les bureaux virtuels, les versions de Power Automate et de l’agent Power Automate pour les bureaux virtuels doivent être identiques. Si elles sont différentes lorsque vous commencez à enregistrer ou à capturer des éléments de l’interface utilisateur, sélectionnez Synchroniser lorsque vous êtes invité à les synchroniser.
Si les versions ne sont pas synchronisées lorsqu’un flux de bureau est en cours d’exécution, Power Automate les synchronise automatiquement.
Note
Les DLL de l’agent synchronisé sont stockés dans C:\Users\username\AppData\Local\Microsoft\Power Automate Desktop\RDP Automation Agents.
Distinguer les éléments de l’interface utilisateur capturés sur les bureaux virtuels
Les sélecteurs générés de fenêtres et d’éléments de l’interface utilisateur sont les mêmes, qu’ils aient été capturés sur un appareil physique ou sur un bureau virtuel. Les indications visuelles et l’arborescence du volet des éléments de l’interface utilisateur vous aident à distinguer les éléments de l’interface utilisateur capturés sur les bureaux virtuels de ceux capturés sur un appareil physique. En savoir plus sur les éléments de l’interface utilisateur et les sélecteurs.
Les éléments de l’interface utilisateur capturés sur l’appareil physique sont situés sous le parent Ordinateur. Les éléments de l’interface utilisateur capturés sur un bureau virtuel sont situés sous un parent RDP ou Citrix. Chaque bureau virtuel a sa propre arborescence individuelle. Un préfixe numérique vous aide à distinguer les bureaux virtuels du même type.
Note
Lorsque vous capturez un élément d’interface utilisateur dans un bureau virtuel, une application virtuelle ou RemoteApp, il est lié aux détails (IP, nom, etc.) de la machine au moment de la capture. Si vous souhaitez interagir avec le même élément d’interface utilisateur sur une autre machine, vous devrez le capturer à nouveau sur cette machine.
Communication entre Power Automate pour le bureau et l’agent Power Automate pour les bureaux virtuels en cas de synchronisation
Informations de base
Un agent d’automatisation est un agent spécialisé envoyé au bureau à distance une fois la communication initiale avec l’agent de contrôle terminée. Il fournit une fonctionnalité spécifique pour l’automatisation de l’interface utilisateur pour la version de Power Automate pour le bureau qui la demande.
Le répertoire de stockage de l’agent d’automatisation fait référence au chemin par défaut où sont stockés les agents d’automatisation. Par défaut, ce chemin est « %LOCALAPPDATA%\Microsoft\Power Automate Desktop\RDP Automation Agents ». Cependant, si la propriété « PAD_RDP_STORAGE_DIRECTORY » est définie sur la machine, alors le chemin devient « %PAD_RDP_STORAGE_DIRECTORY%\Microsoft\Power Automate Desktop\RDP Automation Agents ».
Phrases de communication
Le tableau et le diagramme suivants décrivent les différentes phases de communication :
| Phase | Description |
|---|---|
| Établissement d’une liaison initiale | Première communication entre Power Automate pour le bureau et l’agent Power Automate pour les bureaux virtuels. Les versions de Power Automate pour le bureau et de l’agent Power Automate pour les bureaux virtuels ne sont pas les mêmes. |
| Synchroniser | Cette phase se produit lorsque l’utilisateur choisit de synchroniser les versions de Power Automate pour le bureau et de l’agent Power Automate pour les bureaux virtuels. |
| Nouvelle tentative d’établissement d’une liaison | Une fois le processus de synchronisation terminé, une nouvelle tentative d’établissement d’une liaison entre Power Automate pour le bureau et l’agent Power Automate pour les bureaux virtuels est effectuée. |
| Automatisation | Temps d’exécution des actions d’automatisation de l’interface utilisateur effectuées sur la machine distante via l’agent Power Automate pour les bureaux virtuels. |
Problèmes connus et limitations
Problème : l’automatisation des bureaux virtuels n’est disponible que dans Windows RDP, RemoteApp, Citrix Desktop et Citrix Virtual Apps. Les autres plateformes de bureau virtuel ne sont pas prises en charge.
Solution de contournement : aucune
Problème : l’agent Power Automate pour les bureaux virtuels n’est pas compatible avec Windows 10 Home et Windows 11 Home.
Solution de contournement : aucune. La connexion au bureau à distance n’est pas prise en charge dans ces éditions de Windows.
Problème : vous obtenez le message « Erreur de communication avec Power Automate pour le bureau » lorsque l’agent Power Automate pour les bureaux virtuels est lancé dans Citrix Desktop même si vous avez installé correctement Power Automate pour le bureau et l’agent Power Automate pour les bureaux virtuels et vous avez rempli toutes les conditions préalables.
Solution de contournement :
Vérifiez le paramètre Stratégie de liste d’autorisation du canal virtuel dans votre configuration Citrix.- Si la version de Citrix VDA est antérieure à la version 2407 :
- La stratégie de liste d’autorisation du canal virtuel sur Citrix est activée par défaut ou définie sur la valeur par défaut. Cependant, si cette stratégie n’est pas désactivée, l’agent Power Automate ne peut pas communiquer avec Power Automate pour le bureau. Contactez vos administrateurs Citrix pour désactiver cette stratégie, car la maintenir définie sur la valeur par défaut n’est pas suffisant.
- Si la version de Citrix VDA est 2407 ou une version ultérieure :
- Configurez une autre stratégie. L’ancien paramètre Liste d’autorisation du canal virtuel peut rester défini sur la valeur par défaut. Configurez la nouvelle stratégie Liste d’autorisation du canal virtuel pour DVC et ajoutez les valeurs suivantes :
C:\Program Files (x86)\Power Automate agent for virtual desktops\PAD.RDP.ControlAgent.exe,Microsoft.Flow.RPA.Desktop.UIAutomation.RDP.DVC.Plugin,PAD\CONTROLC:\Users\*\AppData\Local\Microsoft\Power Automate Desktop\RDP Automation Agents\*\PAD.RDP.AutomationAgent.exe,Microsoft.Flow.RPA.Desktop.UIAutomation.RDP.DVC.Plugin,PAD\UIA
- Redémarrez les machines Citrix après avoir appliqué la stratégie.
- Configurez une autre stratégie. L’ancien paramètre Liste d’autorisation du canal virtuel peut rester défini sur la valeur par défaut. Configurez la nouvelle stratégie Liste d’autorisation du canal virtuel pour DVC et ajoutez les valeurs suivantes :
- Si la version de Citrix VDA est antérieure à la version 2407 :
Problème : l’automatisation du bureau virtuel n’est pas prise en charge dans Power Automate installé via Microsoft Store.
Solution de contournement : téléchargez et installez Microsoft Visual C++ Redistributable, qui installe les bibliothèques d’exécution Microsoft C et C++ (MSVC).
Problème : lorsqu’un flux est en cours d’exécution, un élément est introuvable si la fenêtre du bureau virtuel est réduite.
Solution de contournement : utilisez une action Mettre le focus sur la fenêtre dans la fenêtre du bureau virtuel avant de déployer les actions d’automatisation de l’interface utilisateur pour interagir avec le bureau virtuel.
Problème : lorsque vous utilisez l’enregistreur et que la fenêtre du bureau virtuel est agrandie, les actions Renseigner le champ de texte dans la fenêtre et Envoyer les clés peuvent ne pas fonctionner comme prévu.
Solution de contournement : assurez-vous que la fenêtre du bureau virtuel n’est pas agrandie pendant l’enregistrement.
Problème : l’automatisation de l’interface utilisateur des applets Java s’exécutant sur les bureaux virtuels n’est pas prise en charge.
Solution de contournement : aucune
Problème : l’automatisation de l’interface utilisateur Citrix ne fonctionne pas si vous utilisez Citrix Desktop et Citrix App dans la même session.
Solution de contournement : aucune
Problème : la définition d’une fenêtre sur les bureaux virtuels en utilisant les options Instance/descripteur de fenêtre ou Titre/classe de la fenêtre n’est pas prise en charge.
Solution de contournement : aucune