如何让PowerShell函数单独调用时仅执行打印不显示返回值

你的核心需求是让函数在直接调用时仅执行打印操作，被赋值/捕获调用时返回指定值。问题根源在于PowerShell函数默认会将所有未被捕获的输出（包括return语句的内容）作为返回结果，直接调用时这些结果会被打印到控制台。

以下是两种可行的解决方法：

方法一：通过调用行判断（简单场景适用） #

检查函数调用语句中是否包含赋值操作，以此决定是否返回值：

FUNCTION TEST1
{
    $x = "1","2","3"

    for ($i=0; $i -lt $x.length; $i++)
    {
        Write-Host "This is " $x[$i]
    }

    # 判断是否为直接调用（无赋值/捕获）
    if (-not $MyInvocation.Line.Contains('=')) {
        $x | Out-Null
    }
    else {
        return $x
    }
}

• 直接调用TEST1：仅输出打印内容，返回值被抑制
• 赋值调用$result = TEST1：$result会获取到数组"1","2","3"

方法二：使用CmdletBinding精确判断（覆盖更多场景） #

通过[CmdletBinding()]修饰函数，利用$PSCmdlet变量判断调用场景，支持管道调用等更多情况：

FUNCTION TEST1
{
    [CmdletBinding()]
    param()

    $x = "1","2","3"

    for ($i=0; $i -lt $x.length; $i++)
    {
        Write-Host "This is " $x[$i]
    }

    # 检查是否为直接控制台调用且未指定输出变量
    if ($PSCmdlet.MyInvocation.CommandOrigin -eq 'Runspace' -and -not $PSCmdlet.MyInvocation.BoundParameters.ContainsKey('OutVariable')) {
        $x | Out-Null
    }
    else {
        return $x
    }
}

这种方法能识别更多调用场景，比如TEST1 | Out-File output.txt时会正常返回值写入文件，直接调用时则抑制返回值。

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