Padrões do PowerShell para Windows

Padrões e armadilhas críticas para o PowerShell do Windows.

1. Regras de Sintaxe de Operadores

CRÍTICO: Parênteses Obrigatórios

Regra: Cada chamada de cmdlet DEVE estar entre parênteses ao usar operadores lógicos.

2. Restrição de Unicode/Emoji

CRÍTICO: Sem Unicode em Scripts

Regra: Use apenas caracteres ASCII em scripts do PowerShell.

3. Padrões de Verificação de Nulo

Sempre Verifique Antes de Acessar

4. Interpolação de Strings

Expressões Complexas

Padrão:

$value = $obj.prop.sub
Write-Output "Value: $value"

5. Tratamento de Erros

ErrorActionPreference

Padrão Try/Catch

• Não retorne dentro do bloco try
• Use finally para limpeza
• Retorne após try/catch

6. Caminhos de Arquivo

Regras de Caminho do Windows

Regra: Use Join-Path para segurança multiplataforma.

7. Operações de Array

Padrões Corretos

8. Operações JSON

CRÍTICO: Parâmetro Depth

Regra: Sempre especifique -Depth para objetos aninhados.

Operações de Arquivo

9. Erros Comuns

10. Modelo de Script

# Strict mode
Set-StrictMode -Version Latest
$ErrorActionPreference = "Continue"

# Paths
$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path

# Main
try {
    # Logic here
    Write-Output "[OK] Done"
    exit 0
}
catch {
    Write-Warning "Error: $_"
    exit 1
}

Lembre-se: O PowerShell tem regras de sintaxe exclusivas. Parênteses, uso exclusivo de ASCII e verificações de nulo são inegociáveis.

Quando Usar

Esta habilidade é aplicável para executar o fluxo de trabalho ou as ações descritas na visão geral.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação, testes ou revisão de especialistas específicos do ambiente.
• Pare e peça esclarecimentos se as entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.