PowerShell函数创建PSSession未返回对象，调用后变量为空的问题咨询

嘿，我之前也碰到过一模一样的情况！你的问题大概率是PowerShell的函数输出机制在搞鬼——默认情况下，函数会把所有未被捕获的命令结果都输出到管道，哪怕是你无意的输出，这就导致你想要的PSSession对象被其他内容干扰，甚至变量接收不到正确的值。

先搞清楚为什么会输出'00'且$s为空 #

你提到控制台输出了'00'，但$s是空的，这说明你的函数里肯定有某段代码输出了'00'（比如直接写了00没赋值给变量，或者某个命令的返回值是00且没被捕获），这段输出优先进入了管道，导致你预期的PSSession要么被掩盖，要么和'00'一起变成了数组，但你误以为$s是空的（或者只检查了数组的第一个元素）。

举个典型的反例，你的函数可能是这样的：

function newRemoteSession {
    param($computerName)
    # 这里无意输出了'00'，没被捕获
    00
    $session = New-PSSession -ComputerName $computerName -Credential (Get-Credential)
    return $session
}

这时候函数的输出是两个对象：00和$session。当你执行$s = newRemoteSession(192.168.1.10)，$s其实是一个包含两个元素的数组，但如果直接打印$s，可能只看到第一个元素'00'，误以为会话没返回。

修正函数，确保只返回PSSession #

要解决这个问题，核心是捕获所有不需要的输出，让函数只返回你想要的PSSession对象。下面是一个可靠的写法：

function New-RemoteSession {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory=$true)]
        [string]$ComputerName
    )

    # 捕获所有不需要的输出，比如赋值语句的结果或者调试信息
    # 用Write-Host的话其实不会进入管道，但用$null = 可以彻底避免意外输出
    $null = Write-Host "正在尝试连接远程主机：$ComputerName"

    # 获取凭据，赋值给变量避免意外输出
    $credential = Get-Credential -Message "请输入远程主机的登录凭据"

    try {
        # 创建会话，用ErrorAction Stop确保失败时抛出异常
        $session = New-PSSession -ComputerName $ComputerName -Credential $credential -ErrorAction Stop
        
        # 明确返回会话对象（或者直接让$session作为函数最后一行，PowerShell会自动返回）
        return $session
    }
    catch {
        # 捕获错误并提示，避免错误信息混入输出
        Write-Error "创建远程会话失败：$($_.Exception.Message)"
        # 失败时返回$null，方便调用方判断
        return $null
    }
}

正确调用并验证 #

调用的时候记得用标准的PowerShell参数格式（别用括号，这是新手常见的语法误区！）：

$s = New-RemoteSession -ComputerName "192.168.1.10"

# 验证会话是否创建成功
if ($s) {
    Write-Host "远程会话创建成功，会话ID：$($s.Id)"
} else {
    Write-Host "远程会话创建失败，请检查凭据或网络连接"
}

调试小技巧 #

如果还是有问题，可以用下面的命令查看函数的所有输出，定位额外内容的来源：

$allOutput = New-RemoteSession -ComputerName "192.168.1.10"
$allOutput | ForEach-Object {
    Write-Host "输出类型：$($_.GetType().Name)，内容：$_"
}

这样就能清楚看到函数到底返回了哪些对象，找到那个'00'的来源。

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