PowerShell：提权至管理员时传递开关参数出现类型错误

核心问题分析 #

1. SwitchParameter类型丢失：手动拼接参数字符串时，将开关参数转为-Debug:$True格式，PowerShell通过-File执行时会把:$True识别为字符串后缀，无法还原为SwitchParameter类型。
2. 未调用参数被错误传递：构建参数时未正确过滤未绑定的参数，导致NewIpdb等未指定的参数被以空值形式传递，触发验证逻辑。

分步修复方案 #

1. 使用参数数组传递而非字符串拼接 #

PowerShell的Start-Process的ArgumentList接受数组形式的参数，能直接保留参数类型，避免字符串解析错误。

2. 正确收集用户指定的参数 #

• 仅处理$PSBoundParameters中的键（用户实际传递的参数），排除内部使用的Elevated参数。
• 单独处理Common参数（如-Debug），因为它们不会出现在$PSBoundParameters中，需要通过$PsBoundParameters.ContainsKey('Debug')判断。

3. 处理不同类型的参数 #

• 开关参数（SwitchParameter）：仅添加参数名（如'-Debug'），不需要值。
• 值类型参数：添加参数名和对应值（如'-NewIpdb', $NewIpdb.FullName）。

修改后的完整代码片段 #

# Parameters for command line usage
Param(
    [Parameter(HelpMessage="Path to new IP database file for script to use")]
    [ValidateScript({
        if(-Not ($_ | Test-Path)){ throw "File does not exist" }
        if(-Not ($_ | Test-Path -PathType Leaf)){ throw "Argument must point to a file" }
        if($_ -notmatch "\.json"){ throw "Argument must point to a JSON file" }
        return $true
    })]
    [System.IO.FileInfo]$NewIpdb,
    
    [Parameter(HelpMessage="A custom IP configuration string in the format IP,Netmask[,Gateway]")]
    [ValidateScript({
        if($_ -notmatch "^(((25[0-5]|(2[0-4]|1\d|[1-9]|)\d)\.?\b){4},?){2,3}$"){
            throw "A comma-separated string of valid IP addresses must be provided in the order: IP,Netmask[,Gateway]"
        }
        return $true
    })]
    [string]$SetIP,
    
    [Parameter(HelpMessage="Reset the network interface configured for this script to automatic DHCP configuration. Does not take an argument.")]
    [switch]$Reset,
    [Parameter(HelpMessage="Restart the network interface configured for this script. Does not take an argument.")]
    [switch]$Restart,
    [Parameter(HelpMessage="Used internally by script. Script MUST run with admin privileges, and attempts to self-elevate if necessary. This flag indicates success.")]
    [switch]$Elevated
)

# 处理Debug common参数
$debugParam = if ($PsBoundParameters.ContainsKey('Debug')) { '-Debug' } else { $null }

# 构建参数数组
$argumentList = @()
# 添加脚本运行基础参数
$argumentList += '-noprofile', '-noexit', '-file', "`"$($myinvocation.MyCommand.Definition)`""
# 添加用户指定的参数
foreach ($key in $PSBoundParameters.Keys) {
    # 跳过内部参数Elevated
    if ($key -eq 'Elevated') { continue }
    $value = $PSBoundParameters[$key]
    if ($value -is [System.Management.Automation.SwitchParameter]) {
        # 开关参数仅添加参数名
        $argumentList += "-$key"
    } else {
        # 值类型参数添加参数名和值（路径需加引号避免空格问题）
        if ($key -eq 'NewIpdb') {
            $argumentList += "-$key", "`"$($value.FullName)`""
        } else {
            $argumentList += "-$key", $value
        }
    }
}
# 添加Debug参数（如果存在）
if ($debugParam) { $argumentList += $debugParam }
# 添加内部Elevated参数
$argumentList += '-Elevated'

# 测试管理员权限函数
function Test-Admin {
    $currentUser = New-Object Security.Principal.WindowsPrincipal $([Security.Principal.WindowsIdentity]::GetCurrent())
    $currentUser.IsInRole([Security.Principal.WindowsBuiltinRole]::Administrator)
}

# 自提权逻辑
if (-not (Test-Admin)) {
    if ($Elevated) {
        throw "无法提升至管理员权限，程序无法正常运行，已终止。"
    } else {
        Start-Process powershell.exe -Verb RunAs -ArgumentList $argumentList
        exit
    }
}

# 后续业务代码...

关键修改说明 #

• 用数组$argumentList替代字符串拼接，确保参数类型正确传递。
• 过滤内部参数Elevated，避免循环处理。
• 开关参数仅传递参数名，不附加值，符合PowerShell的语法要求。
• NewIpdb参数传递完整路径并添加引号，避免路径中有空格时出错。
• 单独处理Common参数-Debug，确保其正确传递为开关类型。

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