PowerShell函数在if语句中返回值异常问题排查

环境 #

$PSVersionTable.PSVersion

Major  Minor  Build  Revision
-----  -----  -----  --------
5      1      22621  4391    

相关代码片段 #

# 判断操作系统是否为Windows Server的函数
function Is-WindowsServer {
    $osVersion = (Get-WmiObject -Class Win32_OperatingSystem).Caption
    return $osVersion -like "*Server*"
}

# 检查SMB/网络共享是否已安装的函数
function Is-SMBInstalled {
    if (Is-WindowsServer) {
        Write-Output "Detected Windows Server. This should print."
        $smbFeature = Get-WindowsFeature -Name FS-SMB1 -ErrorAction SilentlyContinue
        if ($smbFeature -and $smbFeature.Installed) {
            return $true
        } else {
            return $false
        }
    } else {
        Write-Output "Detected Windows 10/11 client. This should print."
        $smbFeature = Get-WindowsOptionalFeature -Online -FeatureName "SMB1Protocol" -ErrorAction SilentlyContinue
        if ($smbFeature -and $smbFeature.State -eq "Enabled") {
            return $true
        } else {
            return $false
        }
    }
    Write-Output "This should be unreachable."
}

Is-SMBInstalled # 探测调用

if (Is-SMBInstalled -eq $true) {
    Write-Output "If above line is False. This should not print."
}

预期输出（SMB已禁用的Windows 10/11系统） #

Detected Windows 10/11 client. This should print.
False

实际输出 #

Detected Windows 10/11 client.
False
If above line is False. This should not print.

额外异常表现 #

单独运行以下代码时：

if (Is-SMBInstalled -eq $true) {
    Write-Output "If above line is False. This should not print."
}

Is-SMBInstalled函数未被正确调用；移除Is-SMBInstalled # probe后，仅输出If above line is False. This should not print.。尝试将函数调用存入变量，函数可正常执行但条件判断仍异常；使用分组调用if ((Is-SMBInstalled)) {也无法解决问题。

问题核心是函数返回了多个输出对象：Write-Output输出的字符串和最终的布尔值都会被PowerShell视为函数返回值的一部分，导致函数实际返回的是一个包含字符串和布尔值的数组，而非单一布尔值。当用数组和$true做比较时，PowerShell会将非空数组判定为$true，从而触发错误的条件分支。

修复方法：将函数中的Write-Output替换为Write-Host（仅在控制台输出，不进入返回值流），确保函数只返回布尔值。修改后的函数示例：

function Is-SMBInstalled {
    if (Is-WindowsServer) {
        Write-Host "Detected Windows Server. This should print."
        $smbFeature = Get-WindowsFeature -Name FS-SMB1 -ErrorAction SilentlyContinue
        return $smbFeature -and $smbFeature.Installed
    } else {
        Write-Host "Detected Windows 10/11 client. This should print."
        $smbFeature = Get-WindowsOptionalFeature -Online -FeatureName "SMB1Protocol" -ErrorAction SilentlyContinue
        return $smbFeature -and $smbFeature.State -eq "Enabled"
    }
}

修改后函数仅返回单一布尔值，条件判断即可正常工作。

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