Partager via


Prise en main d’Azure DevOps CLI

Azure DevOps Services

Avec l’extension Azure DevOps pour l’interface de ligne de commande (CLI), vous pouvez gérer de nombreux services Azure DevOps à partir de la ligne de commande. Les commandes CLI vous permettent de rationaliser vos tâches avec un canevas interactif plus rapide et flexible, en contournant les workflows d’interface utilisateur.

Remarque

L’interface de ligne de commande Azure DevOps (CLI) est disponible uniquement pour une utilisation avec Azure DevOps Services. L’extension Azure DevOps pour Azure CLI ne prend pas en charge une version d’Azure DevOps Server.

Pour commencer à utiliser l’extension Azure DevOps pour Azure CLI, procédez comme suit :

  1. Installez Azure CLI : suivez les instructions fournies dans Installer Azure CLI pour configurer votre environnement Azure CLI. Au minimum, votre version d’Azure CLI doit être 2.10.1. Vous pouvez l’utiliser az --version pour valider.

  2. Ajoutez l’extension Azure DevOps :

     az extension add --name azure-devops
    

    Vous pouvez utiliser az extension list ou az extension show --name azure-devops confirmer l’installation.

  3. Connectez-vous : Exécutez az login pour vous connecter. Notez que nous prenons en charge uniquement les informations interactives ou de connexion à l’aide du nom d’utilisateur et du mot de passe avec az login. Pour vous connecter à l’aide d’un jeton d’accès personnel (PAT), consultez Se connecter via azure DevOps Personal Access Token (PAT) .

Remarque

L’extension Azure DevOps ne prend actuellement pas en charge l’authentification auprès des identités managées.

  1. Configurer les valeurs par défaut : nous vous recommandons de définir la configuration par défaut pour votre organisation et votre projet. Sinon, vous pouvez les définir dans les commandes individuelles elles-mêmes.

     az devops configure --defaults organization=https://dev.azure.com/contoso project=ContosoWebApp
    

Utilisation de commande

L’ajout de l’extension Azure DevOps ajoute devops, pipelines, artifacts, boardset repos des groupes. Pour l’utilisation et le contenu d’aide pour n’importe quelle commande, entrez le paramètre -h , par exemple :

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://learn.microsoft.com/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.

Ouvrir des éléments dans le navigateur

Vous pouvez utiliser --open le commutateur pour ouvrir n’importe quel artefact dans le portail Azure DevOps dans votre navigateur par défaut.

Par exemple :

az pipelines build show --id 1 --open

Cette commande affiche les détails de la génération avec id 1 la ligne de commande et l’ouvre également dans le navigateur par défaut.