共用方式為

about_Try_Catch_Finally

  • 發行項

簡短描述

描述如何使用 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 類似於 tryC# 程式設計語言中使用的、 catch和 finally 關鍵詞。

Syntax

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”，則finally即使您按下 CTRL+C 之後，也不會顯示它。

攔截錯誤

下列範例文稿顯示具有 try 區塊的 catch 區塊：

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

關鍵詞 catch 必須緊接在 try 區塊或其他 catch 區塊之後。

PowerShell 無法將 「NonsenseString」 辨識為 Cmdlet 或其他專案。 執行此文稿會傳回下列結果：

An error occurred.

當腳本遇到 「NonsenseString」 時，會導致終止錯誤。 區塊會 catch 藉由在 區塊內執行 語句清單來處理錯誤。

使用多個 catch 語句

try語句可以有任意數目的catch區塊。 例如，下列腳本有一個會下載 MyDoc.doc的區塊，其中包含兩catch個try區塊：

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 「找不到命令」錯誤的區塊：

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

指定的錯誤類型 CommandNotFoundException 繼承自 System.SystemException 類型。 下列範例也會攔截找不到命令錯誤：

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

此 catch 區塊會處理「找不到命令」錯誤，以及繼承自 SystemException 類型的其他錯誤。

如果您指定錯誤類別及其其中一個衍生類別，請將衍生類別的 區塊放在 catch 一般類別的 catch 區塊之前。

注意

PowerShell 會包裝 RuntimeException 類型中的所有例外狀況。 因此，指定 System.Management.Automation.RuntimeException 錯誤類型的行為與不合格的 catch 區塊相同。

在 Try Catch 中使用陷阱

當終止錯誤發生在區塊內try已定義 之 的 區塊Trap中try時，即使有相符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

最後使用 釋放資源

若要釋放腳本所使用的資源，請在 和 catch 區塊之後try新增 finally 區塊。 不論 finally 區塊是否遇到終止錯誤，區塊語句都會 try 執行。 PowerShell 會在 finally 腳本終止之前或目前區塊超出範圍之前執行 區塊。

finally即使您使用 CTRL+C 來停止腳本，仍會執行區塊。 finally如果 Exit 關鍵詞停止區塊內的catch腳本，也會執行 區塊。

另請參閱