如何用PowerShell脚本创建配置Version control及work Item Process的Azure DevOps项目

前置要求 #

执行脚本前先确认满足以下条件：

• 运行环境为 PowerShell 5.1 及以上版本
• 所用账号拥有目标 Azure DevOps 组织的项目创建权限
• 提前确认要使用的配置参数：
  • 版本控制可选值：Git（分布式版本控制，默认常用选项）、Tfvc（集中式版本控制）
  • 工作项流程可选系统内置值：Basic、Agile、Scrum、CMMI，也支持填写组织内提前创建的自定义流程名称

模块安装 #

首次使用先执行以下命令安装 Azure DevOps 官方 PowerShell 模块，已安装可直接跳过：

Install-Module -Name Az.DevOps -Scope CurrentUser -Force -AllowClobber

完整实现脚本 #

# -------------------------- 可自定义配置区 --------------------------
$orgUrl = "https://dev.azure.com/替换为你的组织名"
$projectName = "替换为要创建的项目名称"
$projectDesc = "替换为项目描述内容，可留空"
$vcType = "Git"                  # 版本控制类型，仅支持填Git或Tfvc
$processName = "Agile"           # 工作项流程名称，对应要使用的流程模板
# --------------------------------------------------------------------

# 身份认证，执行后会弹出交互窗口完成账号登录
Connect-AzDevOps -Organization $orgUrl

# 参数合法性校验
$targetProcess = Get-AzDevOpsProcess | Where-Object Name -eq $processName
if (-not $targetProcess) {
    Write-Error "错误：指定的工作项流程[$processName]不存在，请确认名称正确后重试"
    exit 1
}
if ($vcType -notin @("Git", "Tfvc")) {
    Write-Error "错误：版本控制类型仅支持Git或Tfvc，请修改配置后重试"
    exit 1
}

# 触发项目创建，等待配置完成
$project = New-AzDevOpsProject `
    -Name $projectName `
    -Description $projectDesc `
    -ProcessId $targetProcess.Id `
    -SourceControlType $vcType `
    -Wait

# 返回执行结果
if ($project.ProvisioningState -eq "Succeeded") {
    Write-Host "项目创建成功，访问地址：$($project.Url)" -ForegroundColor Green
} else {
    Write-Error "项目创建失败，当前状态：$($project.ProvisioningState)"
    exit 1
}

使用注意事项 #

• 执行前先修改脚本开头配置区的所有参数，和你的实际需求匹配
• 脚本自带参数校验逻辑，会提前检查流程是否存在、版本控制参数是否合法，避免无效创建请求
• 命令携带-Wait参数会阻塞等待项目完全初始化完成再返回结果，避免后续对接操作时项目未就绪报错
• 如果需要使用自定义工作项流程，提前在组织设置的流程管理页面创建完成后，在$processName里填写对应自定义流程的名称即可

小提示：如果是非交互场景（比如流水线里执行），可以把Connect-AzDevOps的身份认证逻辑替换为PAT认证，参数加上-PersonalAccessToken传入你的PAT令牌即可。

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