如何在自定义命令中封装PowerShell Cmdlet并保留参数与管道功能

要完整封装一个Cmdlet且不丢失任何功能，核心是代理其所有参数、参数约束以及管道输入/输出逻辑，同时注入自定义逻辑。下面以封装Select-String实现彩色高亮为例，给出具体方案：

1. 复刻原生参数与约束 #

通过[CmdletBinding()]和param()块完全复刻原生Cmdlet的参数属性（包括Parameter特性、验证规则等），确保参数约束和原生一致，同时可新增自定义参数。

function Select-StringWithHighlight {
    [CmdletBinding(DefaultParameterSetName='File')]
    param(
        # 完全复刻Select-String的核心参数及约束
        [Parameter(Mandatory=$true, Position=0)]
        [string[]]$Pattern,

        [Parameter(ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true, ParameterSetName='File')]
        [string[]]$Path,

        [Parameter(ValueFromPipeline=$true, ParameterSetName='InputObject')]
        [psobject]$InputObject,

        [ValidateSet('IgnoreCase','CultureInvariant','Multiline','Singleline','ExplicitCapture','Compiled','ECMAScript','IgnorePatternWhitespace')]
        [string[]]$Option,

        # 自定义高亮颜色参数
        [ConsoleColor]$MatchColor = [ConsoleColor]::Red,
        [ConsoleColor]$PropertyColor = [ConsoleColor]::Cyan
    )

    begin {
        # 收集用户传入的原生参数，排除自定义参数
        $nativeParams = @{}
        $PSBoundParameters.GetEnumerator() | ForEach-Object {
            if ($_.Key -notin 'MatchColor', 'PropertyColor') {
                $nativeParams[$_.Key] = $_.Value
            }
        }
    }

    process {
        # 通过参数哈希表（splatting）传递原生参数，保留管道输入逻辑
        $results = Select-String @nativeParams

        # 注入自定义高亮逻辑
        foreach ($result in $results) {
            $highlightedLine = $result.Line -replace [regex]::Escape($result.Matches.Value), "`e[${MatchColor}m`$0`e[0m"
            Write-Host "[$($result.LineNumber)] $highlightedLine" -ForegroundColor $PropertyColor
        }
    }
}

2. 用参数哈希表传递原生参数 #

使用splatting（@nativeParams）将用户传入的原生参数完整传递给被封装的Cmdlet，避免手动逐个传递的繁琐，同时保证所有参数约束（如必填、验证集）生效。

3. 保留管道输入/输出能力 #

• 在参数上添加与原生Cmdlet一致的ValueFromPipeline或ValueFromPipelineByPropertyName特性，确保管道输入能被正确接收。
• 在process块中处理每个管道对象，保证原生Cmdlet的管道行为完全保留。

4. 合理注入自定义逻辑 #

可在begin、process、end三个块中插入自定义代码：

• begin：初始化资源、预处理参数
• process：处理单个管道对象，调用原生Cmdlet后修改结果
• end：清理资源、汇总最终输出

注意事项 #

• 若原生Cmdlet包含多参数集（ParameterSet），需在[CmdletBinding()]中指定默认参数集，并为每个参数标注对应的ParameterSetName，确保参数逻辑和原生一致。
• 对于原生Cmdlet的动态参数（随上下文生成的参数），需通过[DynamicParam]块复刻动态参数生成逻辑，保证功能完整。

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