Azure DevOps CLI
Gérez les ressources Azure DevOps en utilisant Azure CLI avec l'extension Azure DevOps.
Version CLI : 2.81.0 (à jour en 2025)
Prérequis
# Installer Azure CLI
brew install azure-cli # macOS
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash # Linux
# Installer l'extension Azure DevOps
az extension add --name azure-devops
Authentification
# Connexion avec token PAT
az devops login --organization https://dev.azure.com/{org} --token YOUR_PAT_TOKEN
# Définir l'organisation et le projet par défaut (évite de répéter --org/--project)
# Remarque : L'URL héritée https://{org}.visualstudio.com doit être remplacée par https://dev.azure.com/{org}
az devops configure --defaults organization=https://dev.azure.com/{org} project={project}
# Lister la configuration actuelle
az devops configure --list
Structure CLI
az devops # Commandes DevOps principales
├── admin # Administration (bannière)
├── extension # Gestion des extensions
├── project # Projets d'équipe
├── security # Opérations de sécurité
│ ├── group # Groupes de sécurité
│ └── permission # Permissions de sécurité
├── service-endpoint # Connexions de service
├── team # Équipes
├── user # Utilisateurs
├── wiki # Wikis
├── configure # Définir les valeurs par défaut
├── invoke # Appeler l'API REST
├── login # Authentifier
└── logout # Effacer les identifiants
az pipelines # Azure Pipelines
├── agent # Agents
├── build # Builds
├── folder # Dossiers de pipeline
├── pool # Pools d'agents
├── queue # Files d'attente d'agents
├── release # Releases
├── runs # Exécutions de pipeline
├── variable # Variables de pipeline
└── variable-group # Groupes de variables
az boards # Azure Boards
├── area # Chemins de zone
├── iteration # Itérations
└── work-item # Éléments de travail
az repos # Azure Repos
├── import # Imports Git
├── policy # Politiques de branche
├── pr # Demandes de tirage
└── ref # Références Git
az artifacts # Azure Artifacts
└── universal # Paquets universels
Fichiers de référence
Consultez le fichier de référence approprié en fonction de la tâche de l'utilisateur. Chaque fichier contient la syntaxe complète des commandes et des exemples pour son domaine.
| Fichier | Quand le consulter | Couvre |
|---|---|---|
references/repos-and-prs.md |
Repos, branches, demandes de tirage, politiques de branche | Dépôts, Import, PRs (création/liste/vote/relecteurs/politiques), Références Git, Politiques de branche |
references/pipelines-and-builds.md |
Pipelines, builds, releases, artefacts | CRUD des pipelines, exécutions, builds, releases, téléchargement/chargement d'artefacts |
references/boards-and-iterations.md |
Éléments de travail, sprints, chemins de zone | Éléments de travail (WIQL/création/mise à jour/relations), Chemins de zone, Itérations, Itérations d'équipe |
references/variables-and-agents.md |
Variables de pipeline, pools d'agents | Variables de pipeline, Groupes de variables, Dossiers de pipeline, Pools/files d'attente d'agents |
references/org-and-security.md |
Projets, équipes, utilisateurs, permissions, wikis | Projets, Extensions, Équipes, Utilisateurs, Groupes de sécurité/permissions, Connexions de service, Wikis, Admin |
references/advanced-usage.md |
Formatage de sortie, requêtes JMESPath | Formats de sortie, Requêtes JMESPath (basiques + avancées), Arguments globaux, Paramètres courants, Alias Git |
references/workflows-and-patterns.md |
Scripts d'automatisation, bonnes pratiques, gestion des erreurs | Workflows courants, Bonnes pratiques, Gestion des erreurs, Modèles de scripting, Exemples concrets |