Carregando
0xD0Lição 14 de 25

Automação segura

Adicione suporte a -WhatIf em suas funções, use os fluxos de saída, detecte erros com modo estrito e proteja segredos.

28 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Faça com que suas funções suportem -WhatIf e -Confirm com SupportsShouldProcess
  • Use the verbose, warning and information streams, and redirect them
  • Detectar erros cedo com Set-StrictMode, PSScriptAnalyzer e Pester e lidar com credenciais com segurança

A automação multiplica os erros com a mesma facilidade com que multiplica o trabalho. O PowerShell oferece bons mecanismos de proteção: use-os.

-WhatIf em suas próprias funções. Adicione SupportsShouldProcess a [CmdletBinding()] e envolva cada alteração em if ($PSCmdlet.ShouldProcess(target, action)) { ... }. Sua função passa a aceitar -WhatIf e -Confirm e os repassa aos cmdlets que chama.

should-process.ps1
1function Remove-OldFeedLog {
2  [CmdletBinding(SupportsShouldProcess)]
3  param([Parameter(Mandatory)][string[]]$Name)
4  foreach ($log in $Name) {
5    if ($PSCmdlet.ShouldProcess($log, 'Delete feeding log')) {
6      "deleted $log"
7    }
8  }
9}
10Remove-OldFeedLog -Name 'monday.csv', 'tuesday.csv' -WhatIf
11Remove-OldFeedLog -Name 'monday.csv'
Saída
What if: Performing the operation "Delete feeding log" on target "monday.csv".
What if: Performing the operation "Delete feeding log" on target "tuesday.csv".
deleted monday.csv

Seis fluxos de saída

Os resultados não são a única coisa que um comando pode produzir. O PowerShell numerou streams, cada um com seu próprio cmdlet:

#TransmitirEscreva comMostrado por padrão?
1Sucesso (resultado)Write-Output / valores simplessim
2ErroWrite-Errorsim
3AvisoWrite-Warningsim
4DetalhadoWrite-Verboseapenas com -Verbose
5DepurarWrite-Debugapenas com -Debug
6InformaçãoWrite-Information (e Write-Host)Host de gravação: sim

Polvilhe Write-Verbose através de funções avançadas: silencioso normalmente, uma narrativa detalhada com -Verbose. Redirecione fluxos como este: 3> warnings.txt, 2>&1 (erros na saída), *> all.txt (tudo).

streams.ps1
1function Invoke-Feeding {
2  [CmdletBinding()]
3  param([string]$Dragon)
4  Write-Verbose "Fetching food for $Dragon"
5  "$Dragon fed"
6}
7Invoke-Feeding -Dragon Ember
8Invoke-Feeding -Dragon Glim -Verbose 4>&1 | ForEach-Object { "[$_]" }
Saída
Ember fed
[Fetching food for Glim]
[Glim fed]

Detectando erros cedo

  • Set-StrictMode -Version Latest transforma código desleixado em erros: usar uma variável que nunca foi atribuída, ler uma propriedade que não existe, chamar funções com sintaxe de método. Coloque-o no topo dos scripts.
  • PSScriptAnalyzer (Install-Module PSScriptAnalyzer, depois Invoke-ScriptAnalyzer .\script.ps1) é o linter: verbos não aprovados, aliases em scripts, variáveis ​​não utilizadas, senhas de texto simples e muito mais. O VS Code executa enquanto você digita.
  • Pester é a estrutura de teste. Os testes são quase como o inglês:
1Describe 'Get-FeedingAmount' {
2  It 'doubles the amount for hungry dragons' {
3    Get-FeedingAmount -Wingspan 10 -Hungry | Should -Be 60
4  }
5}
strict-mode.ps1
1$dragon = 'Ember'
2"Without strict mode: [$dragn]"
3Set-StrictMode -Version Latest
4try {
5  "With strict mode: [$dragn]"
6} catch {
7  'Strict mode caught the typo: $dragn was never set'
8}
Saída
Without strict mode: []
Strict mode caught the typo: $dragn was never set

Principais conclusões

  • [CmdletBinding(SupportsShouldProcess)] mais $PSCmdlet.ShouldProcess() fornece suas funções -WhatIf e -Confirm.

  • Saída, erro, aviso, detalhado, depuração e informações são fluxos separados; redirecione-os com n>, 2>&1 e *>.

  • Set-StrictMode -Version Latest, PSScriptAnalyzer e Pester detectam erros antes que eles mordam.

  • Mantenha os segredos fora dos scripts: Get-Credential e SecretManagement.

Quiz da aula

7 perguntas · aprovação com 5 acertos · até 50 XP

Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.

Pratique: escreva código em scripts PowerShell

Escreva um script no editor e execute-o de verdade com entradas de exemplo, que chegam ao script como $input. Os scripts rodam no PowerShell 6.2 pelo Try It Online (tio.run), um serviço público gratuito, então estes exercícios evitam sintaxe exclusiva do PowerShell 7; seu script e a entrada de teste são enviados para lá.

Exercício 1

Uma limpeza que suporta -WhatIf

+25 XP

Escreva Remove-FeedLog com [CmdletBinding(SupportsShouldProcess)] e um parâmetro -Name obrigatório (um nome de arquivo). Ele exclui esse arquivo da pasta atual e gera deleted <name>, mas somente quando $PSCmdlet.ShouldProcess($Name, 'Delete feeding log') diz isso.

O starter cria um arquivo de log para cada linha de entrada, ensaia excluí-las todas com -WhatIf, realmente exclui apenas as .old e lista o que resta.

  • Três registros
script.ps1
Carregando editor…

As aulas ensinam PowerShell 7; seu script roda no PowerShell 6.2 pelo Try It Online (tio.run), um serviço público gratuito, então use uma sintaxe que funcione lá. A entrada de teste chega ao script como $input. Seu script e a entrada de teste são enviados a esse serviço.

Exercício 2

Alimentação detalhada

+25 XP

Escreva uma função avançada Invoke-Feeding que pega -Dragon e -Kilograms e gera Ember fed 20 kg. Antes disso, ele escreve uma mensagem detalhada: checking Ember's diet. Se os quilogramas forem superiores a 50 escreve um aviso: Ember is getting a lot of food.

O starter chama uma vez normalmente e uma vez com -Verbose, mesclando os fluxos detalhados (4) e de aviso (3) na saída para que você possa vê-los.

  • Dois dragões
script.ps1
Carregando editor…

As aulas ensinam PowerShell 7; seu script roda no PowerShell 6.2 pelo Try It Online (tio.run), um serviço público gratuito, então use uma sintaxe que funcione lá. A entrada de teste chega ao script como $input. Seu script e a entrada de teste são enviados a esse serviço.

Dúvidas sobre esta lição

Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.

Carregando publicações…