azure-devops-cli

Azure DevOps CLI

Azure DevOps 拡張機能を備えた Azure CLI を使用して、Azure DevOps のリソースを管理します。

CLI バージョン: 2.81.0 (2025 年時点の最新)

前提条件

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

# Install Azure DevOps extension
az extension add --name azure-devops

認証

# Login with PAT token
az devops login --organization https://dev.azure.com/{org} --token YOUR_PAT_TOKEN

# Set default organization and project (avoids repeating --org/--project)
# Note: Legacy URL https://{org}.visualstudio.com should be replaced with https://dev.azure.com/{org}
az devops configure --defaults organization=https://dev.azure.com/{org} project={project}

# List current configuration
az devops configure --list

CLI の構造

az devops          # Main DevOps commands
├── admin          # Administration (banner)
├── extension      # Extension management
├── project        # Team projects
├── security       # Security operations
│   ├── group      # Security groups
│   └── permission # Security permissions
├── service-endpoint # Service connections
├── team           # Teams
├── user           # Users
├── wiki           # Wikis
├── configure      # Set defaults
├── invoke         # Invoke REST API
├── login          # Authenticate
└── logout         # Clear credentials

az pipelines       # Azure Pipelines
├── agent          # Agents
├── build          # Builds
├── folder         # Pipeline folders
├── pool           # Agent pools
├── queue          # Agent queues
├── release        # Releases
├── runs           # Pipeline runs
├── variable       # Pipeline variables
└── variable-group # Variable groups

az boards          # Azure Boards
├── area           # Area paths
├── iteration      # Iterations
└── work-item      # Work items

az repos           # Azure Repos
├── import         # Git imports
├── policy         # Branch policies
├── pr             # Pull requests
└── ref            # Git references

az artifacts       # Azure Artifacts
└── universal      # Universal Packages

リファレンスファイル

ユーザーのタスクに応じて、該当するリファレンスファイルを読んでください。各ファイルには、そのドメインの完全なコマンド構文と例が含まれています。

ファイル	読むタイミング	対象範囲
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 の値が失敗する場合	az.cmd に対する cmd.exe の 8191 文字制限、シェル検出、および検証済みの 3 つの回避策 (azps.ps1、ネイティブの --file-path、az devops invoke --in-file)