PowerShell强制命令行参数：如何替换默认错误提示为自定义信息？

这个问题我之前也踩过坑——PowerShell自带的Mandatory=$True参数确实会弹出默认的红色错误，而你设置的HelpMessage只有在用户执行Get-Help或者加-?查看帮助时才会显示，并不会替换默认的缺失参数错误。要实现只显示自定义提示，得绕开它内置的参数绑定错误逻辑，这里有两种实用的方法：

方法一：手动检查参数（最简单直接） #

放弃使用Mandatory=$True，自己在脚本开头判断必填参数是否为空，然后输出自定义提示：

[CmdletBinding()]
param(
    [string]$userName
)

# 手动验证必填参数
if ([string]::IsNullOrEmpty($userName)) {
    Write-Host "❌ Error: User Name must be specified." -ForegroundColor Red
    exit 1
}

# 后续脚本逻辑
Write-Host "Hello, $userName!"

这种方式完全由你控制提示内容和样式，不会出现PowerShell默认的生硬错误信息，适合追求简洁自定义的场景。

方法二：抛出自定义终止错误（保持PowerShell错误风格） #

如果你想保留PowerShell错误的格式，但替换错误内容，可以用$PSCmdlet.ThrowTerminatingError抛出自定义错误记录：

[CmdletBinding()]
param(
    [Parameter(HelpMessage="User Name must be specified.")]
    [string]$userName
)

if ([string]::IsNullOrEmpty($userName)) {
    # 构建自定义错误记录
    $exception = [System.ArgumentNullException]::new("userName", "User Name must be specified.")
    $errorRecord = [System.Management.Automation.ErrorRecord]::new(
        $exception,
        "MissingMandatoryUserName",
        [System.Management.Automation.ErrorCategory]::InvalidArgument,
        $userName
    )
    # 抛出终止错误
    $PSCmdlet.ThrowTerminatingError($errorRecord)
}

# 后续脚本逻辑
Write-Host "Hello, $userName!"

执行后会显示你自定义的错误信息，同时保持PowerShell错误的红色样式，适合需要遵循PowerShell错误规范的场景。

补充说明 #

为什么原来的Mandatory=$True+HelpMessage不生效？因为当你设置Mandatory=$True时，PowerShell会在脚本执行之前就完成参数绑定检查，这时候它会直接触发内置的错误提示，不会调用你设置的HelpMessage作为错误内容——HelpMessage的作用是在用户查看帮助时显示提示，而非替换缺失参数的错误信息。

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