Compartilhar via


Visão geral de Microsoft.PowerShell.Crescendo

O PowerShell, como outros shells, é capaz de invocar ferramentas de linha de comando. No entanto, isso melhoraria a experiência se a ferramenta de linha de comando pudesse participar do pipeline do PowerShell e aproveitar os comportamentos de parâmetro que fazem parte do PowerShell.

O Crescendo fornece uma estrutura para criar rapidamente cmdlets do PowerShell que amplificam as ferramentas de linha de comando, independentemente da plataforma. O objetivo de um módulo baseado em Crescendo é criar cmdlets do PowerShell que usam uma ferramenta de linha de comando e, ao contrário dessa ferramenta, retornar objetos do PowerShell em vez de texto sem formatação.

Como o Crescendo funciona

A estrutura Crescendo tem dois componentes main:

  • Um arquivo de configuração JSON que descreve os cmdlets desejados
  • Funções do manipulador de saída que analisam a saída da ferramenta de linha de comando e retornam objetos

O módulo Crescendo fornece cmdlets para ajudá-lo a criar as configurações JSON e criar um módulo que contém os cmdlets que você definiu. Você deve escrever suas próprias funções de manipulador de saída que retornam objetos do PowerShell.

Terminologia específica de crescendo

A documentação do Crescendo inclui uma nova terminologia.

  • ferramenta de linha de comando – um arquivo executável nativo instalado em seu sistema
    • Por exemplo: ipconfig.exe
  • command – o que você digita na linha de comando para invocar o executável, que pode incluir parâmetros específicos
    • Por exemplo: ipconfig.exe /all
  • comando amplificado – o cmdlet criado com Crescendo para encapsular um comando em uma função do PowerShell
    • Por exemplo: Get-IpConfig -All

O esquema de arquivo de configuração Crescendo

Ao criar um arquivo de configuração Crescendo, você está escrevendo JSON. Para conveniência, validação e uma experiência de desenvolvedor aprimorada, um arquivo de esquema está disponível.

Você pode examinar o esquema para ver as configurações necessárias e opcionais, suas descrições e os tipos de valor que eles aceitam. Ao criar seu arquivo de configuração no Visual Studio Code, você obtém vários recursos úteis, incluindo IntelliSense, validação enquanto edita e muito mais.