az-devops
Manage Azure DevOps from the command line
TLDR
Set the Personal Access Token (PAT) to login to a particular organization
Open a project in the browser
List members of a specific team working on a particular project
Check the Azure DevOps CLI current configuration
Configure the Azure DevOps CLI behavior by setting a default project and a default organization
SYNOPSIS
az devops [COMMAND] [--org URL] [--detect] [--output FORMAT] [--query JMESPATH]
PARAMETERS
--debug
Increase logging verbosity to show all debug logs.
--help, -h
Show help message and exit.
--output, -o
Output format: json, jsonc, table, tsv, yaml, none.
--query
JMESPath query string. See http://jmespath.org/.
--subscription
Subscription name or ID. Set default with az account set -s NAME_OR_ID.
--verbose
Increase logging verbosity.
--org
Azure DevOps organization URL. Set default with az devops configure --defaults organization=URL.
--detect
Auto-detect organization.
DESCRIPTION
The az devops command group, part of the Azure CLI, provides a powerful command-line interface for managing Azure DevOps resources. It enables automation of workflows for projects, repositories, builds, releases, pipelines, work items, teams, service endpoints, and more.
Install the required extension with az extension add --name azure-devops, then update via az extension update --name azure-devops. Authenticate using az login. Set defaults like organization with az devops configure --defaults organization=https://dev.azure.com/{org} and project with --defaults project={project}.
Key uses include listing projects (az devops project list), creating Git repos (az devops git repository create), queuing builds (az devops build queue), and tracking work items (az devops work item list). It supports JSON output for scripting, JMESPath queries for filtering, and integration with CI/CD pipelines. Ideal for DevOps automation in Linux environments, bash scripts, or GitHub Actions.
While comprehensive, it complements the Azure DevOps web UI and requires appropriate organization permissions.
CAVEATS
Requires azure-devops CLI extension. Needs Azure DevOps permissions. Not all web UI features supported. Organization URL often mandatory unless configured.
INSTALLATION
az extension add --name azure-devops
az extension update --name azure-devops for latest version.
CONFIGURATION
az devops configure --defaults organization=https://dev.azure.com/{org}
az devops configure --defaults project={project-name}
az devops configure --list to view.
COMMON SUBCOMMANDS
project (manage projects), git (repositories), build (builds), work (work items), configure (defaults). Use az devops --help for full list.
HISTORY
Released as Azure CLI extension in April 2019. Evolved from early previews, with regular updates for new Azure DevOps features like YAML pipelines and multi-stage support.


