df:az-cli

Azure DevOps CLI

Overview

Manage Azure DevOps resources using the az CLI with the azure-devops extension. Covers repositories, pull requests, pipelines, boards, and work items.

Prerequisites

# Install azure-devops extension (requires az cli 2.30+)
az extension add --name azure-devops

# Authenticate
az login

# Set defaults (recommended)
az devops configure --defaults organization=https://dev.azure.com/YOUR_ORG project=YOUR_PROJECT

Most-Used Commands

My Pull Requests

# List PRs I created
az repos pr list --creator "$(az account show --query user.name -o tsv)"

# List PRs assigned to me for review
az repos pr list --reviewer "$(az account show --query user.name -o tsv)"

# Show PR details
az repos pr show --id <pr-id>

# Checkout PR locally
az repos pr checkout --id <pr-id>

My Work Items

# List work items assigned to me
az boards query --wiql "SELECT [System.Id], [System.Title], [System.State] FROM WorkItems WHERE [System.AssignedTo] = @Me AND [System.State] <> 'Closed' ORDER BY [System.ChangedDate] DESC"

# Show work item details
az boards work-item show --id <work-item-id>

# Create work item
az boards work-item create --title "Task title" --type "Task"

# Update work item state
az boards work-item update --id <id> --state "In Progress"

Pipelines

# List pipelines
az pipelines list

# List recent runs
az pipelines runs list --top 10

# Run a pipeline
az pipelines run --name "pipeline-name"

# Run with parameters
az pipelines run --name "pipeline-name" --parameters "env=prod version=1.0"

# Show run details
az pipelines runs show --id <run-id>

Repositories

# List repositories
az repos list

# Show repo details
az repos show --repository <repo-name>

# Create repository
az repos create --name "new-repo"

Pull Request Workflow

# Create PR
az repos pr create --source-branch feature/my-branch --target-branch main --title "PR Title" --description "Description"

# Add reviewers
az repos pr update --id <pr-id> --reviewers [email protected]

# Set vote (approve: 10, approve with suggestions: 5, wait: -5, reject: -10)
az repos pr set-vote --id <pr-id> --vote 10

# Complete/merge PR
az repos pr update --id <pr-id> --status completed

References

Detailed command references available:

• references/repos.md - Repository management, PRs, policies, refs
• references/pipelines.md - Pipeline CRUD, runs, variables, releases
• references/boards.md - Work items, queries, areas, iterations
• references/devops.md - Organization, projects, teams, wikis, auth

Common Flags

Most commands support:

Flag	Description
--org	Organization URL (or set via az devops configure)
--project	Project name (or set via az devops configure)
--detect	Auto-detect org/project from git remote
-o json/table/tsv	Output format

Troubleshooting

# Check current config
az devops configure --list

# Verify authentication
az account show

# Check extension version
az extension show --name azure-devops