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.
- 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.
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'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:
| # | Transmitir | Escreva com | Mostrado por padrão? |
|---|---|---|---|
| 1 | Sucesso (resultado) | Write-Output / valores simples | sim |
| 2 | Erro | Write-Error | sim |
| 3 | Aviso | Write-Warning | sim |
| 4 | Detalhado | Write-Verbose | apenas com -Verbose |
| 5 | Depurar | Write-Debug | apenas com -Debug |
| 6 | Informação | Write-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).
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 { "[$_]" }Ember fed [Fetching food for Glim] [Glim fed]
Detectando erros cedo
Set-StrictMode -Version Latesttransforma 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, depoisInvoke-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}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}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>&1e*>.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á.
Uma limpeza que suporta -WhatIf
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
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.
Alimentação detalhada
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
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…