PowerShell函数无法返回空DataTable问题求助

问题重现 #

给定PowerShell 7.2.5中的函数：

function Create-Container
(
    $SourceTable
)
{
    $datatable = [system.data.datatable]::new();
    $conn = [system.data.sqlclient.SqlConnection]::new("<connectionstring>");
    $da = [system.data.sqlclient.SqlDataAdapter]::new();
    $da.SelectCommand = [system.data.sqlclient.sqlcommand]::new(); 
    $da.SelectCommand.Connection = $conn;
    $da.selectcommand.CommandText = "<query>";
    $da.fill($datatable) | out-null;
    return $datatable;
}

执行以下代码尝试创建空DataTable时，$emptycontainer始终为null，但将代码直接放在主脚本中运行时结果符合预期：

$emptycontainer = Create-Container -SourceTable "sourcetable"

问题原因 #

PowerShell函数的返回机制和直接执行代码不同：函数会将所有未被抑制的输出都送入管道，而非仅return指定的内容。同时，当返回空集合类对象（比如无数据的DataTable）时，PowerShell默认会对其进行枚举，最终导致没有有效对象返回，表现为null。此外，$da.Fill() | Out-Null的抑制方式不够彻底，仍存在极小概率让返回值流入输出管道干扰结果。

解决方案 #

修改函数，确保仅返回目标DataTable对象，同时避免空对象被枚举拆解：

function Create-Container
(
    $SourceTable
)
{
    $datatable = [system.data.datatable]::new();
    $conn = [system.data.sqlclient.SqlConnection]::new("<connectionstring>");
    $da = [system.data.sqlclient.SqlDataAdapter]::new();
    $da.SelectCommand = [system.data.sqlclient.sqlcommand]::new(); 
    $da.SelectCommand.Connection = $conn;
    $da.selectcommand.CommandText = "<query>";
    # 用[void]直接抑制Fill方法的返回值，避免流入输出管道
    [void]$da.fill($datatable);
    # 用Write-Output -NoEnumerate确保完整返回DataTable对象，防止空对象被拆解
    Write-Output $datatable -NoEnumerate
}

关键修改点说明： #

1. 替换| Out-Null为[void]：[void]会直接丢弃.NET方法的返回值，比管道抑制更高效可靠，避免返回值意外流入输出管道。
2. 用Write-Output -NoEnumerate替代return：强制PowerShell返回完整的DataTable对象，即使对象内部无数据，也不会被枚举拆解为无输出。

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