PowerShell中Get-ChildItem无结果时管道参数绑定空值报错问题

问题描述 #

从目录读取文件列表时，通过Select-Object、Sort-Object序列调用提取单个属性后传入管道，当Get-ChildItem未检索到任何文件时，会报错：Cannot bind argument to parameter 'File' because it is null.

最小可复现示例（MRE）：

function Test
{
  [CmdletBinding()]
  param
  (
    [Parameter(Mandatory = $true, Position = 0, ValueFromPipeline = $true)]$File
  )
  process { }
}

$arr = (Get-ChildItem -Filter '*.xxxx' |
    Select-Object -Property 'Name',
    @{
      name = 'FileObject'
      expression = { $_ }
    } |
    Sort-Object -Property 'Name').FileObject

$arr | Test

注：示例仅用于复现问题，无需关注Select-Object表达式的具体意义。

移除.FileObject后，直接返回Sort-Object的结果时运行正常。疑问在于两种情况中$arr -eq $null均为$true，为何行为不同？如何在严格模式下保留FileObject作为返回类型并正常运行？

原因解析 #

核心差异源于PowerShell的成员访问枚举行为：

• 当对空集合（如Get-ChildItem无结果返回的空数组）直接返回时，$arr是一个空的System.Object[]数组。管道传递空数组时，不会向Test函数传递任何元素，因此不会触发参数绑定的强制检查，函数正常执行（process块不运行）。
• 当对空集合访问.FileObject属性时，PowerShell的成员访问枚举会遍历集合中的每个元素提取属性，但空集合没有元素，最终返回的是$null而非空数组。此时$arr为$null，管道传递时会将$null作为参数传给Test，而File参数是强制必填的，因此触发绑定错误。

解决方案 #

方法一：用ForEach-Object提取属性 #

通过ForEach-Object遍历元素提取属性，空输入时会返回空数组：

$arr = Get-ChildItem -Filter '*.xxxx' |
    Select-Object -Property 'Name',
    @{
      name = 'FileObject'
      expression = { $_ }
    } |
    Sort-Object -Property 'Name' |
    ForEach-Object { $_.FileObject }

$arr | Test

解释：ForEach-Object仅在有输入元素时执行提取操作，空输入时无输出，最终$arr为空数组，管道传递时不会触发参数绑定错误。

方法二：使用Select-Object -ExpandProperty替代直接属性访问 #

Select-Object -ExpandProperty处理空输入时返回空数组，而非$null：

$arr = Get-ChildItem -Filter '*.xxxx' |
    Select-Object -Property 'Name',
    @{
      name = 'FileObject'
      expression = { $_ }
    } |
    Sort-Object -Property 'Name' |
    Select-Object -ExpandProperty FileObject

$arr | Test

解释：-ExpandProperty专门用于提取属性值，空输入场景下会返回空数组，确保$arr始终为数组类型，避免传递$null到管道。

方法三：强制数组并过滤空值 #

用@()将结果转为数组后过滤掉$null：

$arr = @((Get-ChildItem -Filter '*.xxxx' |
    Select-Object -Property 'Name',
    @{
      name = 'FileObject'
      expression = { $_ }
    } |
    Sort-Object -Property 'Name').FileObject) | Where-Object { $_ -ne $null }

$arr | Test

解释：@()将成员访问的结果（可能为$null）转为数组，再通过Where-Object过滤掉空值，确保最终$arr为空数组或有效元素数组。

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