Share via


Descrição geral de Microsoft.PowerShell.Crescendo

O PowerShell, tal como outras shells, é capaz de invocar ferramentas de linha de comandos. No entanto, melhoraria a experiência se a ferramenta de linha de comandos pudesse participar no pipeline do PowerShell e tirar partido dos comportamentos dos parâmetros que fazem parte do PowerShell.

O Crescendo fornece uma arquitetura para criar rapidamente cmdlets do PowerShell que amplam as ferramentas de linha de comandos, independentemente da plataforma. O objetivo de um módulo baseado em Crescendo é criar cmdlets do PowerShell que utilizem uma ferramenta de linha de comandos e, ao contrário dessa ferramenta, devolver objetos do PowerShell em vez de texto simples.

Como funciona o Crescendo

A arquitetura Crescendo tem dois componentes principais:

  • Um ficheiro de configuração JSON que descreve os cmdlets que pretende
  • Funções do processador de saída que analisam a saída da ferramenta de linha de comandos e devolvem objetos

O módulo Crescendo fornece cmdlets para o ajudar a criar as configurações JSON e a criar um módulo que contém os cmdlets que definiu. Tem de escrever as suas próprias funções de processador de saída que devolvem objetos do PowerShell.

Terminologia específica do Crescendo

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

  • ferramenta de linha de comandos – um ficheiro executável nativo instalado no seu sistema
    • Por exemplo: ipconfig.exe
  • comando – o que escreve na linha de comandos para invocar o executável, que pode incluir parâmetros específicos
    • Por exemplo: ipconfig.exe /all
  • comando amplificado - o cmdlet que criou com Crescendo para moldar um comando numa função do PowerShell
    • Por exemplo: Get-IpConfig -All

O esquema de ficheiro de configuração Crescendo

Quando cria um ficheiro de configuração Crescendo, está a escrever JSON. Para conveniência, validação e uma experiência de programador melhorada, está disponível um ficheiro de esquema.

Pode rever o esquema para ver as definições de configuração obrigatórias e opcionais, as descrições e os tipos de valor que aceitam. Quando cria o ficheiro de configuração no Visual Studio Code, obtém inúmeras funcionalidades úteis, incluindo o IntelliSense, a validação enquanto edita e muito mais.