如何在PowerShell 7中定义并使用[ref]类型的命名参数

核心问题原因 #

你遇到的Cannot process argument transformation on parameter 'MyRefParam'. Reference type is expected in argument.报错，是由于参数类型修饰符的定义顺序与PowerShell 7的参数绑定逻辑冲突导致的，有两种符合命名参数调用规范的解决方法： #

方案1：调整参数类型修饰符顺序（无需修改调用逻辑） #

将函数定义中[ref]和值类型的修饰顺序调换，参数绑定就可以正确识别传入的ref对象，示例代码如下：

# 仅调整了类型修饰符顺序，将[ref]放在[string]之后
Function MyFunction ([string][ref]$MyRefParam) {
    $MyRefParam.Value = "newValue"
}
$myLocal = "oldValue"
Write-Host $myLocal  # 输出：oldValue
# 完全符合命名参数调用规范
MyFunction -MyRefParam ([ref]$myLocal)
Write-Host $myLocal # 输出：newValue

也可以使用PowerShell 7支持的泛型ref写法，效果一致：

Function MyFunction ([ref[string]]$MyRefParam) {
    $MyRefParam.Value = "newValue"
}

方案2：调用侧预创建ref实例（无需修改原有函数定义） #

如果不允许修改原有函数的参数定义，可以在调用前先将本地变量转为ref实例赋值给临时变量，再通过命名参数传入即可绕过报错：

# 沿用你原有的函数定义，无需修改
Function MyFunction ([ref][string]$MyRefParam) {
    $MyRefParam.Value = "newValue"
}
$myLocal = "oldValue"
Write-Host $myLocal  # 输出：oldValue
# 预创建ref实例再传参
$myRef = [ref]$myLocal
MyFunction -MyRefParam $myRef
Write-Host $myLocal # 输出：newValue

两种方案均符合命名参数调用要求，无需使用位置参数或括号包裹的调用写法，可以正常通过PR规范校验。

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