Sobre Try Catch Finally
DESCRIÇÃO BREVE
Descreve como usar os Try
blocos , Catch
e Finally
para lidar com erros de encerramento.
DESCRIÇÃO LONGA
Use Try
os blocos , Catch
e Finally
para responder ou tratar erros de encerramento em scripts. A Trap
instrução também pode ser usada para lidar com erros de encerramento em scripts. Para obter mais informações, consulte about_Trap.
Um erro de encerramento impede a execução de uma instrução. Se o PowerShell não tratar um erro de encerramento de alguma forma, o PowerShell também interromperá a execução da função ou do script usando o pipeline atual. Em outras linguagens, como C#, erros de encerramento são chamados de exceções.
Use o Try
bloco para definir uma seção de um script no qual você deseja que o PowerShell monitore se há erros. Quando ocorre um erro dentro do Try
bloco, o erro é salvo pela primeira vez na $Error
variável automática. Em seguida, o PowerShell procura um Catch
bloco para lidar com o erro. Se a instrução não tiver um bloco correspondenteCatch
, o Try
PowerShell continuará a pesquisar um bloco ou Trap
instrução apropriado Catch
nos escopos pai. Depois que um Catch
bloco for concluído ou se nenhum bloco ou Trap
instrução apropriado Catch
for encontrado, o Finally
bloco será executado. Se o erro não puder ser tratado, o erro será gravado no fluxo de erros.
Um Catch
bloco pode incluir comandos para acompanhar o erro ou para recuperar o fluxo esperado do script. Um Catch
bloco pode especificar quais tipos de erro ele captura. Uma Try
instrução pode incluir vários Catch
blocos para diferentes tipos de erros.
Um Finally
bloco pode ser usado para liberar todos os recursos que não são mais necessários para o script.
Try
, Catch
e Finally
se assemelham às Try
palavras-chave , Catch
e Finally
usadas na linguagem de programação C#.
SYNTAX
Uma Try
instrução contém um Try
bloco, zero ou mais Catch
blocos e zero ou um Finally
bloco. Uma Try
instrução deve ter pelo menos um Catch
bloco ou um Finally
bloco.
O seguinte mostra a Try
sintaxe do bloco:
try {<statement list>}
O Try
palavra-chave é seguido por uma lista de instruções entre chaves. Se ocorrer um erro de encerramento enquanto as instruções na lista de instruções estiverem sendo executadas, o script passará o objeto de erro do Try
bloco para um bloco apropriado Catch
.
O seguinte mostra a Catch
sintaxe do bloco:
catch [[<error type>][',' <error type>]*] {<statement list>}
Os tipos de erro aparecem entre colchetes. Os colchetes mais externos indicam que o elemento é opcional.
O Catch
palavra-chave é seguido por uma lista opcional de especificações de tipo de erro e uma lista de instruções. Se ocorrer um erro de encerramento no bloco, o Try
PowerShell procurará um bloco apropriado Catch
. Se um for encontrado, as instruções no Catch
bloco serão executadas.
O Catch
bloco pode especificar um ou mais tipos de erro. Um tipo de erro é uma exceção do Microsoft .NET Framework ou uma exceção derivada de uma exceção .NET Framework. Um Catch
bloco manipula erros da classe de exceção .NET Framework especificada ou de qualquer classe derivada da classe especificada.
Se um Catch
bloco especificar um tipo de erro, esse Catch
bloco manipulará esse tipo de erro. Se um Catch
bloco não especificar um tipo de erro, esse Catch
bloco manipulará qualquer erro encontrado no Try
bloco. Uma Try
instrução pode incluir vários Catch
blocos para os diferentes tipos de erro especificados.
O seguinte mostra a Finally
sintaxe do bloco:
finally {<statement list>}
O Finally
palavra-chave é seguido por uma lista de instruções que é executada sempre que o script é executado, mesmo que a Try
instrução tenha sido executada sem erro ou se um erro foi capturado em uma Catch
instrução .
Observe que pressionar CTRL+C interrompe o pipeline. Os objetos enviados para o pipeline não serão exibidos como saída. Portanto, se você incluir uma instrução a ser exibida, como "Finally block has run", ela não será exibida depois que você pressionar CTRL+C, mesmo que o Finally
bloco tenha sido executado.
CAPTURA DE ERROS
O script de exemplo a seguir mostra um Try
bloco com um Catch
bloco:
try { NonsenseString }
catch { "An error occurred." }
O Catch
palavra-chave deve seguir imediatamente o Try
bloco ou outro Catch
bloco.
O PowerShell não reconhece "NonsenseString" como um cmdlet ou outro item. A execução desse script retorna o seguinte resultado:
An error occurred.
Quando o script encontra "NonsenseString", ele causa um erro de encerramento. O Catch
bloco manipula o erro executando a lista de instruções dentro do bloco.
USANDO VÁRIAS INSTRUÇÕES CATCH
Uma Try
instrução pode ter qualquer número de Catch
blocos. Por exemplo, o script a seguir tem um Try
bloco que baixa MyDoc.doc
e contém dois Catch
blocos:
try {
$wc = new-object System.Net.WebClient
$wc.DownloadFile("https://www.contoso.com/MyDoc.doc","c:\temp\MyDoc.doc")
}
catch [System.Net.WebException],[System.IO.IOException] {
"Unable to download MyDoc.doc from https://www.contoso.com."
}
catch {
"An error occurred that could not be resolved."
}
O primeiro Catch
bloco lida com erros dos tipos System.Net.WebException e System.IO.IOException . O segundo Catch
bloco não especifica um tipo de erro. O segundo Catch
bloco manipula quaisquer outros erros de encerramento que ocorrem.
O PowerShell corresponde aos tipos de erro por herança. Um Catch
bloco manipula erros da classe de exceção .NET Framework especificada ou de qualquer classe derivada da classe especificada. O exemplo a seguir contém um Catch
bloco que captura um erro "Command Not Found":
catch [System.Management.Automation.CommandNotFoundException]
{"Inherited Exception" }
O tipo de erro especificado, CommandNotFoundException, herda do tipo System.SystemException . O exemplo a seguir também captura um erro Command Not Found:
catch [System.SystemException] {"Base Exception" }
Esse Catch
bloco manipula o erro "Command Not Found" e outros erros que herdam do tipo SystemException .
Se você especificar uma classe de erro e uma de suas classes derivadas, coloque o Catch
bloco para a classe derivada antes do Catch
bloco para a classe geral.
Usando armadilhas em um Try Catch
Quando ocorre um erro de encerramento em um Try
bloco com um Trap
definido dentro do bloco, mesmo que haja um bloco correspondenteCatch
, a instrução assume o Try
Trap
controle.
Se existir um Trap
em um bloco mais alto do que o Try
e não houver nenhum bloco correspondente Catch
dentro do escopo atual, o assumirá o Trap
controle, mesmo que qualquer escopo pai tenha um bloco correspondente Catch
.
ACESSANDO INFORMAÇÕES DE EXCEÇÃO
Em um Catch
bloco, o erro atual pode ser acessado usando $_
, que também é conhecido como $PSItem
. O objeto é do tipo ErrorRecord.
try { NonsenseString }
catch {
Write-Host "An error occurred:"
Write-Host $_
}
A execução desse script retorna o seguinte resultado:
An Error occurred:
The term 'NonsenseString' is not recognized as the name of a cmdlet, function,
script file, or operable program. Check the spelling of the name, or if a path
was included, verify that the path is correct and try again.
Há propriedades adicionais que podem ser acessadas, como ScriptStackTrace, Exception e ErrorDetails. Por exemplo, se alterarmos o script para o seguinte:
try { NonsenseString }
catch {
Write-Host "An error occurred:"
Write-Host $_.ScriptStackTrace
}
O resultado será semelhante a:
An Error occurred:
at <ScriptBlock>, <No file>: line 2
LIBERANDO RECURSOS USANDO FINALLY
Para liberar recursos usados por um script, adicione um Finally
bloco após os Try
blocos e Catch
. As Finally
instruções de bloco são executadas independentemente de o Try
bloco encontrar um erro de encerramento. O PowerShell executa o Finally
bloco antes que o script seja encerrado ou antes que o bloco atual saia do escopo.
Um Finally
bloco é executado mesmo se você usar CTRL+C para interromper o script. Um Finally
bloco também será executado se um palavra-chave sair interromper o script de dentro de um Catch
bloco.