Bien que chaque script Devolutions PowerShell ait des dépendances spécifiques liées aux tâches qu'il est censé accomplir, tous doivent répondre à certaines exigences minimales pour pouvoir être exécutés. Heureusement, ces prérequis ne doivent être configurés qu'une seule fois par machine.
Pour que le module Devolutions.PowerShell fonctionne avec la solution souhaitée, les deux doivent être installés sur la même machine.
Installer PowerShell v7+
Il existe deux types de PowerShell : Windows PowerShell et simplement PowerShell. Le premier est installé par défaut sur chaque version de Windows, mais le second ne l'est pas et nécessite donc une installation séparée. Étant donné que les produits Devolutions ne prennent en charge que PowerShell proprement dit, il devra être installé manuellement.
Pour ce faire, se rendre sur la page des versions du dépôt GitHub de PowerShell de Microsoft, faire défiler jusqu'à la section Assets et télécharger le package Windows .msi.
Politique d'exécution de l'utilisateur
L'utilisateur sous lequel PowerShell exécute les scripts doit avoir certaines permissions. Pour les obtenir, ouvrir PowerShell et exécuter la commande Get-ExecutionPolicy
pour connaître la politique d'exécution actuelle. Si la politique est définie sur RemoteSigned, la changer en Unrestricted en utilisant la commande Set-ExecutionPolicy
.
Installer le module PowerShell de Devolutions
Pour installer le module PowerShell de Devolutions, exécuter le script Install-Module Devolutions.PowerShell
.
Une invite devrait alors apparaître demandant de faire confiance à un dépôt PSGallery. Entrer Yes
pour accepter.
Si l'installation s'est bien déroulée, exécuter le script Get-Command -Module Devolutions.PowerShell
devrait renvoyer toutes les commandes Devolutions.PowerShell.
Tester la connexion à une source de données
Avec le module installé, l'étape suivante consiste à vérifier la connexion à une source de données Devolutions. Pour ce faire, exécuter le script Get-RDMCurrentDatasource
.
Si Remote Desktop Manager est installé sur la machine, exécuter Get-RDMEntry
devrait renvoyer une liste de toutes les entrées disponibles, ce qui signifie que la connexion à la source de données est correctement établie, les requêtes peuvent être effectuées et les scripts peuvent alors être exécutés sans problème.