PowerShell连接SQL Server失败时如何强制生效连接超时设置

你的推测完全准确：

• Invoke-Sqlcmd 自带的 -ConnectionTimeout 参数，仅在TCP网络连接已经成功建立、等待SQL Server完成身份认证与协议握手的阶段生效
• 当网络层不可达（防火墙丢包、路由中断、实例离线）时，触发的是Windows系统TCP栈的默认连接超时，时长固定为30秒左右，这个参数完全无法干预该阶段的等待逻辑。

不要依赖SQL cmdlet自带的超时参数控制网络层等待时长，通过异步TCP连接检测+自定义超时的方式实现快速失败，逻辑无系统级副作用，同时适配SQL Server检测和所有通用TCP服务连通性检测。

SQL Server连通性检测完整实现 #

针对你的轮询场景，先做毫秒级自定义超时的TCP端口探测，端口连通后再执行SQL查询逻辑，代码如下：

while($true)
{
    $ClientDate = Get-Date
    $sqlInstance = "RemoteSQLInstance"
    $sqlPort = 1433 # 若为命名实例，可替换为实例绑定的固定端口，或提前通过SQL Browser服务解析对应端口
    $networkTimeoutMs = 1000 # 自定义网络层超时为1秒

    # 网络层连通性检测，绕开系统默认30秒TCP超时
    $tcpClient = New-Object System.Net.Sockets.TcpClient
    $connectTask = $tcpClient.ConnectAsync($sqlInstance, $sqlPort)
    $isTcpReachable = $connectTask.Wait($networkTimeoutMs)
    $tcpClient.Close()

    if (-not $isTcpReachable) {
        "Client = $ClientDate | Status = 网络中断，连接超时"
        Start-Sleep -Seconds 1
        continue
    }

    # TCP连通后再执行SQL查询，此时-ConnectionTimeout可正常控制SQL握手阶段超时
    try {
        $ServerDate = Invoke-Sqlcmd -Query "SELECT SYSDATETIME() AS [Time];" -ServerInstance $sqlInstance -ConnectionTimeout 1
        "Client = $ClientDate | Server = $($ServerDate.Time)"
    }
    catch {
        "Client = $ClientDate | Status = SQL服务异常：$($_.Exception.Message)"
    }

    Start-Sleep -Seconds 1
}

通用TCP服务快速超时实现 #

如果要检测任意远程TCP服务（HTTP、SSH、MySQL等）的连通性，直接复用上述逻辑里的TcpClient异步检测部分即可，可自由设置毫秒级超时，无需等待系统默认超时。

• 不建议通过修改Windows注册表的TCP默认超时参数实现需求，该修改会影响系统全局所有网络连接，副作用不可控
• 若使用SQL Server命名实例且未固定端口，可在脚本启动时先通过UDP 1434端口的SQL Browser协议查询实例对应的监听端口，避免端口探测失效

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