Partager via


Vue d’ensemble de Microsoft.PowerShell.Crescendo

PowerShell, comme d’autres interpréteurs de commandes, est capable d’appeler des outils en ligne de commande. Toutefois, cela améliorerait l’expérience si l’outil en ligne de commande pouvait participer au pipeline PowerShell et tirer parti des comportements des paramètres qui font partie de PowerShell.

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

Fonctionnement de Crescendo

L’infrastructure Crescendo comporte deux composants main :

  • 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 en ligne de commande et retournent des objets

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

Terminologie propre à 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
  • command : 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
  • commande amplifiée : applet de commande que vous avez créée avec Crescendo pour encapsuler une commande dans une fonction PowerShell
    • Par exemple : Get-IpConfig -All

Schéma du fichier de configuration Crescendo

Lorsque vous créez un fichier de configuration Crescendo, vous écrivez JSON. Pour des raisons de commodité, de validation et d’amélioration de l’expérience des développeurs, 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 valeurs 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 pendant la modification, etc.