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）