Tratamento de erros
Diferencie erros terminantes e não terminantes, trate falhas com try/catch/finally e produza seus próprios erros.
- 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-Itemquando 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.
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}still running after a non-terminating error caught: ItemNotFoundException caught a division by zero finally always runs
Valor -ErrorAction | O que acontece |
|---|---|
Continue (padrão) | mostre o erro, continue |
SilentlyContinue | esconda-o (ainda está gravado em $Error), continue |
Ignore | esconda e não grave |
Stop | faça com que ele termine, para que catch possa lidar com isso |
Inquire | pergunte 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?).
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}ration: 15 kg skipped: No dragons to feed with 60 kg ration: 12 kg
Experimente
Até 15 XPRevise 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.
Clique em todos os trechos suspeitos. São 4.
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 Stopaos cmdlets dentro do try.Em captura,
$_é o registro do erro;$_.Exception.Messageé a sua mensagem. finalmente sempre funciona.throwquando você não consegue continuar,Write-Errorquando um item falha; verifique$LASTEXITCODEpara 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á.
Planejador de ração
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
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.
Verificação de gabinete
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
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…