Freigeben ü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 einen Az Pipelines-Buildbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten von Builds

Befehle

Name Beschreibung Typ Status
az pipelines build cancel

Bricht ab, wenn build ausgeführt wird.

 Durchwahl Allgemein verfügbar
az pipelines build definition

Verwalten von Builddefinitionen

 Durchwahl Allgemein verfügbar
az pipelines build definition list

Builddefinitionen auflisten.

 Durchwahl Allgemein verfügbar
az pipelines build definition show

Rufen Sie die Details einer Builddefinition ab.

 Durchwahl Allgemein verfügbar
az pipelines build list

Auflisten von Buildergebnissen.

 Durchwahl Allgemein verfügbar
az pipelines build queue

Fordern Sie einen Build an (Warteschlange).

 Durchwahl Allgemein verfügbar
az pipelines build show

Rufen Sie die Details eines Builds ab.

 Durchwahl Allgemein verfügbar
az pipelines build tag

Verwalten von Buildtags

 Durchwahl Allgemein verfügbar
az pipelines build tag add

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

 Durchwahl Allgemein verfügbar
az pipelines build tag delete

Löschen sie ein Buildtag.

 Durchwahl Allgemein verfügbar
az pipelines build tag list

Abrufen von Tags für einen Build.

 Durchwahl Allgemein verfügbar

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

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

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

--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. Durch Leerzeichen getrennt.

--top

Maximale Anzahl von Builds für die Liste.

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

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

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

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

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