az pipelines variable

Note

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 variable az pipelines commande. Apprenez-en davantage sur les extensions.

Gérer les variables de pipeline.

Commandes

Nom	Description	Type	État
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 --organization]
                             [--pipeline-id]
                             [--pipeline-name]
                             [--project]
                             [--secret {false, true}]
                             [--value]

Paramètres obligatoires

--name

Nom de la variable.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--allow-override

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

Propriété	Valeur
Valeurs acceptées:	false, true

--detect

Détectez automatiquement l’organisation.

Propriété	Valeur
Valeurs acceptées:	false, true

--org --organization

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. 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 si ce paramètre n’est pas configuré par défaut ou récupéré avec git config.

--secret

Indique si la valeur de la variable est un secret.

Propriété	Valeur
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 de la variable d’environnement AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

az pipelines variable delete

Supprimez une variable du pipeline.

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

Paramètres obligatoires

--name

Nom de la variable à supprimer.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--detect

Détectez automatiquement l’organisation.

Propriété	Valeur
Valeurs acceptées:	false, true

--org --organization

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. 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 si ce paramètre n’est pas configuré par défaut ou récupéré avec git config.

--yes -y

N’invitez pas à confirmer.

Propriété	Valeur
Valeur par défaut:	False

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

az pipelines variable list

Répertoriez les variables dans un pipeline.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--detect

Détectez automatiquement l’organisation.

Propriété	Valeur
Valeurs acceptées:	false, true

--org --organization

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. 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 si ce paramètre n’est pas configuré par défaut ou récupéré avec git config.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

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 --organization]
                             [--pipeline-id]
                             [--pipeline-name]
                             [--project]
                             [--prompt-value {false, true}]
                             [--secret {false, true}]
                             [--value]

Paramètres obligatoires

--name

Nom de la variable.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--allow-override

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

Propriété	Valeur
Valeurs acceptées:	false, true

--detect

Détectez automatiquement l’organisation.

Propriété	Valeur
Valeurs acceptées:	false, true

--new-name

Nouveau nom de la variable.

--org --organization

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. 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 si ce paramètre n’est pas configuré par défaut ou récupéré avec git config.

--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.

Propriété	Valeur
Valeurs acceptées:	false, true

--secret

Si la valeur de la variable est un secret.

Propriété	Valeur
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 AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret de variable d’environnement.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Format de sortie.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False