Partager via


AzureCLI@1 - Tâche Azure CLI v1

Exécutez des commandes Azure CLI sur un abonnement Azure dans un script shell lors de l’exécution sur un agent Linux ou un script batch lors de l’exécution sur l’agent Windows.

Syntaxe

# Azure CLI v1
# Run Azure CLI commands against an Azure subscription in a Shell script when running on Linux agent or Batch script when running on Windows agent.
- task: AzureCLI@1
  inputs:
    azureSubscription: # string. Alias: connectedServiceNameARM. Required. Azure subscription. 
    scriptLocation: 'scriptPath' # 'inlineScript' | 'scriptPath'. Required. Script Location. Default: scriptPath.
    scriptPath: # string. Required when scriptLocation = scriptPath. Script Path. 
    #inlineScript: # string. Required when scriptLocation = inlineScript. Inline Script. 
    #arguments: # string. Alias: args. Arguments. 
  # Advanced
    #addSpnToEnvironment: false # boolean. Access service principal details in script. Default: false.
    #useGlobalConfig: false # boolean. Use global Azure CLI configuration. Default: false.
    #workingDirectory: # string. Alias: cwd. Working Directory. 
    #failOnStandardError: false # boolean. Fail on Standard Error. Default: false.

Entrées

azureSubscription - abonnement Azure
Alias d’entrée : connectedServiceNameARM. string. Obligatoire.

Sélectionne un abonnement Azure Resource Manager pour le déploiement.


scriptLocation - emplacement de script
string. Obligatoire. Valeurs autorisées : inlineScript (script inline), scriptPath (chemin de script). Valeur par défaut : scriptPath.

Sélectionne l’emplacement du script.


scriptPath - chemin d’accès de script
string. Obligatoire lorsque scriptLocation = scriptPath.

Chemin complet du script ou chemin d’accès relatif au répertoire de travail par défaut.


inlineScript - script inline
string. Obligatoire lorsque scriptLocation = inlineScript.

Vous pouvez écrire vos scripts en ligne ici. Lorsque vous utilisez l’agent Windows, utilisez le script par lots. Utilisez des scripts d’interpréteur de commandes lors de l’utilisation d’agents Linux. Pour les fichiers batch, utilisez le préfixe call avant chaque commande Azure. Vous pouvez également transmettre des variables prédéfinies et personnalisées à ce script à l’aide d’arguments

Voici des exemples : Le premier est un exemple d’interpréteur de commandes et le second est un exemple de lot :

azure --version || azure account show 
call  azure --version || call azure account show

arguments - arguments
Alias d’entrée : args. string.

Arguments passés au script.


détails du principal du service Access addSpnToEnvironment - dans les de script
boolean. Valeur par défaut : false.

Ajoute l’ID et la clé du principal de service du point de terminaison Azure que vous avez choisi dans l’environnement d’exécution du script. Vous pouvez utiliser les variables $servicePrincipalId et $servicePrincipalKey dans votre script.

Cela est respecté uniquement lorsque le point de terminaison Azure a le schéma d’authentification du principal de service.


useGlobalConfig - Utiliser la configuration globale d’Azure CLI
boolean. Valeur par défaut : false.

Si cette valeur est false, cette tâche utilise son propre répertoire de configuration Azure CLI distinct . Cela peut être utilisé pour exécuter des tâches Azure CLI dans versions de parallèles.


workingDirectory - répertoire de travail
Alias d’entrée : cwd. string.

Répertoire de travail actuel où le script est exécuté. Si elle est vide, cette entrée est la racine du référentiel (build) ou des artefacts (mise en production), qui est $(System.DefaultWorkingDirectory).


failOnStandardError - Échec sur les d’erreur standard
boolean. Valeur par défaut : false.

Si cette entrée est vraie, cette tâche échoue lorsque des erreurs sont écrites dans le flux StandardError. Décochez la case pour ignorer les erreurs standard et utilisez plutôt les codes de sortie pour déterminer l’état.


Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Remarques

Nouveautés de la version 1.0 :

  • Prend en charge la nouvelle interface de ligne de commande Azure 2.0 basée sur Python
  • Fonctionne avec des agents multiplateformes (Linux, macOS ou Windows)
  • Pour utiliser Azure CLI 1.0 (basé surnode.js), basculez vers la version de tâche 0.0
  • Limitations : - Aucune prise en charge des abonnements Azure Classic. Azure CLI 2.0 prend uniquement en charge les abonnements Azure Resource Manager (ARM).

Spécifications

Besoin Descriptif
Types de pipelines YAML, Build Classique, Version Classique
Exécutions sur Agent, DeploymentGroup
demandes Aucun
fonctionnalités de Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande N'importe quel
variables settables N'importe quel
Version de l’agent 2.0.0 ou version ultérieure
Catégorie de tâche Déployer