如何在PowerShell的ForEach-Object中使用多参数？含PDF处理需求

一、ForEach-Object多参数的两种常用方式 #

在PowerShell的ForEach-Object中使用多参数，主要有两种实用场景：

1. 接收管道对象+自定义外部参数 #

通过-ArgumentList传递外部参数，在脚本块内用param()声明接收：

$externalParam = "自定义参数"
Get-ChildItem *.pdf | ForEach-Object -ArgumentList $externalParam -Process {
    param($currentFile, $extParam)
    # 使用$currentFile（管道对象）和$extParam（外部参数）
    Write-Host "处理文件：$($currentFile.Name)，额外参数：$extParam"
}

2. 从当前对象中提取多属性作为参数 #

直接从自动变量$_（当前管道对象）中提取多个属性赋值给变量，这是处理文件对象时最常用的方式：

Get-ChildItem *.pdf | ForEach-Object {
    $fileName = $_.Name
    $filePath = $_.FullName
    $createTime = $_.CreationTime
    # 用这些变量做后续处理
}

二、针对你的PDF处理需求的修正脚本 #

你的原脚本存在-Recurse位置错误、分组正则冗余、排序逻辑缺失、管道连接错误等问题，以下是满足你三个需求的完整可运行脚本：

# 1. 递归获取目标路径下所有PDF文件，按基础名称（去除版本号）分组
Get-ChildItem \\server\shares\drawings -Filter *.pdf -Recurse |
    Group-Object {
        # 修正正则：简化冗余字符，提取不带版本号的基础文件名
        $_ -replace '[0A-T]_(..)(?=\.)','_$1'
    } |
    # 2. 每组内按版本号排序，取最新的一个文件
    ForEach-Object {
        # 按文件名中的版本标识降序排序（若版本号规则不同，可调整排序属性）
        $latestFile = $_.Group | Sort-Object -Property Name -Descending | Select-Object -Last 1
        # 整理为表格结构的自定义对象
        [PSCustomObject]@{
            Name       = $latestFile.Name
            Created    = $latestFile.CreationTime
            FilePath   = $latestFile.FullName
            Extension  = $latestFile.Extension
            IsFolder   = $latestFile.PSIsContainer
        }
    } |
    # 3. 导出为CSV文件
    Export-Csv D:\test\Results.csv -NoTypeInformation

关键逻辑说明： #

• 分组逻辑：用修正后的正则[0A-T]_(..)(?=\.)提取文件的基础标识，确保同一份文档的不同修订版被分到同一组
• 最新版本筛选：通过Sort-Object -Property Name -Descending按文件名降序排序（如果版本号是数字递增，降序后最后一个就是最新版；若版本号是字母规则，可调整排序逻辑），再用Select-Object -Last 1锁定最新文件
• 表格整理：用[PSCustomObject]直接构造自定义对象，比Select-Object的计算属性更直观，也便于扩展更多字段
• ForEach-Object多参数处理：在分组后的ForEach-Object中，我们同时调用了组对象的$_.Group属性、排序后的$latestFile及其多个属性，这就是多参数/多属性的典型应用场景

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