Module PowerShell

Le module Devolutions.PowerShell est un moyen d'accéder, de créer, de mettre à jour et de supprimer des éléments dans Devolutions Cloud. Il vous aidera à automatiser certaines opérations et scripts. Une fois le module Devolutions.PowerShell installé, vous serez prêt à utiliser le module et à vous connecter à votre instance Devolutions Cloud.

Prérequis

• PowerShell 7.4 ou version ultérieure installé :

  • Windows
  • macOS
  • Linux
• Un utilisateur d'application

Connexion à votre instance Devolutions Cloud

Pour la liste complète des commandes disponibles, consultez Commandes PowerShell. D'autres options d'installation sont disponibles dans la PowerShell Gallery.

1. Une fois PowerShell 7.4 ou version ultérieure installé, ouvrez un terminal PowerShell et installez le module Devolutions.PowerShell avec la commande suivante : Install-Module -Name Devolutions.Powershell

   
2. Connectez-vous à Devolutions Cloud à l'aide de la commande ci-dessous. Si aucune erreur ne s'affiche, cela signifie que vous êtes connecté à votre instance Devolutions Cloud.

   Connect-HubAccount -Url https<area>://yourhub.devolutions.app/ -ApplicationSecret [YOUR_APPLICATION_SECRET] -ApplicationKey [YOUR_APPLICATION_KEY]

   

Exemple et utilisation de commandes

1. Avec la commande Get-HubVault, vous pouvez obtenir les coffres que votre utilisateur d'application peut afficher et modifier. Si vous avez défini les autorisations de votre utilisateur d'application sur plusieurs coffres, vous verrez un tableau de coffres.

   
2. Grâce à ces informations sur le coffre, vous pouvez obtenir toutes les entrées avec la commande Get-HubEntry et l'identifiant du coffre. Si vous avez plusieurs entrées, vous verrez un tableau d'entrées.

   
3. Pour afficher des informations spécifiques, vous pouvez affecter le retour de la commande Devolutions Cloud à une variable et récupérer ce dont vous avez besoin, comme l'identifiant de connexion dans cet exemple :

   
4. Pour modifier cette entrée, vous pouvez changer l'objet et le mettre à jour avec la commande Set-HubEntry.

   

À tout moment, vous pouvez valider dans la version web de Devolutions Cloud que les modifications ont bien été effectuées.