Windows7 64位PowerShell连接MS SQL Server2012执行SQL脚本故障排查

我来帮你一步步排查这个PowerShell脚本连接远程SQL Server 2012的问题，先从你给出的代码里的明显问题和常见坑点说起：

1. 服务器名称格式错误 #

你当前定义的服务器地址是：

$Server= "\.\DB_HOST_NAME"

这个格式完全不对——.\\是用来指向本地SQL Server实例的语法，远程连接的话应该直接使用远程服务器的主机名、IP地址，或者带实例名的格式：

• 如果远程是默认实例：$Server = "DB_HOST_NAME"（或者对应的IP）
• 如果远程是命名实例：$Server = "DB_HOST_NAME\INSTANCE_NAME"

2. 不完整的SQL执行函数逻辑 #

你的ExecuteSqlQuery函数只写了开头，缺少完整的连接、执行、资源释放逻辑，这会导致脚本根本无法正常运行。下面是补全并加入错误处理的完整函数：

function ExecuteSqlQuery ($Server, $Database, $SQLQuery) {
    $Datatable = New-Object System.Data.DataTable
    try {
        # 构建连接字符串（这里用Windows身份验证，如需SQL验证可以修改）
        $ConnectionString = "Server=$Server;Database=$Database;Integrated Security=True;"
        $Connection = New-Object System.Data.SQLClient.SQLConnection($ConnectionString)
        $Command = New-Object System.Data.SQLClient.SQLCommand($SQLQuery, $Connection)
        $Adapter = New-Object System.Data.SQLClient.SQLDataAdapter($Command)
        
        $Connection.Open()
        $Adapter.Fill($Datatable)
    }
    catch {
        Write-Error "执行SQL查询出错：$_"
    }
    finally {
        # 确保连接关闭并释放资源
        if ($Connection.State -eq 'Open') {
            $Connection.Close()
        }
        $Connection.Dispose()
        $Command.Dispose()
        $Adapter.Dispose()
    }
    return $Datatable
}

3. 远程SQL Server的配置与权限检查 #

除了代码问题，还要确认远程SQL Server的基础配置：

• 启用远程连接：打开SQL Server配置管理器，找到目标实例的TCP/IP协议并启用，重启SQL Server服务生效。
• 防火墙放行：确保远程服务器的防火墙开放了SQL Server的端口（默认实例是1433，命名实例可能是动态端口，需要在配置管理器里查看）。
• 权限验证：执行脚本的Windows账号（或SQL账号，如果用SQL验证）必须拥有远程访问master数据库，以及读取[master].[sys].[some_table]的权限。

4. 64位PowerShell的驱动兼容性 #

Windows 7 64位的PowerShell默认使用64位的SQL Client组件，要确保你的系统安装了兼容SQL Server 2012的驱动——可以安装SQL Server 2012 Native Client，或者更新到最新的ODBC Driver for SQL Server。

修复后的完整脚本示例 #

# 正确配置远程服务器地址（根据实际情况修改）
$Server= "DB_HOST_NAME" # 或 "DB_HOST_NAME\INSTANCE_NAME"
$Database = "master"
$UserSqlQuery= "select count(*) from [master].[sys].[some_table]"

# 完整的SQL执行函数
function ExecuteSqlQuery ($Server, $Database, $SQLQuery) {
    $Datatable = New-Object System.Data.DataTable
    try {
        $ConnectionString = "Server=$Server;Database=$Database;Integrated Security=True;"
        $Connection = New-Object System.Data.SQLClient.SQLConnection($ConnectionString)
        $Command = New-Object System.Data.SQLClient.SQLCommand($SQLQuery, $Connection)
        $Adapter = New-Object System.Data.SQLClient.SQLDataAdapter($Command)
        
        $Connection.Open()
        $Adapter.Fill($Datatable)
    }
    catch {
        Write-Error "执行SQL查询出错：$_"
    }
    finally {
        if ($Connection.State -eq 'Open') {
            $Connection.Close()
        }
        $Connection.Dispose()
        $Command.Dispose()
        $Adapter.Dispose()
    }
    return $Datatable
}

# 调用函数并输出结果
$result = ExecuteSqlQuery -Server $Server -Database $Database -SQLQuery $UserSqlQuery
$result | Format-Table -AutoSize

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