Teilen über

az pipelines build

  • 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 ein az pipelines build Befehl ausführen. Erfahren Sie mehr über Erweiterungen.

Verwalten von Builds.

Befehle

Name Beschreibung Typ Status
az pipelines build cancel

Bricht ab, wenn build ausgeführt wird.

 Erweiterung GA
az pipelines build definition

Verwalten von Builddefinitionen.

 Erweiterung GA
az pipelines build definition list

Builddefinitionen auflisten.

 Erweiterung GA
az pipelines build definition show

Rufen Sie die Details einer Builddefinition ab.

 Erweiterung GA
az pipelines build list

Auflisten von Buildergebnissen.

 Erweiterung GA
az pipelines build queue

Fordern Sie einen Build an (Warteschlange).

 Erweiterung GA
az pipelines build show

Rufen Sie die Details eines Builds ab.

 Erweiterung GA
az pipelines build tag

Buildtags verwalten.

 Erweiterung GA
az pipelines build tag add

Fügen Sie Tags für einen Build hinzu.

 Erweiterung GA
az pipelines build tag delete

Löschen sie ein Buildtag.

 Erweiterung GA
az pipelines build tag list

Abrufen von Tags für einen Build.

 Erweiterung GA

az pipelines build cancel

Bricht ab, wenn build ausgeführt wird.

az pipelines build cancel --build-id
                          [--detect {false, true}]
                          [--open]
                          [--org]
                          [--project]

Erforderliche Parameter

--build-id

ID des Builds.

Optionale Parameter

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--open

Öffnen Sie die Seite "Buildergebnisse" in Ihrem Webbrowser.

Standardwert: False
--org --organization

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

--project -p

Name oder ID des Projekts. Sie können das Standardprojekt mit az devops configure -d project=NAME_OR_ID konfigurieren. Erforderlich, wenn es nicht als Standard konfiguriert oder über git config übernommen wurde.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az pipelines build list

Auflisten von Buildergebnissen.

az pipelines build list [--branch]
                        [--definition-ids]
                        [--detect {false, true}]
                        [--org]
                        [--project]
                        [--reason {all, batchedCI, buildCompletion, checkInShelveset, individualCI, manual, pullRequest, schedule, triggered, userCreated, validateShelveset}]
                        [--requested-for]
                        [--result {canceled, failed, none, partiallySucceeded, succeeded}]
                        [--status {all, cancelling, completed, inProgress, none, notStarted, postponed}]
                        [--tags]
                        [--top]

Optionale Parameter

--branch

Filtern Sie nach Builds für diese Verzweigung.

--definition-ids

IDs (durch Leerzeichen getrennt) von Definitionen, für die Builds aufgeführt werden sollen.

--detect

Organisation automatisch erkennen.

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

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

--project -p

Name oder ID des Projekts. Sie können das Standardprojekt mit az devops configure -d project=NAME_OR_ID konfigurieren. Erforderlich, wenn es nicht als Standard konfiguriert oder über git config übernommen wurde.

--reason

Beschränken Sie sich auf Builds aus diesem Grund.

Zulässige Werte: all, batchedCI, buildCompletion, checkInShelveset, individualCI, manual, pullRequest, schedule, triggered, userCreated, validateShelveset
--requested-for

Limit to builds requested for this user or group.

--result

Beschränken Sie sich auf Builds mit diesem Ergebnis.

Zulässige Werte: canceled, failed, none, partiallySucceeded, succeeded
--status

Beschränken Sie sich auf Builds mit diesem Status.

Zulässige Werte: all, cancelling, completed, inProgress, none, notStarted, postponed
--tags

Limit to builds with each of the specified tags. Leerzeichen getrennt.

--top

Maximale Anzahl von Builds für die Liste.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az pipelines build queue

Fordern Sie einen Build an (Warteschlange).

az pipelines build queue [--branch]
                         [--commit-id]
                         [--definition-id]
                         [--definition-name]
                         [--detect {false, true}]
                         [--open]
                         [--org]
                         [--project]
                         [--queue-id]
                         [--variables]

Optionale Parameter

--branch

Zu erstellende Verzweigung. Erforderlich, wenn keine Standardverzweigung für die Definition eingerichtet ist. Beispiel: refs/heads/master oder master or refs/pull/1/merge or refs/tags/tag.

--commit-id

Commit-ID der zu erstellenden Verzweigung.

--definition-id

ID der Definition, die in die Warteschlange gestellt werden soll. Erforderlich, wenn --name nicht angegeben wird.

--definition-name

Name der Definition, die in die Warteschlange gestellt werden soll. Wird ignoriert, wenn --id angegeben wird.

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--open

Öffnen Sie die Seite "Buildergebnisse" in Ihrem Webbrowser.

Standardwert: False
--org --organization

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

--project -p

Name oder ID des Projekts. Sie können das Standardprojekt mit az devops configure -d project=NAME_OR_ID konfigurieren. Erforderlich, wenn es nicht als Standard konfiguriert oder über git config übernommen wurde.

--queue-id

Warteschlangen-ID des Pools, der verwendet wird, um den Build in die Warteschlange zu stellen.

--variables

Leerzeichentrennte "name=value"-Paare für die Variablen, die Sie festlegen möchten.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az pipelines build show

Rufen Sie die Details eines Builds ab.

az pipelines build show --id
                        [--detect {false, true}]
                        [--open]
                        [--org]
                        [--project]

Erforderliche Parameter

--id

ID des Builds.

Optionale Parameter

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--open

Öffnen Sie die Seite "Buildergebnisse" in Ihrem Webbrowser.

Standardwert: False
--org --organization

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

--project -p

Name oder ID des Projekts. Sie können das Standardprojekt mit az devops configure -d project=NAME_OR_ID konfigurieren. Erforderlich, wenn es nicht als Standard konfiguriert oder über git config übernommen wurde.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.