clemlesne / azure-devops-cli-extension

Azure DevOps Extension for Azure CLI

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

1. Install the Azure CLI. You must have at least v2.0.69, which you can verify with az --version command.

2. Add the Azure DevOps Extension az extension add --name azure-devops

3. Run the az login command.

   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.

TLDR of contribution guidelines

Questions : Stack Overflow
Bug reports : Developer Community
New Feature request : Azure DevOps repo

License

MIT License