Когда мне следует использовать Write-Error или Throw? Завершающие и непрекращающиеся ошибки

Write-Error следует использовать, если вы хотите сообщить пользователю о некритической ошибке. По умолчанию все, что он делает, это выводит сообщение об ошибке красным цветом на консоль. Это не останавливает конвейер или цикл от продолжения. Throw, с другой стороны, вызывает то, что называется прерывающей ошибкой. Если вы используете throw, конвейер и / или текущий цикл будут завершены. Фактически все выполнение будет прекращено, если вы не используете структуру trap или try/catch для обработки завершающей ошибки.

Следует отметить одну вещь: если вы установите $ErrorActionPreference на "Stop" и используете Write-Error, это вызовет прерывающую ошибку.

В скрипте, на который вы указали ссылку, мы находим следующее:

if ($url.Contains("http")) {
       $request = [System.Net.HttpWebRequest]::Create($url)
}
else {
       $URL_Format_Error = [string]"Connection protocol not specified. Recommended action: Try again using protocol (for example 'http://" + $url + "') instead. Function aborting..."
       Write-Error $URL_Format_Error
    return
   }

Похоже, что автор этой функции хотел остановить выполнение этой функции и вывести на экран сообщение об ошибке, но не хотел, чтобы весь скрипт останавливался. Автор сценария мог использовать throw, однако это означало бы, что вам придется использовать try/catch при вызове функции.

return выйдет из текущей области, которая может быть функцией, сценарием или блоком сценария. Лучше всего это проиллюстрировать кодом:

# A foreach loop.
foreach ( $i in  (1..10) ) { Write-Host $i ; if ($i -eq 5) { return } }

# A for loop.
for ($i = 1; $i -le 10; $i++) { Write-Host $i ; if ($i -eq 5) { return } }

Выход для обоих:

1
2
3
4
5

Одна из проблем здесь заключается в использовании return с ForEach-Object. Это не нарушит обработку, как можно было бы ожидать.

Больше информации:

• $ErrorActionPreference: about_Preference_Variables
• try/catch: about_Try_Catch_Finally
• trap: about_Trap
• throw: about_Throw
• return: about_Return

Важно. Существует 2 типа прерывающих ошибок, которые, к сожалению, совпадают в текущих разделах справки:

• инструкция - устранение ошибок, о которых сообщают командлеты в определенных невосстановимых ситуациях и выражения, в которых возникает исключение .NET / ошибка времени выполнения PS; только инструкция завершается, а выполнение скрипта продолжается по умолчанию.

• скрипт - устранение ошибок (точнее: runspace - завершение), вызванных либо Throw, либо эскалация одного из других типов ошибок с помощью общий -ErrorAction параметр, -ErrorAction Stop или через _ 4_ предпочтительная переменная, $ErrorActionPreference = 'Stop'.
  Если они не обнаружены, они завершают текущую область выполнения (поток); то есть они завершают не только текущий сценарий, но и всех его вызывающих, если применимо).

Полный обзор обработки ошибок PowerShell см. В выпуске документации GitHub № 1583.

Остальная часть этого сообщения посвящена непрекращающимся и завершающим оператору ошибкам.

Чтобы дополнить существующие полезные ответы, сосредоточив внимание на сути вопроса: Как вы выбираете, следует ли сообщать о заявлении - прекращении или не- завершающая ошибка?

Отчет об ошибках командлета содержит полезные рекомендации; позвольте мне сделать прагматическое резюме:

Общая идея непрекращающихся ошибок состоит в том, чтобы обеспечить отказоустойчивую обработку больших входных наборов: неспособность обработать подмножество входных объектов не должен (по умолчанию) прерывать потенциально длительный процесс в целом, что позволяет вам проверить ошибки и повторно обработать только сбойные объекты позже < / strong> - согласно отчетам об ошибках, собранным в автоматической переменной $Error.