如何让PowerShell函数的两个参数中至少一个为必传参数？

问题分析 #

你的原代码存在两个问题：

• 参数定义语法错误：$path和$fileList之间缺少逗号分隔
• 判断逻辑不准确：$fileList -eq ""不适用于[string[]]数组类型，应该判断数组是否为$null或空数组

下面提供两种更规范的实现方式，优先推荐参数集方案。

方案一：使用PowerShell参数集（官方推荐） #

参数集是PowerShell原生支持的参数组合管理机制，可以直接实现「至少传入一个参数」的需求，而且会在参数解析阶段就提示用户，无需进入函数体才报错。

实现代码 #

function foo {
    [CmdletBinding(DefaultParameterSetName = 'PathSet')]
    param (
        [Parameter(Mandatory = $true, ParameterSetName = 'PathSet')]
        [Parameter(Mandatory = $false, ParameterSetName = 'FileListSet')]
        [string[]]$Path,

        [Parameter(Mandatory = $true, ParameterSetName = 'FileListSet')]
        [Parameter(Mandatory = $false, ParameterSetName = 'PathSet')]
        [string[]]$FileList
    )

    # 后续逻辑示例
    if ($PSCmdlet.ParameterSetName -eq 'PathSet') {
        Write-Host "使用Path参数集，传入的路径：$Path"
    }
    elseif ($PSCmdlet.ParameterSetName -eq 'FileListSet') {
        Write-Host "使用FileList参数集，传入的文件列表：$FileList"
    }
}

说明 #

• 定义了两个参数集：PathSet和FileListSet
• Path在PathSet中是必填项，在FileListSet中为可选；FileList则相反
• 设置DefaultParameterSetName = 'PathSet'，用户只传FileList时会自动切换到对应参数集
• 支持三种传参场景：单独传Path、单独传FileList、同时传两个参数，完全满足「至少一个必传」的需求
• 当用户未传任何参数时，PowerShell会自动提示缺少必填参数，无需手动编写错误判断逻辑

方案二：手动验证（兼容旧版本） #

如果不想用参数集，可以在函数开头做更准确的手动验证，同时使用PowerShell标准错误处理机制抛出规范错误：

实现代码 #

function foo {
    param (
        [string[]]$Path,
        [string[]]$FileList
    )

    # 验证至少传入一个参数
    $isPathEmpty = ($null -eq $Path) -or ($Path.Count -eq 0)
    $isFileListEmpty = ($null -eq $FileList) -or ($FileList.Count -eq 0)

    if ($isPathEmpty -and $isFileListEmpty) {
        $errorRecord = [System.Management.Automation.ErrorRecord]::new(
            [System.ArgumentException]"必须传入Path或FileList参数中的至少一个",
            "MissingRequiredParameter",
            [System.Management.Automation.ErrorCategory]::InvalidArgument,
            $null
        )
        $PSCmdlet.ThrowTerminatingError($errorRecord)
    }

    # 后续逻辑示例
    Write-Host "传入的Path：$Path"
    Write-Host "传入的FileList：$FileList"
}

说明 #

• 修复了原代码的判断逻辑，准确检测数组是否为空
• 使用$PSCmdlet.ThrowTerminatingError抛出规范的终止错误，比Write-Error -ErrorAction Stop更符合PowerShell错误处理规范
• 错误信息会被PowerShell错误系统正确捕获，行为更一致

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