PowerShell 5.1高级函数如何允许使用额外参数？

针对你这种主函数作为多个小函数参数超集的场景，要允许主函数接受额外参数（不管是位置参数还是命名参数）且不报错，其实有两种常用的实现方式，我结合你的场景给你详细说明：

方式一：捕获额外的位置参数（简单直接） #

如果只需要接受额外的位置参数（也就是用户传入的没有对应命名的参数），可以直接在主函数的参数块里添加一个带有ValueFromRemainingArguments属性的参数，它会自动收集所有未被主函数已定义参数匹配的位置参数。

示例代码 #

# 定义两个小型函数
function Get-User {
    [CmdletBinding()]
    param(
        [string]$Name,
        [int]$Age
    )
    Write-Host "获取用户信息：姓名=$Name，年龄=$Age"
}

function Get-AppLog {
    [CmdletBinding()]
    param(
        [string]$LogPath,
        [ValidateSet('Info','Warning','Error')]
        [string]$Level
    )
    Write-Host "获取日志：路径=$LogPath，级别=$Level"
}

# 主函数 - 包含所有小函数参数，并接受额外位置参数
function Invoke-Main {
    [CmdletBinding()]
    param(
        # 来自Get-User的参数
        [string]$Name,
        [int]$Age,
        # 来自Get-AppLog的参数
        [string]$LogPath,
        [string]$Level,
        # 捕获所有额外的位置参数
        [Parameter(ValueFromRemainingArguments=$true)]
        [object[]]$ExtraPositionalArgs
    )

    # 调用小函数，传递对应参数
    if ($PSBoundParameters.ContainsKey('Name') -or $PSBoundParameters.ContainsKey('Age')) {
        Get-User @PSBoundParameters
    }
    if ($PSBoundParameters.ContainsKey('LogPath') -or $PSBoundParameters.ContainsKey('Level')) {
        Get-AppLog @PSBoundParameters
    }

    # 处理额外的位置参数
    if ($ExtraPositionalArgs) {
        Write-Host "`n收到额外位置参数："
        $ExtraPositionalArgs | ForEach-Object { Write-Host "  - $_" }
    }
}

测试调用 #

# 传入小函数参数 + 2个额外位置参数
Invoke-Main -Name "Ryan" -LogPath "C:\app\logs" "额外参数1" "额外参数2"

方式二：接受任意额外参数（位置+命名） #

如果需要允许用户传入未定义的命名参数（比如-ExtraParam "test"）且不报错，就得用$PSCmdlet.GetUnboundArguments()方法，它能捕获所有未被主函数参数绑定的参数（包括位置和命名），前提是主函数带有[CmdletBinding()]属性。

示例代码 #

function Invoke-Main {
    [CmdletBinding()]
    param(
        [string]$Name,
        [int]$Age,
        [string]$LogPath,
        [string]$Level
    )

    # 调用小函数逻辑和之前一致
    if ($PSBoundParameters.ContainsKey('Name') -or $PSBoundParameters.ContainsKey('Age')) {
        Get-User @PSBoundParameters
    }
    if ($PSBoundParameters.ContainsKey('LogPath') -or $PSBoundParameters.ContainsKey('Level')) {
        Get-AppLog @PSBoundParameters
    }

    # 获取所有未绑定的额外参数（位置+命名）
    $extraArgs = $PSCmdlet.GetUnboundArguments()
    if ($extraArgs) {
        Write-Host "`n收到额外参数："
        $extraArgs | ForEach-Object { Write-Host "  - $_" }
    }

    # 如果需要把额外参数传递给某个小函数，可以用splatting
    # 比如：& Get-SomeOtherFunction @extraArgs
}

测试调用 #

# 传入小函数参数 + 额外命名参数 + 额外位置参数
Invoke-Main -Name "Ryan" -Level "Error" -CustomParam "自定义值" "额外位置参数"

关键说明 #

• $PSCmdlet.GetUnboundArguments()会返回一个数组，包含所有未被主函数参数匹配的内容，命名参数会以-参数名和参数值的形式分开存储在数组里。
• 如果要把这些额外参数传递给其他函数，直接用splatting（@extraArgs）即可，PowerShell会自动处理参数绑定。

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