如何将Cmdlet参数设为必填且未提供时抛出异常

方案一：修改错误偏好设置强制报错 #

PowerShell中，将$ErrorActionPreference设为Stop后，必填参数缺失会直接抛出终止性异常，而非进入交互式提示。

• 全局生效（影响所有脚本/命令）：

$ErrorActionPreference = 'Stop'

执行后调用函数，缺失参数时直接报错：

Write-Do
# 输出示例：
# Write-Do : 缺少命令参数“s”。
# 所在位置 行:1 字符:1
# + Write-Do
# + ~~~~~~~~
#     + CategoryInfo          : InvalidArgument: (:) [Write-Do], ParameterBindingException
#     + FullyQualifiedErrorId : MissingMandatoryParameter,Write-Do

• 局部作用域生效（适合批量任务脚本）：

& {
    $ErrorActionPreference = 'Stop'
    Write-Do  # 此处缺失参数直接报错，不阻塞
    # 后续批量任务逻辑
}

方案二：自定义参数验证逻辑 #

若不想修改全局错误偏好，可移除[Parameter(Mandatory)]的默认提示行为，改用显式检查并抛出异常：

修改后的函数示例：

function Write-Do {
    [CmdletBinding()]
    param(
        [Parameter()]
        [string]$s
    )

    # 检查参数是否被传入
    if (-not $PSBoundParameters.ContainsKey('s')) {
        throw "必填参数`s`未提供，请指定参数值。"
    }

    Write-Host $s
}

调用时缺失参数直接抛异常：

Write-Do
# 输出示例：
# 异常调用"Write-Do"时出现以下错误: 必填参数`s`未提供，请指定参数值。
# 所在位置 行:1 字符:1
# + Write-Do
# + ~~~~~~~~
#     + CategoryInfo          : NotSpecified: (:) [Write-Do], MethodInvocationException
#     + FullyQualifiedErrorId : RuntimeException,Write-Do

方案三：保留Mandatory属性并自定义报错（进阶） #

如需保留[Parameter(Mandatory)]的元数据（用于Get-Help等场景），同时禁用提示，可通过参数绑定检查实现：

function Write-Do {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory)]
        [string]$s
    )

    begin {
        # 检查必填参数是否绑定，未绑定则抛终止性异常
        if (-not $PSCmdlet.MyInvocation.BoundParameters.ContainsKey('s')) {
            $errRecord = New-Object System.Management.Automation.ErrorRecord(
                [System.ArgumentException]"必填参数`s`未提供",
                "MissingMandatoryParameter",
                [System.Management.Automation.ErrorCategory]::InvalidArgument,
                $null
            )
            $PSCmdlet.ThrowTerminatingError($errRecord)
        }
    }

    process {
        Write-Host $s
    }
}

该方式适合非交互式环境（批量任务、PS Job），避免任务卡住。

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