PowerShell -Parallel并行处理ImageMagick脚本遇参数集错误求助

我尝试用PowerShell的-Parallel参数加速基于ImageMagick的文件格式检查脚本——原本串行运行正常，但处理大量文件时速度过慢。启用并行处理后，持续遇到以下错误：

无法使用指定的命名参数解析参数集。一个或多个参数缺失、不允许同时使用，或者为所选参数集提供的参数数量不足。

初始报错代码 #

$files | ForEach-Object -Parallel {
    param ($file, $magickPath, $errorLogFile)

    try {
        # 调用ImageMagick识别文件格式
        $output = & $magickPath identify -ping -quiet -format "%m" $file.FullName

        # 检查是否为非JPEG/PNG格式
        if ($output -ne "JPEG" -and $output -ne "PNG") {
            $fileName = $file.Name
            "$fileName - $output"
        }
    }
    catch {
        # 记录错误信息
        $errorMsg = "处理文件出错: $($file.FullName). 错误详情: $($_.Exception.Message)"
        $errorMsg | Out-File -FilePath $errorLogFile -Append
    }
} -ThrottleLimit 8 -ArgumentList $magickPath, $errorLogFile | ForEach-Object {
    if ($_ -ne $null) {
        $nonJpegPngFiles += $_
    }
}

错误原因分析 #

这段代码的核心问题在于对ForEach-Object -Parallel的使用逻辑错误：

• 管道传递的文件对象应通过$_直接引用，而非试图通过param接收$file参数；
• 并行块中引用外部变量需使用$using:前缀，而非通过-ArgumentList传递后用参数接收；
• 并行块中直接追加写入日志文件会引发多线程写入冲突，应该统一收集结果后再处理。

更新后的可行代码 #

# 图片所在文件夹路径
$folderPath = "C:\Users\johndoe\Documents\saved images"

# 存储不支持格式图片列表的文件路径
$outputFile = "C:\Users\johndoe\Documents\Unsupported list\unsupported_images_list.txt"

# ImageMagick可执行文件路径
$magickPath = "C:\Program Files\ImageMagick-7.1.1-016\magick.exe"

# 获取文件夹下所有文件
$files = Get-ChildItem -Path $folderPath -File

# 并行处理文件
$result = $files | ForEach-Object -Parallel {
    # 调用ImageMagick识别格式，将错误输出重定向到标准输出
    $output = & $using:magickPath identify -ping -quiet -format '%m' $_.FullName 2>&1

    # 返回文件路径和识别结果，供后续过滤
    [pscustomobject]@{
        Path   = $_.FullName
        Output = $output
    }
} -ThrottleLimit 8

# 筛选出非JPEG/PNG格式的文件
$unsupportedFiles = $result | Where-Object { $_.Output -notin 'JPEG', 'PNG' }

# 将结果写入输出文件
if ($unsupportedFiles.Count -gt 0) {
    $unsupportedFiles | Select-Object -ExpandProperty Path | Out-File -FilePath $outputFile
    Write-Host "不支持格式的文件列表已保存到 $outputFile。"
} else {
    Write-Host "未发现不支持格式的文件。"
}

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