这个问题的核心是PowerShell的自动枚举（输出拆包）行为，这是PowerShell处理集合类型输出时的默认机制，在PowerShell 5.0中表现得尤为明显。

为什么会出现异常？ #

PowerShell会自动枚举任何实现了IEnumerable接口的对象（字符串和字节数组除外）——也就是说，当你返回一个集合（比如ArrayList）时，PowerShell不会直接返回集合本身，而是会把集合里的元素逐个输出：

• 当ArrayList为空时：没有元素可枚举，PowerShell返回空的ArrayList对象，调用方强制转换为ArrayList自然没问题。
• 当ArrayList有多个元素时：PowerShell枚举所有元素，返回一个包含这些元素的数组，而数组可以被正常转换为ArrayList，所以逻辑运行正常。
• 当ArrayList只有一个元素时：PowerShell只枚举并返回这个单个元素（也就是你的PSCustomObject），调用方试图把这个单个对象转换为ArrayList，就会触发类型转换异常。

为什么添加$Files.getType()后就不报错了？ #

$Files.getType()会输出一个System.Type对象，之后return $Files会让PowerShell继续枚举ArrayList的单个元素。这时候函数的返回值是一个包含两个元素的数组：Type对象和你的PSCustomObject。调用方把这个数组转换为ArrayList时，数组可以被正常转换为ArrayList，所以不会报错——但要注意，这时候$OldFiles里会包含额外的Type对象，并不是你原本想要的仅包含文件属性的ArrayList，这只是一个“不报错”的临时 workaround，并不是正确的解决方案。

正确的解决方案 #

以下几种方法可以彻底解决这个问题：

方法1：用Write-Output -NoEnumerate强制返回整个集合

在子函数中，使用Write-Output -NoEnumerate代替直接return，这样可以强制PowerShell不枚举集合，直接返回完整的ArrayList对象：

$Files = [System.Collections.ArrayList]@()
$Files.Add($Obj) > $null
Write-Output -NoEnumerate $Files

调用方代码不需要修改，因为现在函数返回的是真正的ArrayList对象，强制转换可以正常工作：

$OldFiles = [System.Collections.ArrayList](Check-OldFiles -Path $Directory -Age $Age -FilesOnly:$FilesOnly -Recurse:$Recurse -UserCreationTime:$UserCreationTime)

方法2：用逗号运算符包装集合避免拆包

在子函数中，用逗号运算符将ArrayList包装成一个单元素数组，PowerShell会返回这个数组而不会枚举内部的ArrayList元素：

$Files = [System.Collections.ArrayList]@()
$Files.Add($Obj) > $null
return ,$Files

调用方需要取数组的第一个元素来获取原本的ArrayList：

# 直接获取ArrayList，无需强制转换
$OldFiles = (Check-OldFiles -Path $Directory -Age $Age -FilesOnly:$FilesOnly -Recurse:$Recurse -UserCreationTime:$UserCreationTime)[0]

方法3：在调用方兼容不同返回类型

如果你不想修改子函数，可以在调用方先接收返回值，再根据类型处理：

$result = Check-OldFiles -Path $Directory -Age $Age -FilesOnly:$FilesOnly -Recurse:$Recurse -UserCreationTime:$UserCreationTime
$OldFiles = [System.Collections.ArrayList]@()

if ($result -is [System.Collections.ArrayList]) {
    $OldFiles.AddRange($result)
} elseif ($result -ne $null) {
    # 处理单个对象的情况
    $OldFiles.Add($result) > $null
}

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