Azure DevOps Extension for Azure CLI
The Azure DevOps Extension for Azure CLI adds Pipelines, Boards, Repos, Artifacts and DevOps commands to the Azure CLI 2.0.
The Azure CLI with the Azure DevOps Extension has replaced the VSTS CLI. The VSTS CLI has been deprecated and will no longer be receiving new features. We recommend that users of the VSTS CLI switch to the Azure CLI and add the Azure DevOps extension. See the Command Mapping section to view the mapping between VSTS CLI and Azure DevOps Extension commands.
Quick start
-
Install the Azure CLI. You must have at least
v2.0.69, which you can verify withaz --versioncommand. -
Add the Azure DevOps Extension
az extension add --name azure-devops -
Run the
az logincommand.If the CLI can open your default browser, it will do so and load a sign-in page. Otherwise, you need to open a
browser page and follow the instructions on the command line to enter an authorization code after navigating to
https://aka.ms/devicelogin in your browser. For more information, see the
Azure CLI login page.
See the Get started guide for detailed setup instructions.
Usage
$az [group] [subgroup] [command] {parameters}
Adding the Azure DevOps Extension adds devops, pipelines, artifacts, boards and repos groups.
For usage and help content for any command, pass in the -h parameter, for example:
$ az devops -h
Group
az devops : Manage Azure DevOps organization level operations.
Related Groups
az pipelines: Manage Azure Pipelines
az boards: Manage Azure Boards
az repos: Manage Azure Repos
az artifacts: Manage Azure Artifacts.
Subgroups:
admin : Manage administration operations.
extension : Manage extensions.
project : Manage team projects.
security : Manage security related operations.
service-endpoint : Manage service endpoints/service connections.
team : Manage teams.
user : Manage users.
wiki : Manage wikis.
Commands:
configure : Configure the Azure DevOps CLI or view your configuration.
feedback : Displays information on how to provide feedback to the Azure DevOps CLI team.
invoke : This command will invoke request for any DevOps area and resource. Please use
only json output as the response of this command is not fixed. Helpful docs -
https://docs.microsoft.com/en-us/rest/api/azure/devops/.
login : Set the credential (PAT) to use for a particular organization.
logout : Clear the credential for all or a particular organization.
- Checkout the CLI docs at docs.microsoft.com - Azure DevOps CLI.
- Check out other examples in the How-to guides section.
- You can view the various commands and its usage here - docs.microsoft.com - Azure DevOps Extension Reference
Contribute
See our contribution guidelines to learn how you can contribute to this project.