Présentation de Microsoft.PowerShell.Crescendo

PowerShell, comme les autres shells, est capable d’appeler des outils de ligne de commande. Toutefois, l’expérience serait améliorée si l’outil de ligne de commande pouvait participer au pipeline PowerShell et tirer parti des comportements de paramètre qui font partie de PowerShell.

Crescendo fournit une infrastructure permettant de créer rapidement des applets de commande PowerShell qui amplifient les outils de ligne de commande, quelle que soit la plate-forme. L’objectif d’un module basé sur Crescendo est de créer des applets de commande PowerShell qui utilisent un outil de ligne de commande et, contrairement à cet outil, renvoient des objets PowerShell au lieu de texte brut.

Comment fonctionne Crescendo

Le cadre Crescendo comporte deux composantes principales :

• Un fichier de configuration JSON qui décrit les applets de commande souhaitées
• Fonctions de gestionnaire de sortie qui analysent la sortie de l’outil de ligne de commande et renvoient des objets

Le module Crescendo fournit des applets de commande pour vous aider à créer les configurations JSON et à construire un module contenant les applets de commande que vous avez définies. Vous devez écrire vos propres fonctions de gestionnaire de sortie qui renvoient des objets PowerShell.

Terminologie spécifique au crescendo

La documentation de Crescendo comprend une nouvelle terminologie.

• outil en ligne de commande - un fichier exécutable natif installé sur votre système
  • Par exemple : ipconfig.exe
• commande - ce que vous tapez sur la ligne de commande pour appeler l’exécutable, qui peut inclure des paramètres spécifiques
  • Par exemple : ipconfig.exe /all
• amplified : applet de commande que vous avez créée avec Crescendo pour encapsuler une commande dans une fonction PowerShell
  • Par exemple : Get-IpConfig -All

Le schéma du fichier de configuration Crescendo

Lorsque vous créez un fichier de configuration Crescendo, vous écrivez JSON. Pour plus de commodité, de validation et d’amélioration de l’expérience du développeur, un fichier de schéma est disponible.

Vous pouvez consulter le schéma pour voir les paramètres de configuration obligatoires et facultatifs, leurs descriptions et les types de valeur qu’ils acceptent. Lorsque vous créez votre fichier de configuration dans Visual Studio Code, vous bénéficiez de nombreuses fonctionnalités utiles, notamment IntelliSense, la validation lors de la modification, etc.