az pipelines variable

  • Référence

Remarque

Cette référence fait partie de l’extension azure-devops pour Azure CLI (version 2.30.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande de variable az pipelines. En savoir plus sur les extensions.

Gérer les variables de pipeline.

Commandes

Nom Description Type Statut
az pipelines variable create

Ajoutez une variable à un pipeline.

 Extension GA
az pipelines variable delete

Supprimez une variable du pipeline.

 Extension GA
az pipelines variable list

Répertoriez les variables dans un pipeline.

 Extension GA
az pipelines variable update

Mettez à jour une variable dans un pipeline.

 Extension GA

az pipelines variable create

Ajoutez une variable à un pipeline.

az pipelines variable create --name
                             [--allow-override {false, true}]
                             [--detect {false, true}]
                             [--org]
                             [--pipeline-id]
                             [--pipeline-name]
                             [--project]
                             [--secret {false, true}]
                             [--value]

Paramètres obligatoires

--name

Nom de la variable.

Paramètres facultatifs

--allow-override

Indique si la valeur peut être définie au moment de la file d’attente.

valeurs acceptées: false, true
--detect

Détectez automatiquement l’organisation.

valeurs acceptées: false, true
--org --organization

URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--pipeline-id

ID du pipeline.

--pipeline-name

Nom du pipeline. Ignoré si le paramètre --pipeline-id est fourni.

--project -p

Nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide de az devops configure -d project=NAME_OR_ID. Obligatoire s’il n’est pas configuré par défaut ou récupéré via la configuration git.

--secret

Indique si la valeur de la variable est un secret.

valeurs acceptées: false, true
--value

Valeur de la variable. Pour les variables secrètes, si le paramètre --value n’est pas donné, il est sélectionné dans la variable d’environnement précédée de AZURE_DEVOPS_EXT_PIPELINE_VAR_ ou l’utilisateur est invité à l’entrer via une entrée standard. Par exemple, une variable nommée MySecret peut être entrée à l’aide d’une variable d’environnement AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az pipelines variable delete

Supprimez une variable du pipeline.

az pipelines variable delete --name
                             [--detect {false, true}]
                             [--org]
                             [--pipeline-id]
                             [--pipeline-name]
                             [--project]
                             [--yes]

Paramètres obligatoires

--name

Nom de la variable à supprimer.

Paramètres facultatifs

--detect

Détectez automatiquement l’organisation.

valeurs acceptées: false, true
--org --organization

URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--pipeline-id

ID du pipeline.

--pipeline-name

Nom du pipeline.

--project -p

Nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide de az devops configure -d project=NAME_OR_ID. Obligatoire s’il n’est pas configuré par défaut ou récupéré via la configuration git.

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az pipelines variable list

Répertoriez les variables dans un pipeline.

az pipelines variable list [--detect {false, true}]
                           [--org]
                           [--pipeline-id]
                           [--pipeline-name]
                           [--project]

Paramètres facultatifs

--detect

Détectez automatiquement l’organisation.

valeurs acceptées: false, true
--org --organization

URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--pipeline-id

ID du pipeline.

--pipeline-name

Nom du pipeline. Ignoré si le paramètre --pipeline-id est fourni.

--project -p

Nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide de az devops configure -d project=NAME_OR_ID. Obligatoire s’il n’est pas configuré par défaut ou récupéré via la configuration git.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az pipelines variable update

Mettez à jour une variable dans un pipeline.

az pipelines variable update --name
                             [--allow-override {false, true}]
                             [--detect {false, true}]
                             [--new-name]
                             [--org]
                             [--pipeline-id]
                             [--pipeline-name]
                             [--project]
                             [--prompt-value {false, true}]
                             [--secret {false, true}]
                             [--value]

Paramètres obligatoires

--name

Nom de la variable.

Paramètres facultatifs

--allow-override

Indique si la valeur peut être définie au moment de la file d’attente.

valeurs acceptées: false, true
--detect

Détectez automatiquement l’organisation.

valeurs acceptées: false, true
--new-name

Nouveau nom de la variable.

--org --organization

URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--pipeline-id

ID du pipeline.

--pipeline-name

Nom du pipeline. Ignoré si le paramètre --pipeline-id est fourni.

--project -p

Nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide de az devops configure -d project=NAME_OR_ID. Obligatoire s’il n’est pas configuré par défaut ou récupéré via la configuration git.

--prompt-value

Définissez-la sur True pour mettre à jour la valeur d’une variable secrète à l’aide de la variable d’environnement ou de l’invite via une entrée standard.

valeurs acceptées: false, true
--secret

Si la valeur de la variable est un secret.

valeurs acceptées: false, true
--value

Nouvelle valeur de la variable. Pour les variables secrètes, utilisez le paramètre --prompt-value pour être invité à l’entrer via une entrée standard. Pour les consoles non interactives, il peut être choisi à partir d’une variable d’environnement précédée de AZURE_DEVOPS_EXT_PIPELINE_VAR_, par exemple, une variable nommée MySecret peut être entrée à l’aide de la variable d’environnement AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.