關於 Try Catch Finally

發行項
05/09/2024

簡短描述

描述如何使用 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 區塊已執行」，即使您按下 CTRL+C，它 Finally 也不會顯示。

攔截錯誤

下列範例文稿顯示 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("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."
}

第一個 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 。

在 Try Catch 中使用陷阱

當區塊中有定義的區塊發生Try終止錯誤時，即使有相符Catch的區塊，Trap語句仍會Trap控制。Try

Trap如果存在於高於 Try的區塊，而且目前範圍內沒有相符Catch的區塊，則即使有任何父範圍具有相符Catch的區塊，Trap也會取得控制權。

存取例外狀況資訊

在 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 釋放資源

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

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

另請參閱

共用方式為