Freigeben über

az pipelines variable

  • Referenz

Hinweis

Diese Referenz ist Teil der Azure-devops-Erweiterung für die Azure CLI (Version 2.30.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az pipelines-Variablenbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten von Pipelinevariablen.

Befehle

Name Beschreibung Typ Status
az pipelines variable create

Fügen Sie einer Pipeline eine Variable hinzu.

 Durchwahl Allgemein verfügbar
az pipelines variable delete

Löschen sie eine Variable aus der Pipeline.

 Durchwahl Allgemein verfügbar
az pipelines variable list

Listen Sie die Variablen in einer Pipeline auf.

 Durchwahl Allgemein verfügbar
az pipelines variable update

Aktualisieren sie eine Variable in einer Pipeline.

 Durchwahl Allgemein verfügbar

az pipelines variable create

Fügen Sie einer Pipeline eine Variable hinzu.

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

Erforderliche Parameter

--name

Name der Variable.

Optionale Parameter

--allow-override

Gibt an, ob der Wert zur Warteschlangenzeit festgelegt werden kann.

Zulässige Werte: false, true
--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--org --organization

Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. Beispiel: https://dev.azure.com/MyOrganizationName/

--pipeline-id

ID der Pipeline.

--pipeline-name

Name der Pipeline. Wird ignoriert, wenn der Parameter "--pipeline-id" angegeben wird.

--project -p

Name oder ID des Projekts. Sie können das Standardprojekt mit az devops configure -d project=NAME_OR_ID konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration verwendet werden.

--secret

Gibt an, ob der Wert der Variablen ein Geheimnis ist.

Zulässige Werte: false, true
--value

Der Wert der Variablen. Wenn der Parameter "-value" für geheime Variablen nicht angegeben wird, wird er aus der Umgebungsvariable ausgewählt, die mit AZURE_DEVOPS_EXT_PIPELINE_VAR_ vorangestellt ist, oder der Benutzer wird aufgefordert, ihn über die Standardeingabe einzugeben. Eine benannte MySecret Variable kann z. B. mithilfe der Umgebungsvariablen AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret eingegeben werden.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az pipelines variable delete

Löschen sie eine Variable aus der Pipeline.

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

Erforderliche Parameter

--name

Name der zu löschenden Variablen.

Optionale Parameter

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--org --organization

Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. Beispiel: https://dev.azure.com/MyOrganizationName/

--pipeline-id

ID der Pipeline.

--pipeline-name

Name der Pipeline.

--project -p

Name oder ID des Projekts. Sie können das Standardprojekt mit az devops configure -d project=NAME_OR_ID konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration verwendet werden.

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az pipelines variable list

Listen Sie die Variablen in einer Pipeline auf.

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

Optionale Parameter

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--org --organization

Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. Beispiel: https://dev.azure.com/MyOrganizationName/

--pipeline-id

ID der Pipeline.

--pipeline-name

Name der Pipeline. Wird ignoriert, wenn der Parameter "--pipeline-id" angegeben wird.

--project -p

Name oder ID des Projekts. Sie können das Standardprojekt mit az devops configure -d project=NAME_OR_ID konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration verwendet werden.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az pipelines variable update

Aktualisieren sie eine Variable in einer 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]

Erforderliche Parameter

--name

Name der Variable.

Optionale Parameter

--allow-override

Gibt an, ob der Wert zur Warteschlangenzeit festgelegt werden kann.

Zulässige Werte: false, true
--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--new-name

Neuer Name der Variablen.

--org --organization

Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. Beispiel: https://dev.azure.com/MyOrganizationName/

--pipeline-id

ID der Pipeline.

--pipeline-name

Name der Pipeline. Wird ignoriert, wenn der Parameter "--pipeline-id" angegeben wird.

--project -p

Name oder ID des Projekts. Sie können das Standardprojekt mit az devops configure -d project=NAME_OR_ID konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration verwendet werden.

--prompt-value

Legen Sie ihn auf "True" fest, um den Wert einer geheimen Variablen mithilfe der Umgebungsvariable oder der Eingabeaufforderung per Standardeingabe zu aktualisieren.

Zulässige Werte: false, true
--secret

Wenn der Wert der Variablen ein Geheimschlüssel ist.

Zulässige Werte: false, true
--value

Neuer Wert der Variablen. Verwenden Sie für geheime Variablen den Parameter "-prompt-value", um ihn über die Standardeingabe einzugeben. Bei nicht interaktiven Konsolen kann sie aus Umgebungsvariablen ausgewählt werden, die mit AZURE_DEVOPS_EXT_PIPELINE_VAR_ präfixiert wird, z. B. kann eine variable Namenseingabe MySecret mithilfe von Umgebungsvariablen AZURE_DEVOPS_EXT_PIPELINE_VAR_MySecret werden.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.