PowerShell循环、if条件中调用自定义函数异常问题求助

我写了一个验证字符串是否为字母数字的PowerShell函数，直接调用时能正常输出True/False，但在do-while循环、if条件判断、变量赋值这三种场景下调用却失效。

原函数代码 #

function checkAlphaNumerical {
    param (
        # 待验证的字符串，用于错误提示的描述文本
        $stringToValidate, $stringDesc
    )
    if ($stringToValidate -notmatch '^[a-z0-9]+$') {
        Write-Output ("Invalid $($stringDesc)")
        return $false
    }
    else {
        return $true
    }
}

直接调用checkAlphaNumerical $testinput "test"能正常返回布尔值，但以下三种场景调用失败：

# do-while循环场景
do {
    $testinput = Read-Host -Prompt "Enter string"
} while (!(checkAlphaNumerical $testinput "test"))

# if条件判断场景
if (checkAlphaNumerical $testinput "test") {
    # 执行逻辑
}

# 变量赋值场景
$someBool = checkAlphaNumerical $testinput "test"

问题原因 #

PowerShell函数的返回值是所有输出内容的集合，你的函数里用Write-Output输出了错误提示字符串，这会导致函数返回的不是单纯的布尔值，而是一个包含字符串和布尔值的数组。比如验证失败时，函数返回的是@("Invalid test", $false)，在条件判断或赋值时，这个数组会被PowerShell隐式处理，导致逻辑判断出错。

解决方法 #

把错误提示的Write-Output换成Write-Host（仅用于控制台显示信息，不会纳入函数返回值），这样函数只会返回布尔值：

修正后的函数：

function checkAlphaNumerical {
    param (
        $stringToValidate, $stringDesc
    )
    if ($stringToValidate -notmatch '^[a-z0-9]+$') {
        Write-Host "Invalid $stringDesc"
        return $false
    }
    else {
        return $true
    }
}

现在再测试之前的三个场景，就能正常执行：

• do-while循环会持续提示输入，直到输入符合要求
• if条件能正确根据验证结果执行对应逻辑
• $someBool会被正确赋值为$true或$false

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