如何从CommandAst解析命令名称及各类参数（含别名、位置参数等）

在编写PSSA规则时，确实可以借助PowerShell引擎的内置参数解析逻辑，通过Cmdlet的元数据来匹配各种形式的参数（命名、别名、弹性前缀、位置），无需自己实现复杂的匹配逻辑。

核心思路 #

1. 通过Get-Command获取目标Cmdlet（如New-Object）的元数据，包含所有参数的别名、位置、弹性匹配规则。
2. 遍历CommandAst中的ParameterAst（命名参数）和PositionalArgumentAst（位置参数），结合元数据映射到真实的参数名。
3. 基于真实参数名判断是否需要排除（如含ComObject参数的New-Object），或提取所需参数（如TypeName）用于自动修复。

实现示例（PSSA规则片段） #

function VisitCommand($CommandAst) {
    $commandName = $CommandAst.GetCommandName()
    if ($commandName -ne 'New-Object') { return }

    # 获取New-Object的Cmdlet元数据
    $cmdlet = Get-Command $commandName -CommandType Cmdlet
    $resolvedParams = @{}

    # 处理命名参数（含别名、弹性前缀）
    foreach ($paramAst in $CommandAst.ParameterAst) {
        $inputParamName = $paramAst.ParameterName
        # 匹配真实参数：全名、别名、最短唯一前缀
        $realParam = $cmdlet.Parameters.Values | Where-Object {
            $_.Name -eq $inputParamName -or
            $_.Aliases -contains $inputParamName -or
            ($_.Name.StartsWith($inputParamName, [System.StringComparison]::OrdinalIgnoreCase) -and
             $cmdlet.Parameters.Values.Where({ $_.Name.StartsWith($inputParamName, [System.StringComparison]::OrdinalIgnoreCase) }, 'First').Count -eq 1)
        } | Select-Object -First 1

        if ($realParam) {
            $resolvedParams[$realParam.Name] = $paramAst.Argument.Extent.Text.Trim("'""")
        }
    }

    # 处理位置参数
    $positionalParams = $cmdlet.Parameters.Values | 
        Where-Object { $_.Position -ge 0 } | 
        Sort-Object Position
    for ($i = 0; $i -lt $CommandAst.PositionalArguments.Count; $i++) {
        if ($i -ge $positionalParams.Count) { break }
        $realParam = $positionalParams[$i]
        $resolvedParams[$realParam.Name] = $CommandAst.PositionalArguments[$i].Extent.Text.Trim("'""")
    }

    # 排除含-ComObject的命令，避免误报
    if ($resolvedParams.ContainsKey('ComObject')) { return }

    # 触发规则警告
    $this.ReportIssue(
        $CommandAst.Extent,
        '避免使用New-Object，建议改用类型构造函数[TypeName]::new()'
    )

    # 实现自动修复
    if ($this.SupportFix -and $resolvedParams.ContainsKey('TypeName')) {
        $typeName = $resolvedParams['TypeName']
        $args = $resolvedParams['Args'] ?? ''
        $fixText = if ($args) { "[$typeName]::new($args)" } else { "[$typeName]::new()" }
        $this.RegisterFix($CommandAst.Extent, $fixText)
    }
}

关键细节 #

• 弹性参数匹配：通过检查参数名的最短唯一前缀（PowerShell内置逻辑），确保-Type能正确映射到-TypeName。
• 别名处理：直接从Cmdlet元数据的Aliases属性匹配，比如-Args对应-ArgumentList。
• 位置参数映射：根据参数定义的Position属性排序后匹配，确保第一个位置参数对应-TypeName。

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