Módulo PSScriptAnalyzer

PSScriptAnalyzer é um verificador de código estático para módulos e scripts do PowerShell. PSScriptAnalyzer verifica a qualidade do código do PowerShell executando um conjunto de regras. As regras são baseadas nas práticas recomendadas do PowerShell identificadas pela Equipe do PowerShell e pela comunidade. Ele gera DiagnosticResults (erros e avisos) para informar os usuários sobre possíveis defeitos de código e sugere possíveis soluções para melhorias.

O PSScriptAnalyzer é fornecido com uma coleção de regras internas que marcar vários aspectos do código do PowerShell, como:

  • A presença de variáveis não inicializadas
  • Uso do tipo PSCredential
  • Uso de Invoke-Expression
  • E muito mais

Você pode escolher as regras a serem incluídas ou excluídas para seus módulos e scripts. PSScriptAnalyzer também pode corrigir a formatação do código. Isso ajuda você a produzir código que está em conformidade com um estilo padrão, é mais fácil de ler e é mais mantenedível.

Instalando o PSScriptAnalyzer

Versões e plataformas do PowerShell com suporte

  • Windows PowerShell 3.0 ou superior
  • PowerShell 7.0.11 ou superior no Windows/Linux/macOS

Instale usando o PowerShellGet 2.x:

Install-Module -Name PSScriptAnalyzer -Force

Instale usando PSResourceGet 1.x:

Install-PSResource -Name PSScriptAnalyzer -Reinstall

Os parâmetros Force ou Reinstall só são necessários quando você tem uma versão mais antiga do PSScriptAnalyzer instalada. Esses parâmetros também funcionam mesmo quando você não tem uma versão anterior instalada.