Getting started

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.

Windows .msi package from the Assets list
Windows .msi package from the Assets list

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.

Setting the ExecutionPolicy to Unrestricted
Setting the ExecutionPolicy to Unrestricted

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.

Installing Devolutions.PowerShell
Installing Devolutions.PowerShell

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.

List of all the Devolutions.PowerShell commands
List of all the Devolutions.PowerShell commands

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.

Successful connection to an SQLite data source
Successful connection to an SQLite data source

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.

Devolutions Forum logo Donnez-nous vos commentaires