PowerShell 5.1位置与命名参数调用函数的技术差异及报错解析

在PowerShell 5.1中递归调用函数时，发现使用错误的位置参数写法会触发ParameterBindingArgumentTransformationException异常，而使用命名参数调用则完全正常。以下是问题的最小复现场景：

复现函数 #

该函数用于提取嵌套哈希表中所有叶子节点的层级键路径：

function Get-Keys([hashtable]$hash, [string]$parentKey = "") {
    $keys = @()

    foreach ($key in $hash.Keys) {
        $newKey = if ($parentKey) { "$parentKey.$key" } else { $key }
        if ($hash[$key] -is [hashtable]) {
            # 错误的位置参数调用写法
            $output = Get-Keys($hash[$key], $newKey)
            # 正确的命名参数调用写法
            # $output = Get-Keys -hash $hash[$key] -parentKey $newKey
            $keys += $output
        } else {
            $keys += $newKey
        }
    }

    return $keys
}

测试用嵌套哈希表 #

$blah = @{
    "a" = @{
        "b" = "val"
        "d" = @(1,2,3)
        "e" = @{
            "f" = "foo"
        }
    }
    "h" = "bar"
}

错误信息 #

使用错误的位置参数写法时，抛出如下异常：

Get-Keys : Cannot process argument transformation on parameter 'hash'. Cannot convert the "System.Object[]" value of type "System.Object[]" to type "System.Collections.Hashtable".
At <filename>:<linenumber> char:<charnumber>
+             $output = Get-Keys($hash[$key], $newKey)
+                               ~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidData: (:) [Get-Keys], ParameterBindingArgumentTransformationException
    + FullyQualifiedErrorId : ParameterArgumentTransformationError,Get-Keys

正常运行结果 #

切换为命名参数调用后，函数正常执行并输出预期结果：

$output = Get-Keys -hash $hash[$key] -parentKey $newKey
# 输出：h a.d a.e.f a.b

已确认进入递归分支时$hash[$key]为Hashtable类型、$newKey为String类型，即使关闭Set-StrictMode仍会报错。核心疑问是：PowerShell 5.1中使用位置参数与命名参数调用函数的技术差异究竟是什么？

技术差异解析 #

1. 函数调用语法的本质区别 #

PowerShell的函数调用语法与传统C系语言有本质不同：

• 命名参数调用：通过-参数名 参数值的形式明确绑定参数，PowerShell会直接根据参数名匹配，不受参数顺序影响（除非参数定义了[Parameter(Position=n)]属性）。这种写法逻辑清晰，参数绑定不会出现歧义。
• 位置参数的正确写法：PowerShell中位置参数是通过空格分隔传递的，比如Get-Keys $hash[$key] $newKey，此时第一个值绑定到$hash参数，第二个值绑定到$parentKey参数。
• 错误的"位置参数"写法：你使用的Get-Keys($hash[$key], $newKey)是C系语言的写法，但在PowerShell中，括号会将内部的表达式作为一个整体求值——逗号在这里会创建一个Object[]数组，相当于把@($hash[$key], $newKey)作为单个参数传递给函数的第一个位置参数$hash，而$hash要求的是Hashtable类型，数组无法转换为Hashtable，因此抛出异常。

2. 参数绑定机制的差异 #

• 命名参数绑定：PowerShell会优先根据参数名匹配目标参数，然后对参数值进行类型验证和转换。只要参数值的类型与目标参数类型兼容（或可转换），就能成功绑定。
• 位置参数绑定：正确的位置参数写法下，PowerShell会按照参数定义的顺序（默认按函数参数声明顺序）依次绑定值，同样会进行类型验证。但错误的括号+逗号写法会破坏这种绑定逻辑，将多个值打包成数组作为单个参数传递，导致类型不匹配。

验证修正 #

将错误的调用写法改为正确的位置参数写法即可正常运行：

$output = Get-Keys $hash[$key] $newKey

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