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 cmdlet 声明非终止错误。 默认情况下，错误流中将错误发送到要显示的主机程序以及输出。

若要写入非终止错误，请输入错误消息字符串、ErrorRecord 对象或 异常 对象。 使用 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 cmdlet 返回 Microsoft.Win32.RegistryKey 对象（例如 PowerShell 注册表提供程序的 HKLM: 或 HKCU: 驱动器中的对象）时声明非终止错误。

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 cmdlet 声明非终止错误。 Exception 参数的值是 变量中的 $E 对象。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以通过管道将包含错误消息的字符串传递给此 cmdlet。

此 cmdlet 不返回任何输出。 它只写入错误消息流。

Write-Error 不会更改 $? 自动变量的值，因此它不会发出终止错误条件的信号。 若要发出终止错误的信号，请使用 $PSCmdlet.WriteError（） 方法。