Write-Error

Write-Error
    [-Message] <string>
    [-Category <ErrorCategory>]
    [-ErrorId <string>]
    [-TargetObject <Object>]
    [-RecommendedAction <string>]
    [-CategoryActivity <string>]
    [-CategoryReason <string>]
    [-CategoryTargetName <string>]
    [-CategoryTargetType <string>]
    [<CommonParameters>]

Write-Error
    [-Exception] <Exception>
    [-Message <string>]
    [-Category <ErrorCategory>]
    [-ErrorId <string>]
    [-TargetObject <Object>]
    [-RecommendedAction <string>]
    [-CategoryActivity <string>]
    [-CategoryReason <string>]
    [-CategoryTargetName <string>]
    [-CategoryTargetType <string>]
    [<CommonParameters>]

Write-Error
    [-ErrorRecord] <ErrorRecord>
    [-RecommendedAction <string>]
    [-CategoryActivity <string>]
    [-CategoryReason <string>]
    [-CategoryTargetName <string>]
    [-CategoryTargetType <string>]
    [<CommonParameters>]

Командлет Write-Error объявляет ошибку без конца. По умолчанию ошибки отправляются в поток ошибок в отображаемую программу узла вместе с выходными данными.

Чтобы написать ошибку без конца, введите строку сообщения об ошибке, объект ErrorRecord или объект Exception. Используйте другие параметры Write-Error для заполнения записи об ошибке.

Не завершающие ошибки записывают ошибку в поток ошибок, но не останавливают обработку команд. Если ошибка, не завершающаяся, объявлена на одном элементе в коллекции входных элементов, команда продолжает обрабатывать другие элементы в коллекции.

Чтобы объявить завершающееся сообщение об ошибке, используйте ключевое слово throw. Дополнительные сведения см. в about_Throw.

Get-ChildItem | ForEach-Object {
    if ($_.GetType().ToString() -eq "Microsoft.Win32.RegistryKey")
    {
        Write-Error "Invalid object" -ErrorId B1 -TargetObject $_
    }
    else
    {
        $_
    }
}

Эта команда объявляет ошибку без конца, когда командлет Get-ChildItem возвращает объект Microsoft.Win32.RegistryKey, например объекты в HKLM: или HKCU: дисках поставщика реестра PowerShell.

Write-Error "Access denied."

Эта команда объявляет ошибку без прекращения и записывает ошибку "Отказано в доступе". Команда использует параметр Message для указания сообщения, но не указывает необязательное имя параметра Message.

Write-Error -Message "Error: Too many input values." -Category InvalidArgument

Эта команда объявляет несрочную ошибку и указывает категорию ошибок.

$E = [System.Exception]@{Source="Get-ParameterNames.ps1";HelpLink="https://go.microsoft.com/fwlink/?LinkID=113425"}
Write-Error -Exception $E -Message "Files not found. The $Files location doesn't contain any XML files."

Эта команда использует объект исключения , чтобы объявить ошибку без конца.

Первая команда использует хэш-таблицу для создания объекта System.Exception . Он сохраняет объект исключения в переменной $E. Хэш-таблица можно использовать для создания любого объекта типа с конструктором NULL.

Вторая команда использует командлет Write-Error для объявления неустранимой ошибки. Значение параметра исключения является объектом исключения в переменной .

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Вы можете передать строку, содержащую сообщение об ошибке в этот командлет.

Этот командлет не возвращает выходные данные. Он записывает только в поток сообщений об ошибке.

Write-Error не изменяет значение автоматической переменной $?, поэтому она не сигнализирует о завершающейся ошибке. Чтобы сигнализировать об ошибке конца, используйте метод $PSCmdlet.WriteError().