Azure Pipeline目标机器PowerShell无法连接SQL Server问题排查求助

1. 先补全错误日志，定位核心问题 #

当前日志信息不足，先在Copy-SQLTable的连接逻辑里加详细错误捕获，跑Pipeline拿到具体报错：

try {
    # 替换成你实际的连接代码
    $connectionString = "Data Source=你的源SQL实例;Initial Catalog=目标数据库;Integrated Security=True"
    $connection = New-Object System.Data.SqlClient.SqlConnection($connectionString)
    $connection.Open()
    Write-Host "SQL连接成功"
}
catch {
    Write-Host "=== 连接失败详情 ==="
    Write-Host "错误内容: $_"
    Write-Host "错误类型: $($_.Exception.GetType().FullName)"
    Write-Host "调用堆栈: $($_.ScriptStackTrace)"
    if ($_.Exception.InnerException) {
        Write-Host "内部错误: $($_.Exception.InnerException.Message)"
    }
}

拿到具体错误后，就能快速区分是权限、网络还是配置问题。

2. 身份验证权限排查 #

• 本地/其他服务器用的Windows集成身份，Azure Pipelines代理默认运行账户（比如NT AUTHORITY\NETWORK SERVICE或自托管代理的服务账户）大概率没被授权访问源SQL。
• 测试方法：在代理机器上用代理账户登录，手动跑脚本；或者临时改用SQL身份验证（账号密码）测试，排除权限问题。

3. 网络连通性验证 #

在代理机器上手动执行以下命令，确认网络通：

# 测试SQL端口（默认1433，命名实例需改对应端口）
Test-NetConnection -ComputerName "源SQL实例地址" -Port 1433
# 测试DNS解析是否正常
Resolve-DnsName "源SQL实例地址"

同时检查：

• 源SQL所在服务器的防火墙是否放行代理机器的IP和对应端口
• 代理机器的出站防火墙是否允许访问SQL端口
• 如果是Azure云环境，检查NSG规则是否限制了流量

4. SQL Server配置检查 #

• 确认源SQL Server已开启远程连接：打开SQL Server配置管理器，启用SQL Server网络配置里的TCP/IP协议
• 命名实例需确保SQL Server浏览器服务处于运行状态
• 检查SQL登录权限：把代理运行账户添加到SQL Server登录名，并且授予目标数据库的访问权限

5. Azure Pipelines代理环境差异核对 #

• 自托管代理：检查机器的.NET框架版本、SQL Server客户端组件（比如Native Client）是否和正常运行的环境一致，SqlClient依赖这些组件
• 托管代理：确认任务是否启用了Run as administrator，部分网络操作需要管理员权限
• 对比代理机器和正常环境的系统补丁、PowerShell版本，排除版本兼容问题

6. 连接字符串细节校验 #

把本地正常的连接字符串和Pipeline里的对比，重点看：

• 实例名是否正确（是否带域名、IP是否准确）
• 集成身份参数：Integrated Security=True和Trusted_Connection=True在部分环境下解析有差异，换着试
• 加密参数：如果源SQL要求加密，需加上Encrypt=True，反之则设为Encrypt=False

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