使用英语阅读

通过

about_Try_Catch_Finally

  • 项目

应用到: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0

主题

about_Try_Catch_Finally

简短说明

介绍如何使用 Try、Catch 和 Finally 块处理终止错误。

详细说明

使用 Try、Catch 和 Finally 块响应或处理脚本中的终止错误。Trap 语句还可用于处理脚本中的终止错误。有关详细信息，请参阅 about_Trap。

终止错误使语句停止运行。如果 Windows PowerShell® 不以某种方式处理终止错误，则 Windows PowerShell 还会停止运行使用当前管道的函数或脚本。在其他语言（例如 C#）中，终止错误称为异常。有关错误的详细信息，请参阅 about_Errors。

使用 Try 块定义你希望 Windows PowerShell 在其中监视错误的脚本的一部分。当在 Try 块内发生错误时，错误首先保存到 $Error 自动变量。Windows PowerShell 随后搜索一个 Catch 块来处理该错误。如果 Try 语句没有匹配的 Catch 块，Windows PowerShell 将继续在父范围中搜索相应的 Catch 块或 Trap 语句。在 Catch 块完成后，或未找到相应的 Catch 块或 Trap 语句时，将运行 Finally 块。如果无法处理错误，则该错误将写入错误流。

Catch 块可以包含用于跟踪失败或用于恢复该脚本的预期流的命令。Catch 块可以指定它捕获哪些错误类型。Try 语句可以为不同类型的错误包含多个 Catch 块。

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

Try、Catch 和 Finally 类似于 C# 编程语言中使用的 Try、Catch 和 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 块内，则 Windows 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 块已运行”，则它不会在你按下 CTRL+C 后显示，即使 Finally 块已运行。

捕获错误

以下示例脚本显示一个带有 Catch 块的 Try 块：

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

Catch 关键字必须紧跟 Try 块或另一个 Catch 块。

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

          An error occurred.

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

使用多个 CATCH 语句

Try 语句可以具有任意数量的 Catch 块。例如，以下脚本具有一个可下载 MyFile.doc 的 Try 块，并且它包含两个 Catch 块：

          try
          {
             $wc = new-object System.Net.WebClient
             $wc.DownloadFile("https://www.contoso.com/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."
          }

第一个 Catch 块处理 System.Net.WebException 和 System.IO.IOException 类型的错误。第二个 Catch 块不指定错误类型。第二个 Catch 块处理出现的任何其他终止错误。

Windows PowerShell 按继承匹配错误类型。Catch 块会处理指定的 .NET Framework 异常类或派生自指定类的任何类的错误。以下示例包含可以捕获“找不到命令”错误的 Catch 块：

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

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

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

此 Catch 块处理“找不到命令”错误和其他继承自 SystemException 类型的错误。

如果你指定一个错误类及其一个派生类，请将该派生类的 Catch 块放置在常规类的 Catch 块前。

通过使用 FINALLY 释放资源

若要释放脚本使用的资源，在 Try 和 Catch 块后添加 Finally 块。无论 Try 块是否遇到终止错误，Finally 块语句都将运行。Windows PowerShell 在脚本终止或当前块离开范围前运行 Finally 块。

即使你使用 CTRL+C 停止该脚本，Finally 块仍将运行。如果 Exit 关键字从 Catch 块内停止脚本，Finally 块也会运行。

另请参阅

about_Break

about_Continue

about_Scopes

about_Throw

about_Trap