azure-devops-cli

Azure DevOps CLI

使用Azure CLI和Azure DevOps扩展管理Azure DevOps资源。

CLI版本： 2.81.0（截至2025年）

先决条件

# 安装Azure CLI
brew install azure-cli  # macOS
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash  # Linux

# 安装Azure DevOps扩展
az extension add --name azure-devops

身份验证

# 使用PAT令牌登录
az devops login --organization https://dev.azure.com/{org} --token YOUR_PAT_TOKEN

# 设置默认组织和项目（避免重复指定--org/--project）
# 注意：旧版URL https://{org}.visualstudio.com 应替换为 https://dev.azure.com/{org}
az devops configure --defaults organization=https://dev.azure.com/{org} project={project}

# 列出当前配置
az devops configure --list

CLI结构

az devops          # 主要DevOps命令
├── admin          # 管理（横幅）
├── extension      # 扩展管理
├── project        # 团队项目
├── security       # 安全操作
│   ├── group      # 安全组
│   └── permission # 安全权限
├── service-endpoint # 服务连接
├── team           # 团队
├── user           # 用户
├── wiki           # Wiki
├── configure      # 设置默认值
├── invoke         # 调用REST API
├── login          # 身份验证
└── logout         # 清除凭据

az pipelines       # Azure Pipelines
├── agent          # 代理
├── build          # 构建
├── folder         # 流水线文件夹
├── pool           # 代理池
├── queue          # 代理队列
├── release        # 发布
├── runs           # 流水线运行
├── variable       # 流水线变量
└── variable-group # 变量组

az boards          # Azure Boards
├── area           # 区域路径
├── iteration      # 迭代
└── work-item      # 工作项

az repos           # Azure Repos
├── import         # Git导入
├── policy         # 分支策略
├── pr             # 拉取请求
└── ref            # Git引用

az artifacts       # Azure Artifacts
└── universal      # 通用包

参考文件

根据用户任务阅读相应的参考文件。每个文件包含其领域的完整命令语法和示例。

文件	何时阅读	涵盖内容
references/repos-and-prs.md	仓库、分支、拉取请求、分支策略	仓库、导入、PR（创建/列出/投票/审阅者/策略）、Git引用、分支策略
references/pipelines-and-builds.md	流水线、构建、发布、制品	流水线CRUD、运行、构建、发布、制品下载/上传
references/boards-and-iterations.md	工作项、冲刺、区域路径	工作项（WIQL/创建/更新/关系）、区域路径、迭代、团队迭代
references/variables-and-agents.md	流水线变量、代理池	流水线变量、变量组、流水线文件夹、代理池/队列
references/org-and-security.md	项目、团队、用户、权限、Wiki	项目、扩展、团队、用户、安全组/权限、服务终结点、Wiki、管理
references/advanced-usage.md	输出格式化、JMESPath查询	输出格式、JMESPath查询（基础+高级）、全局参数、常用参数、Git别名
references/workflows-and-patterns.md	自动化脚本、最佳实践、错误处理	常见工作流、最佳实践、错误处理、脚本模式、实际示例
references/long-comments-on-windows.md	在Windows上长--discussion、--description或--content值失败	cmd.exe对az.cmd的8191字符限制、shell检测以及三种已验证的解决方法（azps.ps1、原生--file-path、az devops invoke --in-file）