如何用PowerShell连接TFS？远程连接报错求助

针对你遇到的Invoke-RestMethod : Unable to connect to the remote server错误，从网络、认证、配置等维度给出排查和修复方案：

一、先排查基础网络连通性 #

• 测试服务器可达性：运行Test-Connection tfs.company.com，确认能收到响应。如果ping不通，联系IT确认网络权限或服务器状态。
• 测试TFS基础访问：执行Invoke-WebRequest -Uri http://tfs.company.com/tfs -UseBasicParsing，如果返回200状态码，说明服务器能正常访问；如果报错，检查防火墙、端口或服务器路径是否正确。

二、调整认证方式 #

TFS/Azure DevOps Server更推荐使用**个人访问令牌（PAT）**而非明文密码，尤其是当服务器禁用明文认证时：

使用PAT认证的脚本示例： #

# 替换为你的PAT令牌（需授予代码读取权限）
$pat = "your-personal-access-token"
$base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$($pat)"))

$uri = 'http://tfs.company.com/tfs/UEE/111470/_apis/git/repositories/E9u09e-3e27-4c18-9527-8600bb2b3441?api-version=4.1'

$invRestMethParams = @{
    Headers = @{Authorization = "Basic $base64AuthInfo"}
    Uri = $uri
    Method = 'Get'
    ContentType = 'application/json'
}
$project = Invoke-RestMethod @invRestMethParams
$project.value

如果坚持使用账号密码认证，可尝试使用当前用户凭据简化配置：

$invRestMethParams = @{
    UseDefaultCredentials = $true
    Uri = $uri
    Method = 'Get'
    ContentType = 'application/json'
}
$project = Invoke-RestMethod @invRestMethParams
$project.value

三、处理代理问题 #

如果你的公司网络使用代理服务器，需在请求中添加代理配置：

# 替换为公司代理地址
$proxyUri = "http://proxy.company.com:8080"

$invRestMethParams = @{
    Credential = $UserCredential
    Uri = $uri
    Method = 'Get'
    ContentType = 'application/json'
    Proxy = $proxyUri
    ProxyUseDefaultCredentials = $true
}

四、验证URI和API版本正确性 #

• 仓库ID校验：登录TFS网页，进入目标仓库，在「设置」→「仓库详情」中确认Repo ID是否与脚本中的一致。
• API版本匹配：TFS版本与API版本对应关系：
  • TFS 2017 → api-version=3.0
  • TFS 2018 → api-version=4.1
  • Azure DevOps Server 2019+ → api-version=5.0+
    如果你的TFS版本低于2018，使用api-version=4.1会导致请求失败。

五、调试获取详细错误信息 #

添加-Verbose参数或捕获异常，定位具体问题：

try {
    $project = Invoke-RestMethod @invRestMethParams -Verbose
    $project.value
} catch {
    Write-Host "错误详情: " $_.Exception.Message
    if ($_.Exception.Response) {
        Write-Host "响应状态码: " $_.Exception.Response.StatusCode.Value__
    }
}

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