PowerShell多态函数问题：传递不同数据类型触发位置参数错误

你遇到的“无法找到接受参数‘Running’的位置参数”错误，核心原因是参数集（ParameterSet）的参数定义不完整，或者参数位置配置冲突，导致PowerShell无法正确匹配你传入的位置参数。下面是修复后的完整实现，以及关键细节说明：

正确的函数实现 #

function Get-RemoteServiceStatus {
    [CmdletBinding(DefaultParameterSetName = 'StringComputer')]
    param (
        # 字符串类型：远程计算机名
        [Parameter(Mandatory = $true, ParameterSetName = 'StringComputer', Position = 0)]
        [string]$ComputerName,

        # 哈希表类型：可包含ComputerName、Credential等复杂参数
        [Parameter(Mandatory = $true, ParameterSetName = 'HashtableComputer', Position = 0)]
        [hashtable]$ComputerParams,

        # 服务状态（必选，同时属于两个参数集）
        [Parameter(Mandatory = $true, ParameterSetName = 'StringComputer', Position = 1)]
        [Parameter(Mandatory = $true, ParameterSetName = 'HashtableComputer', Position = 1)]
        [string]$Status
    )

    process {
        switch ($PSCmdlet.ParameterSetName) {
            'StringComputer' {
                # 字符串参数逻辑：直接查询指定计算机
                Get-Service -ComputerName $ComputerName | Where-Object Status -eq $Status
            }
            'HashtableComputer' {
                # 哈希表参数逻辑：支持带凭据等扩展参数
                Get-Service @ComputerParams | Where-Object Status -eq $Status
            }
        }
    }
}

关键修复点 #

1. 参数集绑定完整：将$Status参数同时加入两个参数集，确保无论触发哪个参数集，都能识别这个必选参数。
2. 位置参数对齐：给两个参数集里的第一个参数都设Position = 0，第二个参数$Status都设Position = 1，这样位置调用时PowerShell能正确映射参数。
3. 默认参数集：设置DefaultParameterSetName = 'StringComputer'，当参数无法自动匹配时，默认使用字符串参数的逻辑。

正确调用方式 #

方式1：字符串类型参数（位置/命名调用都支持） #

# 位置调用
Get-RemoteServiceStatus "Server01" "Running"

# 命名调用
Get-RemoteServiceStatus -ComputerName "Server01" -Status "Running"

方式2：哈希表类型参数（位置/命名调用都支持） #

# 定义哈希表（可包含Credential等扩展参数）
$computerParams = @{
    ComputerName = "Server01"
    Credential   = Get-Credential
}

# 位置调用
Get-RemoteServiceStatus $computerParams "Running"

# 命名调用
Get-RemoteServiceStatus -ComputerParams $computerParams -Status "Running"

错误原因复盘 #

之前的代码大概率是没有将$Status参数同时绑定到两个参数集，或者两个参数集里的参数位置设置不一致。当你传入位置参数时，PowerShell找不到对应参数集里的第二个位置参数，就会抛出“无法找到接受参数‘Running’的位置参数”的错误。

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