PowerShell函数异常打印内容被误作为返回值的解决方案咨询

这个问题其实是PowerShell函数返回机制的典型坑——我之前也踩过！

PowerShell函数的返回值默认会收集所有成功流（Stream 1）的输出，而在PowerShell 5.0之前，Write-Host是直接写入成功流的，所以你在catch块里打印的异常信息会和return指定的错误码一起被当作函数返回值返回。哪怕是PS5.0+，如果信息流被意外捕获，也可能出现这个问题。

下面是几个简洁的解决方案：

方案1：通用方法（兼容所有PS版本）：用[Console]::WriteLine()替代Write-Host #

直接将内容输出到控制台，完全绕过PowerShell的输出流，彻底避免输出混入返回值：

修改你的getSQLServerData函数中的catch块：

catch [System.Data.SqlClient.SqlException] {
    [Console]::WriteLine("SQL Error")
    [Console]::WriteLine("Exception: {0}", $_.Exception.Message)
    return 1
} catch [System.SystemException] {
    [Console]::WriteLine("Unknown error")
    [Console]::WriteLine("Exception: {0}", $_.Exception.Message)
    return 2
}

方案2：PowerShell 5.0+ 专用：用Write-Information替代Write-Host #

在PS5.0及以上版本，Write-Host本质是Write-Information的别名，它写入的信息流（Stream 6）默认不会被纳入函数返回值。你可以显式使用Write-Information并确保信息正常显示：

catch [System.Data.SqlClient.SqlException] {
    Write-Information "SQL Error" -InformationAction Continue
    Write-Information "Exception: {0}" -InformationAction Continue -MessageData $_.Exception.Message
    return 1
} catch [System.SystemException] {
    Write-Information "Unknown error" -InformationAction Continue
    Write-Information "Exception: {0}" -InformationAction Continue -MessageData $_.Exception.Message
    return 2
}

方案3：保留Write-Host的前提下重定向输出 #

如果你坚持要用Write-Host，可以把它的输出重定向到主机专用流，避免进入成功流：

catch [System.Data.SqlClient.SqlException] {
    Write-Host "SQL Error" *>&1
    Write-Host "Exception: {0}" $_.Exception.Message *>&1
    return 1
} catch [System.SystemException] {
    Write-Host "Unknown error" *>&1
    Write-Host "Exception: {0}" $_.Exception.Message *>&1
    return 2
}

不过这个方法在PS<5版本中可靠性不如方案1。

核心原则总结 #

要让函数只返回你指定的值，关键就是：不要让任何你不想返回的内容进入成功流。上面的方案都是通过将日志输出导向非成功流（或者直接绕过PowerShell流）来实现的。

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