Condividi tramite

az pipelines variable

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione azure-devops per l'interfaccia della riga di comando di Azure (versione 2.30.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az pipelines variable. Altre informazioni sulle estensioni.

Gestire le variabili della pipeline.

Comandi

Nome Descrizione Tipo Status
az pipelines variable create

Aggiungere una variabile a una pipeline.

 Estensione GA
az pipelines variable delete

Eliminare una variabile dalla pipeline.

 Estensione GA
az pipelines variable list

Elencare le variabili in una pipeline.

 Estensione GA
az pipelines variable update

Aggiornare una variabile in una pipeline.

 Estensione GA

az pipelines variable create

Aggiungere una variabile a una pipeline.

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

Parametri necessari

--name

Nome della variabile.

Parametri facoltativi

--allow-override

Indica se il valore può essere impostato in fase di coda.

Valori accettati: false, true
--detect

Riconoscere automaticamente l'organizzazione.

Valori accettati: false, true
--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--pipeline-id

ID della pipeline.

--pipeline-name

Nome della pipeline. Ignorato se viene specificato il parametro --pipeline-id.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

--secret

Indica se il valore della variabile è un segreto.

Valori accettati: false, true
--value

Valore della variabile. Per le variabili segrete, se il parametro --value non viene specificato, verrà selezionato dalla variabile di ambiente preceduta da AZURE_DEVOPS_EXT_PIPELINE_VAR_ o all'utente verrà richiesto di immetterlo tramite input standard. Ad esempio, una variabile denominata MySecret può essere input usando la variabile di ambiente AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az pipelines variable delete

Eliminare una variabile dalla pipeline.

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

Parametri necessari

--name

Nome della variabile da eliminare.

Parametri facoltativi

--detect

Riconoscere automaticamente l'organizzazione.

Valori accettati: false, true
--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--pipeline-id

ID della pipeline.

--pipeline-name

Nome della pipeline.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

--yes -y

Non richiedere conferma.

Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az pipelines variable list

Elencare le variabili in una pipeline.

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

Parametri facoltativi

--detect

Riconoscere automaticamente l'organizzazione.

Valori accettati: false, true
--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--pipeline-id

ID della pipeline.

--pipeline-name

Nome della pipeline. Ignorato se viene specificato il parametro --pipeline-id.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az pipelines variable update

Aggiornare una variabile in una 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]

Parametri necessari

--name

Nome della variabile.

Parametri facoltativi

--allow-override

Indica se il valore può essere impostato in fase di coda.

Valori accettati: false, true
--detect

Riconoscere automaticamente l'organizzazione.

Valori accettati: false, true
--new-name

Nuovo nome della variabile.

--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--pipeline-id

ID della pipeline.

--pipeline-name

Nome della pipeline. Ignorato se viene specificato il parametro --pipeline-id.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

--prompt-value

Impostarla su True per aggiornare il valore di una variabile privata usando la variabile di ambiente o la richiesta tramite input standard.

Valori accettati: false, true
--secret

Se il valore della variabile è un segreto.

Valori accettati: false, true
--value

Nuovo valore della variabile. Per le variabili segrete, usare il parametro --prompt-value per richiederne l'immissione tramite input standard. Per le console non interattive, è possibile selezionare una variabile di ambiente preceduta da AZURE_DEVOPS_EXT_PIPELINE_VAR_, ad esempio una variabile denominata MySecret può essere immessa usando la variabile di ambiente AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.