PowerShell脚本接收管道输入时$Files.Length始终为1的问题排查

你的问题出在管道输入的处理逻辑以及PowerShell参数绑定的机制上，具体原因和解决方法如下：

问题原因 #

当你将ValueFromPipeline=$true设置在数组类型的参数上，但没有定义Process块时，PowerShell无法正确批量接收管道传递的多个对象：

• PowerShell的管道是逐个传递对象的，若脚本没有Process块，整个脚本只会在所有管道对象传递完成后执行一次（进入默认的End块逻辑）。
• 此时数组参数$Files并不会自动收集所有管道对象，反而只会绑定最后一个传递的对象，或者错误地将单个对象包装成长度为1的数组，导致$Files.Length始终返回1。
• 额外注意：FileInfo对象本身自带Length属性（表示文件大小），如果$Files是单个文件对象，容易混淆文件大小和数组长度，但你的示例中返回1，说明它是仅包含单个元素的数组。

解决方法 #

方法1：添加Process块处理管道对象 #

要正确处理管道传递的多个对象，必须定义Process块，PowerShell会为每个管道对象执行一次Process中的逻辑。如果需要统计总文件数，可以搭配Begin和End块：

using namespace System.IO

[CmdletBinding(SupportsShouldProcess)]
param
(
  [Parameter(Mandatory = $true, Position = 0, ValueFromPipeline = $true)][FileInfo[]]$Files
)

# 初始化计数器（可选，用于统计总数量）
begin {
    $totalFileCount = 0
}

# 逐个处理管道中的文件对象
process {
    $totalFileCount += $Files.Length
    $Files | Sort-Object | ForEach-Object {$_.Name}
}

# 输出总数量（可选）
end {
    Write-Host "`n总文件数：$totalFileCount"
}

方法2：直接传递数组参数 #

不通过管道传递，而是将Get-ChildItem的结果作为数组直接传入脚本的-Files参数，此时$Files会接收完整的文件数组，$Files.Length就是实际的文件总数：

.\Rename-Test.ps1 -Files (Get-ChildItem -File C:\Windows\)

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