关于尝试捕获最后

简短描述

描述如何使用 try、catch 和 finally 块来处理终止错误。

详细描述

使用 try、catch 和 finally 块来响应或处理脚本中的终止错误。 Trap 语句还可用于处理脚本中的终止错误。有关更多信息，请参阅 about_Trap。

终止错误会停止语句的运行。如果 PowerShell 不以某种方式处理终止错误，PowerShell 也会停止使用当前管道运行函数或脚本。在其他语言（例如 C#）中，终止错误称为异常。

使用 try 块定义您希望 PowerShell 监视错误的脚本部分。当 try 块内发生错误时，错误首先会保存到 $Error 自动变量中。然后，PowerShell 搜索 catch 块来处理错误。如果 try 语句没有匹配的 catch 块，PowerShell 会继续搜索适当的 catch 块或 Trap > 父作用域中的语句。在 catch 块完成后，或者如果没有找到合适的 catch 块或 Trap 语句，则将执行 finally 块跑步。如果无法处理错误，则将错误写入错误流。

catch 块可以包含用于跟踪错误或恢复脚本的预期流程的命令。 catch 块可以指定它捕获的错误类型。 try 语句可以包含针对不同类型错误的多个 catch 块。

finally 块可用于释放脚本不再需要的任何资源。

try、catch 和 finally 类似于 try、catch 和 C# 编程语言中使用的 >finally 关键字。

句法

try 语句包含一个 try 块、零个或多个 catch 块以及零个或一个 finally 块。一条 try 语句必须至少有一个 catch 块或一个 finally 块。

下面显示了 try 块语法：

try {<statement list>}

try 关键字后面是大括号中的语句列表。如果在运行语句列表中的语句时发生终止错误，脚本会将错误对象从 try 块传递到相应的 catch 块。

下面显示了 catch 块语法：

catch [[<error type>][',' <error type>]*] {<statement list>}

错误类型出现在括号中。最外面的括号表示该元素是可选的。

catch 关键字后跟一个可选的错误类型规范列表和一个语句列表。如果 try 块中发生终止错误，PowerShell 会搜索适当的 catch 块。如果找到，则执行 catch 块中的语句。

catch 块可以指定一种或多种错误类型。错误类型是 Microsoft .NET Framework 异常或派生自 .NET Framework 异常的异常。 catch 块处理指定 .NET Framework 异常类或从指定类派生的任何类的错误。

如果 catch 块指定错误类型，则该 catch 块将处理该类型的错误。如果 catch 块未指定错误类型，则该 catch 块将处理 try 块中遇到的任何错误。 try 语句可以包含针对不同指定错误类型的多个 catch 块。

下面显示了finally块语法：

finally {<statement list>}

finally 关键字后跟每次运行脚本时都会运行的语句列表，即使 try 语句运行时没有错误或在 中捕获错误也是如此。 catch 语句。

请注意，按 CTRL+C 会停止管道。发送到管道的对象不会显示为输出。因此，如果包含要显示的语句，例如“Finally block has run”，则在按 CTRL+C 后不会显示该语句，即使 finally 块运行。

捕获错误

以下示例脚本显示了带有 catch 块的 try 块：

try { NonsenseString }
catch { "An error occurred." }

catch 关键字必须紧跟在 try 块或另一个 catch 块之后。

PowerShell 无法将“NonsenseString”识别为 cmdlet 或其他项目。运行此脚本将返回以下结果：

An error occurred.

当脚本遇到“NonsenseString”时，会导致终止错误。 catch 块通过运行块内的语句列表来处理错误。

使用多个 catch 语句

try 语句可以有任意数量的 catch 块。例如，以下脚本有一个用于下载 MyDoc.doc 的 try 块，并且包含两个 catch 块：

try {
   $wc = new-object System.Net.WebClient
   $wc.DownloadFile("http://www.contoso.com/MyDoc.doc","c:\temp\MyDoc.doc")
}
catch [System.Net.WebException],[System.IO.IOException] {
    "Unable to download MyDoc.doc from http://www.contoso.com."
}
catch {
    "An error occurred that could not be resolved."
}

第一个 catch 块处理 System.Net.WebException 和 System.IO.IOException 类型的错误。第二个catch块没有指定错误类型。第二个 catch 块处理发生的任何其他终止错误。

PowerShell 通过继承来匹配错误类型。 catch 块处理指定 .NET Framework 异常类或从指定类派生的任何类的错误。以下示例包含一个 catch 块，用于捕获“Command Not Found”错误：

catch [System.Management.Automation.CommandNotFoundException]
{"Inherited Exception" }

指定的错误类型 CommandNotFoundException 继承自 System.SystemException 类型。以下示例还捕获“未找到命令”错误：

catch [System.SystemException] {"Base Exception" }

此catch 块处理“Command Not Found”错误和从SystemException 类型继承的其他错误。

如果指定错误类及其派生类之一，请将派生类的 catch 块放置在通用类的 catch 块之前。

笔记

PowerShell 将所有异常包装在 RuntimeException 类型中。因此，指定错误类型 System.Management.Automation.RuntimeException 的行为与不合格的 catch 块的行为相同。

在 Try Catch 中使用陷阱

当 try 块中发生终止错误且在 try 块内定义了 Trap 时，即使存在匹配的 catch 块中，Trap 语句接管控制。

如果 Trap 存在于比 try 更高的块中，并且当前范围内没有匹配的 catch 块，则 Trap 将接管控制权，即使任何父作用域具有匹配的 catch 块。

访问异常信息

在 catch 块中，可以使用 $_（也称为 $PSItem）访问当前错误。该对象的类型为ErrorRecord。

try { NonsenseString }
catch {
  Write-Host "An error occurred:"
  Write-Host $_
}

运行此脚本将返回以下结果：

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.

还有其他可以访问的属性，例如 ScriptStackTrace、Exception 和 ErrorDetails。 例如，如果我们将脚本更改为以下内容：

try { NonsenseString }
catch {
  Write-Host "An error occurred:"
  Write-Host $_.ScriptStackTrace
}

结果将类似于：

An Error occurred:
at <ScriptBlock>, <No file>: line 2

使用finally释放资源

要释放脚本使用的资源，请在 try 和 catch 块之后添加 finally 块。无论 try 块是否遇到终止错误，finally 块语句都会运行。 PowerShell 在脚本终止之前或当前块超出范围之前运行 finally 块。

即使您使用 CTRL+C 停止脚本，finally 块也会运行。如果 Exit 关键字从 catch 块中停止脚本，finally 块也会运行。

参见

• about_Break
• 关于_继续
• about_范围
• about_Throw
• about_Trap