LinuxCommandLibrary

az-devops

Manage Azure DevOps from the command line

TLDR

Set the Personal Access Token (PAT) to login to a particular organization

$ az devops login [[--org|--organization]] [organization_url]
copy

Open a project in the browser
$ az devops project show [[-p|--project]] [project_name] --open
copy

List members of a specific team working on a particular project
$ az devops team list-member [[-p|--project]] [project_name] --team [team_name]
copy

Check the Azure DevOps CLI current configuration
$ az devops configure [[-l|--list]]
copy

Configure the Azure DevOps CLI behavior by setting a default project and a default organization
$ az devops configure [[-d|--defaults]] project=[project_name] organization=[organization_url]
copy

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.

SEE ALSO

az(1), git(1), curl(1)

Copied to clipboard