Carregando
0xC0Lição 13 de 25

Tratamento de erros

Diferencie erros terminantes e não terminantes, trate falhas com try/catch/finally e produza seus próprios erros.

28 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Explique a diferença entre erros de não terminação e de terminação
  • Use -ErrorAction e $ErrorActionPreference para controlar o que acontece
  • Lidar com erros com try/catch/finalmente, capturas tipadas e lançamento

O PowerShell tem dois tipos de erros:

  • Erros não terminantes são relatados e então o comando continua. Peça cinco arquivos a Get-Item quando dois estiverem faltando e você receberá três arquivos mais duas mensagens de erro vermelhas.
  • Os erros de terminação interrompem a instrução atual - e o script, a menos que algo os detecte. throw, exceções .NET (como divisão por zero) e falhas de validação de parâmetros estão encerrando.

Isso é importante porque try/catch captura apenas erros terminantes. Para detectar o erro de não encerramento de um cmdlet, transforme-o em um erro de encerramento com -ErrorAction Stop - ou defina $ErrorActionPreference = 'Stop' para todo o script.

two-kinds.ps1
1Set-Location ([IO.Path]::GetTempPath())
2try {
3  Get-Item 'no-such-dragon.txt' -ErrorAction SilentlyContinue
4  'still running after a non-terminating error'
5  Get-Item 'no-such-dragon.txt' -ErrorAction Stop
6  'never printed'
7} catch {
8  "caught: $($_.Exception.GetType().Name)"
9}
10try {
11  $meals = 0
12  12 / $meals
13} catch [System.DivideByZeroException] {
14  'caught a division by zero'
15} finally {
16  'finally always runs'
17}
Saída
still running after a non-terminating error
caught: ItemNotFoundException
caught a division by zero
finally always runs
Valor -ErrorActionO que acontece
Continue (padrão)mostre o erro, continue
SilentlyContinueesconda-o (ainda está gravado em $Error), continue
Ignoreesconda e não grave
Stopfaça com que ele termine, para que catch possa lidar com isso
Inquirepergunte ao usuário

Dentro de catch, $_ é o registro de erro: $_.Exception.Message é a mensagem, $_.Exception a exceção .NET, $_.CategoryInfo e $_.InvocationInfo dizem o que falhou e onde. Coloque os blocos catch [Type] mais específicos primeiro e um catch simples por último. Um bloco finally é executado independentemente de algo ter falhado ou não - perfeito para fechar arquivos e conexões.

Levantando erros

  • throw 'message' gera um erro de finalização. Use-o quando sua função não puder continuar.
  • Write-Error 'message' grava um erro que não termina - exatamente quando um item entre muitos falhou, mas o resto pode continuar.
  • Para programas que não são PowerShell (git, ping, python...), verifique $LASTEXITCODE (seu código de saída) ou $? (o último comando foi bem-sucedido?).
throw.ps1
1function Get-Ration {
2  param([int]$Kilograms, [int]$Dragons)
3  if ($Dragons -le 0) { throw "No dragons to feed with $Kilograms kg" }
4  $Kilograms / $Dragons
5}
6foreach ($count in 4, 0, 5) {
7  try {
8    "ration: $(Get-Ration -Kilograms 60 -Dragons $count) kg"
9  } catch {
10    "skipped: $($_.Exception.Message)"
11  }
12}
Saída
ration: 15 kg
skipped: No dragons to feed with 60 kg
ration: 12 kg

Experimente

Até 15 XP

Revise o roteiro da alimentação noturna

Um tratador escreveu este roteiro para alimentar o turno da noite. Clique em cada linha que lida mal com erros e verifique.

night-feed.ps1 (rodada 1 de 1)Sinais encontrados 0/0

Clique em todos os trechos suspeitos. São 4.

$ErrorActionPreference = 'SilentlyContinue' try { $log = Get-Content feeding.csv } catch { } $meals = $log | ConvertFrom-Csv Remove-Item feeding.csv -Force "Night feed done"

Principais conclusões

  • Relatório de erros não encerrados e continuação; erros de terminação interrompem a instrução.

  • try/catch captura apenas erros terminantes - adicione -ErrorAction Stop aos cmdlets dentro do try.

  • Em captura, $_ é o registro do erro; $_.Exception.Message é a sua mensagem. finalmente sempre funciona.

  • throw quando você não consegue continuar, Write-Error quando um item falha; verifique $LASTEXITCODE para programas nativos.

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

Planejador de ração

+25 XP

Cada linha de entrada é kilograms dragons. Imprima a ração por dragão, arredondada para uma casa decimal com [math]::Round(x, 1), como 60 kg / 4 dragons = 15 kg each. Se não houver dragões, a divisão lança - pegue e imprima 60 kg / 0 dragons = nobody to feed. Use try/catch, não um if.

  • Três turnos
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

Verificação de gabinete

+25 XP

O código inicial cria notas para alguns gabinetes. Cada linha de entrada é o nome de um gabinete. Para cada nome, leia <name>.txt com Get-Content e imprima volcano: <conteúdo do arquivo>; se o arquivo não existir, detecte o erro e imprima volcano: MISSING. Por fim, imprima checked N, missing M. Nenhum erro vermelho pode aparecer.

  • Três gabinetes
  • Todos desaparecidos
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…