Freigeben über


az pipelines build

Note

This reference is part of the azure-devops extension for the Azure CLI (version 2.30.0 or higher). Die Erweiterung wird automatisch installiert, wenn Sie ein az pipelines build Befehl ausführen. Learn more about extensions.

Manage builds.

Befehle

Name Beschreibung Typ Status
az pipelines build cancel

Bricht ab, wenn build ausgeführt wird.

Extension GA
az pipelines build definition

Verwalten von Builddefinitionen.

Extension GA
az pipelines build definition list

Builddefinitionen auflisten.

Extension GA
az pipelines build definition show

Rufen Sie die Details einer Builddefinition ab.

Extension GA
az pipelines build list

Auflisten von Buildergebnissen.

Extension GA
az pipelines build queue

Fordern Sie einen Build an (Warteschlange).

Extension GA
az pipelines build show

Rufen Sie die Details eines Builds ab.

Extension GA
az pipelines build tag

Buildtags verwalten.

Extension GA
az pipelines build tag add

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

Extension GA
az pipelines build tag delete

Löschen sie ein Buildtag.

Extension GA
az pipelines build tag list

Abrufen von Tags für einen Build.

Extension GA

az pipelines build cancel

Bricht ab, wenn build ausgeführt wird.

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

Erforderliche Parameter

--build-id

ID des Builds.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

Organisation automatisch erkennen.

Eigenschaft Wert
Zulässige Werte: false, true
--open

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

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

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Eigenschaft Wert
Standardwert: False

az pipelines build list

Auflisten von Buildergebnissen.

az pipelines build list [--branch]
                        [--definition-ids]
                        [--detect {false, true}]
                        [--org --organization]
                        [--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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

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

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

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

Beschränken Sie sich auf Builds mit diesem Status.

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

Limit to builds with each of the specified tags. Space separated.

--top

Maximale Anzahl von Builds für die Liste.

Globale Parameter
--debug

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

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Eigenschaft Wert
Standardwert: False

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 --organization]
                         [--project]
                         [--queue-id]
                         [--variables]

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Eigenschaft Wert
Zulässige Werte: false, true
--open

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

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

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Eigenschaft Wert
Standardwert: False

az pipelines build show

Rufen Sie die Details eines Builds ab.

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

Erforderliche Parameter

--id

ID des Builds.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

Organisation automatisch erkennen.

Eigenschaft Wert
Zulässige Werte: false, true
--open

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

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

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Eigenschaft Wert
Standardwert: False