是否存在自动化创建TFS 2018集合与项目的方法？

首先明确：TFS 2018确实支持通过API/代码自动化创建集合和项目，和Bitbucket的操作逻辑类似，只是接口和工具链不同。结合你使用Visual Studio 2017的场景，分享两种靠谱的实现方式：

一、使用TFS REST API #

TFS 2018的REST API已经覆盖了集合（Team Project Collection）和项目（Team Project）的创建操作，你可以通过HTTP请求直接调用。

1. 创建Team Project Collection #

集合的创建需要调用Collection Management API，注意这个操作需要TFS服务器级别的管理员权限。下面用PowerShell模拟请求（你也可以用C#、Python等语言实现）：

$tfsUrl = "http://your-tfs-server:8080/tfs"
$collectionName = "NewDemoCollection"
$apiVersion = "api-version=2.0"

$body = @{
    name = $collectionName
    description = "Automatically created collection via REST API"
} | ConvertTo-Json

Invoke-RestMethod -Uri "$tfsUrl/_apis/collectionmanagement/collections?$apiVersion" -Method Post -Body $body -ContentType "application/json" -UseDefaultCredentials

注意：这个操作是异步的，返回结果里会有一个operationId，你可以轮询 $tfsUrl/_apis/collectionmanagement/operations/{operationId}?$apiVersion 来获取创建状态。

2. 创建Team Project #

项目的创建需要调用Core API，需要集合级别的管理员权限。示例请求：

$collectionUrl = "http://your-tfs-server:8080/tfs/NewDemoCollection"
$projectName = "NewDemoProject"
$apiVersion = "api-version=2.0"

$body = @{
    name = $projectName
    description = "Automatically created project via REST API"
    capabilities = @{
        versioncontrol = @{
            sourceControlType = "Git" # 可选"TFVC"
        }
        processTemplate = @{
            templateTypeId = "6b724908-ef14-45cf-84f8-768b5384da45" # Scrum模板ID，可通过API获取其他模板ID
        }
    }
} | ConvertTo-Json

Invoke-RestMethod -Uri "$collectionUrl/_apis/projects?$apiVersion" -Method Post -Body $body -ContentType "application/json" -UseDefaultCredentials

同样，项目创建是异步操作，返回的operationId可用来轮询进度：$collectionUrl/_apis/operations/{operationId}?$apiVersion。

二、使用TFS .NET客户端库（适配Visual Studio 2017） #

如果你习惯用C#开发，可直接引用TFS客户端库，在VS2017里通过NuGet安装Microsoft.TeamFoundationServer.Client包（版本选15.x，匹配TFS2018）。

1. 创建Team Project Collection #

using Microsoft.TeamFoundation.Client;
using Microsoft.TeamFoundation.Framework.Client;
using Microsoft.TeamFoundation.Framework.Common;

var tfsUri = new Uri("http://your-tfs-server:8080/tfs");
var tfsServer = TfsConfigurationServerFactory.GetConfigurationServer(tfsUri);
tfsServer.EnsureAuthenticated();

var collectionService = tfsServer.GetService<ICollectionService>();
var collectionProperties = new TeamProjectCollectionProperties
{
    Name = "NewDemoCollection",
    Description = "Created via .NET client",
    // 可选：指定集合存储路径，默认用TFS服务器默认路径
    // StoragePath = @"D:\TFSData\Collections\NewDemoCollection"
};

// 异步创建集合并等待完成
var operation = collectionService.CreateCollection(collectionProperties);
operation.WaitForCompletion();

2. 创建Team Project #

using Microsoft.TeamFoundation.Core.WebApi;
using Microsoft.VisualStudio.Services.Common;
using Microsoft.VisualStudio.Services.WebApi;

var collectionUri = new Uri("http://your-tfs-server:8080/tfs/NewDemoCollection");
var connection = new VssConnection(collectionUri, new VssDefaultCredentials());
var projectClient = connection.GetClient<ProjectHttpClient>();

var projectCreateParams = new TeamProjectCreationParameters
{
    Name = "NewDemoProject",
    Description = "Created via .NET client",
    Capabilities = new Dictionary<string, Dictionary<string, string>>
    {
        ["versioncontrol"] = new Dictionary<string, string>
        {
            ["sourceControlType"] = "Git"
        },
        ["processTemplate"] = new Dictionary<string, string>
        {
            ["templateTypeId"] = "6b724908-ef14-45cf-84f8-768b5384da45" // Scrum模板ID
        }
    }
};

// 异步创建项目并等待完成
var createOperation = await projectClient.CreateProjectAsync(projectCreateParams);
await projectClient.WaitForProjectCreationAsync(createOperation.Id);

针对你之前方案无效的排查建议 #

• 权限不足：创建集合需要TFS服务器管理员权限，创建项目需要集合管理员权限，确保使用的账号具备对应权限。
• API版本不匹配：TFS2018对应REST API版本是2.0，不要使用3.0+（那是Azure DevOps Server版本）。
• 模板ID错误：指定的processTemplate ID无效会导致创建失败，可通过 $collectionUrl/_apis/process/templates?$apiVersion=2.0 获取所有可用模板ID。
• 未等待异步操作完成：集合和项目创建都是后台异步执行的，很多时候不是失败，只是还在运行，一定要轮询或等待操作结束。

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