如何正确使用$PSCmdlet.ThrowTerminatingError()抛出通用错误？

你的观点完全正确：在使用[CmdletBinding()]的高级函数里，优先用$PSCmdlet.ThrowTerminatingError()和$PSCmdlet.WriteError()确实比throw和Write-Error更符合PowerShell的错误处理模型——它们能更好地集成管道错误流、响应-ErrorAction/-ErrorVariable参数，还能自定义错误的关键属性（比如唯一ErrorId、错误分类）。

构造ErrorRecord看似繁琐，但可以通过以下几种方式简化，完全不需要用try-catch捕获throw的权宜之计：

1. 手动直接构造ErrorRecord #

这是最基础也是最灵活的方式，核心是利用[System.Management.Automation.ErrorRecord]的构造函数，传入4个关键参数：

• Exception：错误对应的异常对象（可以用.NET内置异常类，也可以自定义）
• ErrorId：自定义的唯一错误标识符，方便后续捕获后区分错误类型
• ErrorCategory：错误所属的分类（比如ObjectNotFound、InvalidData）
• TargetObject：错误关联的目标对象（比如出错的文件路径、参数值）

示例代码：

function Test-FileProcessing {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory)]
        [string]$FilePath
    )

    # 处理终止错误：路径不存在
    if (-not (Test-Path -Path $FilePath)) {
        $exception = [System.IO.FileNotFoundException]"指定路径不存在: $FilePath"
        $errorRecord = [System.Management.Automation.ErrorRecord]::new(
            $exception,
            'FilePathNotFound',
            [System.Management.Automation.ErrorCategory]::ObjectNotFound,
            $FilePath
        )
        $PSCmdlet.ThrowTerminatingError($errorRecord)
    }

    # 处理非终止错误：文件过大
    $file = Get-Item -Path $FilePath
    if ($file.Length -gt 1GB) {
        $exception = [System.Exception]"文件超出大小限制: $($file.Name)"
        $errorRecord = [System.Management.Automation.ErrorRecord]::new(
            $exception,
            'FileSizeExceeded',
            [System.Management.Automation.ErrorCategory]::InvalidData,
            $file
        )
        $PSCmdlet.WriteError($errorRecord)
        # 非终止错误不中断执行，继续后续逻辑
        Write-Output "继续处理符合要求的内容"
    }
}

2. 封装辅助函数简化构造 #

如果需要频繁构造ErrorRecord，可以写一个辅助函数封装重复逻辑，减少代码冗余：

function New-CustomErrorRecord {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory)]
        [string]$Message,
        [Parameter(Mandatory)]
        [string]$ErrorId,
        [Parameter(Mandatory)]
        [System.Management.Automation.ErrorCategory]$Category,
        [object]$Target,
        [Type]$ExceptionType = [System.Management.Automation.RuntimeException]
    )

    $exception = $ExceptionType::new($Message)
    return [System.Management.Automation.ErrorRecord]::new(
        $exception,
        $ErrorId,
        $Category,
        $Target
    )
}

# 在高级函数中调用辅助函数
function Test-FileProcessing {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory)]
        [string]$FilePath
    )

    if (-not (Test-Path -Path $FilePath)) {
        $errorRecord = New-CustomErrorRecord -Message "路径不存在: $FilePath" `
            -ErrorId 'FilePathNotFound' `
            -Category ObjectNotFound `
            -Target $FilePath `
            -ExceptionType [System.IO.FileNotFoundException]
        $PSCmdlet.ThrowTerminatingError($errorRecord)
    }
}

3. 利用现有异常快速生成 #

如果不需要自定义异常类型，也可以直接用PowerShell内置的[System.Management.Automation.RuntimeException]快速构造简单的错误记录：

$errorRecord = [System.Management.Automation.ErrorRecord]::new(
    [System.Management.Automation.RuntimeException]"参数格式错误",
    'InvalidParameterFormat',
    [System.Management.Automation.ErrorCategory]::InvalidArgument,
    $PSBoundParameters['ParamName']
)
$PSCmdlet.WriteError($errorRecord)

关键注意点 #

• ErrorId要唯一：每个不同的错误场景应该用不同的ErrorId，这样用户可以通过-ErrorVariable捕获错误后，根据$errorVar.ErrorId做针对性处理。
• 区分终止/非终止错误：ThrowTerminatingError会直接中断函数执行，适合严重错误；WriteError只会将错误写入错误流，函数继续执行，适合不影响后续逻辑的警告类错误。
• 避免try-catch捕获throw：这种方式会生成默认的ErrorId（ScriptHalted），丢失自定义错误属性，还增加了不必要的代码层级，完全没必要。

内容的提问来源于stack exchange，提问作者PC Luddite