az pipelines

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 Befehl zum ersten Mal ausführen. Erfahren Sie mehr über Erweiterungen.

Verwalten von Azure Pipelines

Diese Befehlsgruppe ist Teil der Azure-devops-Erweiterung.

Befehle

Name	Beschreibung	Typ	Status
az pipelines agent	Verwalten von Agents.	Erweiterung	GA
az pipelines agent list	Dient zum Abrufen einer Liste von Agents in einem Pool.	Erweiterung	GA
az pipelines agent show	Anzeigen von Agentdetails.	Erweiterung	GA
az pipelines build	Verwalten von Builds.	Erweiterung	GA
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 create	Erstellen Einer neuen Azure-Pipeline (YAML-basiert).	Erweiterung	GA
az pipelines delete	Löschen sie eine Pipeline.	Erweiterung	GA
az pipelines folder	Verwalten von Ordnern zum Organisieren von Pipelines.	Erweiterung	GA
az pipelines folder create	Erstellen Sie einen Ordner.	Erweiterung	GA
az pipelines folder delete	Löschen eines Ordners.	Erweiterung	GA
az pipelines folder list	Alle Ordner auflisten.	Erweiterung	GA
az pipelines folder update	Aktualisieren eines Ordnernamens oder einer Beschreibung.	Erweiterung	GA
az pipelines list	Pipelines auflisten.	Erweiterung	GA
az pipelines pool	Verwalten von Agentpools.	Erweiterung	GA
az pipelines pool list	Agentpools auflisten.	Erweiterung	GA
az pipelines pool show	Anzeigen von Agentpooldetails.	Erweiterung	GA
az pipelines queue	Verwalten von Agentwarteschlangen.	Erweiterung	GA
az pipelines queue list	Agentwarteschlangen auflisten.	Erweiterung	GA
az pipelines queue show	Details der Agentwarteschlange anzeigen.	Erweiterung	GA
az pipelines release	Verwalten von Versionen.	Erweiterung	GA
az pipelines release create	Anfordern (Erstellen) einer Version.	Erweiterung	GA
az pipelines release definition	Verwalten von Versionsdefinitionen.	Erweiterung	GA
az pipelines release definition list	Versionsdefinitionen auflisten.	Erweiterung	GA
az pipelines release definition show	Rufen Sie die Details einer Releasedefinition ab.	Erweiterung	GA
az pipelines release list	Versionsergebnisse auflisten.	Erweiterung	GA
az pipelines release show	Rufen Sie die Details einer Version ab.	Erweiterung	GA
az pipelines run	Warteschlange (Ausführen) einer Pipeline.	Erweiterung	GA
az pipelines runs	Verwalten von Pipelineausführungen.	Erweiterung	GA
az pipelines runs artifact	Verwalten von Pipelineausführungsartefakten.	Erweiterung	GA
az pipelines runs artifact download	Laden Sie ein Pipelineartefakt herunter.	Erweiterung	GA
az pipelines runs artifact list	Listenartefakte, die einer Ausführung zugeordnet sind.	Erweiterung	GA
az pipelines runs artifact upload	Hochladen eines Pipelineartefakts.	Erweiterung	GA
az pipelines runs list	Auflisten der Pipeline, die in einem Projekt ausgeführt wird.	Erweiterung	GA
az pipelines runs show	Details einer Pipelineausführung anzeigen.	Erweiterung	GA
az pipelines runs tag	Verwalten von Pipelineausführungstags.	Erweiterung	GA
az pipelines runs tag add	Fügen Sie Tags für eine Pipelineausführung hinzu.	Erweiterung	GA
az pipelines runs tag delete	Löschen sie ein Pipelineausführungstag.	Erweiterung	GA
az pipelines runs tag list	Abrufen von Tags für eine Pipelineausführung.	Erweiterung	GA
az pipelines show	Rufen Sie die Details einer Pipeline ab.	Erweiterung	GA
az pipelines update	Aktualisieren einer Pipeline.	Erweiterung	GA
az pipelines variable	Verwalten von Pipelinevariablen.	Erweiterung	GA
az pipelines variable-group	Verwalten von Variablengruppen.	Erweiterung	GA
az pipelines variable-group create	Erstellen Sie eine Variablegruppe.	Erweiterung	GA
az pipelines variable-group delete	Löschen einer Variablengruppe.	Erweiterung	GA
az pipelines variable-group list	Listenvariablengruppen.	Erweiterung	GA
az pipelines variable-group show	Variablengruppendetails anzeigen.	Erweiterung	GA
az pipelines variable-group update	Dient zum Aktualisieren einer Variablengruppe.	Erweiterung	GA
az pipelines variable-group variable	Verwalten von Variablen in einer Variablengruppe	Erweiterung	GA
az pipelines variable-group variable create	Fügen Sie einer Variablengruppe eine Variable hinzu.	Erweiterung	GA
az pipelines variable-group variable delete	Löschen sie eine Variable aus der Variablengruppe.	Erweiterung	GA
az pipelines variable-group variable list	Listen Sie die Variablen in einer Variablengruppe auf.	Erweiterung	GA
az pipelines variable-group variable update	Aktualisieren sie eine Variable in einer Variablengruppe.	Erweiterung	GA
az pipelines variable create	Fügen Sie einer Pipeline eine Variable hinzu.	Erweiterung	GA
az pipelines variable delete	Löschen sie eine Variable aus der Pipeline.	Erweiterung	GA
az pipelines variable list	Listen Sie die Variablen in einer Pipeline auf.	Erweiterung	GA
az pipelines variable update	Aktualisieren sie eine Variable in einer Pipeline.	Erweiterung	GA

az pipelines create

Erstellen Einer neuen Azure-Pipeline (YAML-basiert).

az pipelines create --name
                    [--branch]
                    [--description]
                    [--detect {false, true}]
                    [--folder-path]
                    [--org]
                    [--project]
                    [--queue-id]
                    [--repository]
                    [--repository-type {github, tfsgit}]
                    [--service-connection]
                    [--skip-first-run {false, true}]
                    [--yaml-path]

Beispiele

Erstellen einer Azure-Pipeline aus dem Kontext des lokalen Checkout-Repositorys

Repository name/url (--repository), type (--repository-type) and branch name (--branch) will be detected from the local git repository
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'

Erstellen einer Azure-Pipeline für ein auf Github gehostetes Repository mithilfe der Klon-URL

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository https://github.com/SampleOrg/SampleRepo --branch master

Erstellen einer Azure-Pipeline für ein Repository, das auf Github-Organisation SampleOrg gehostet wird, Repositoryname SampleRepo

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleOrg/SampleRepoName --branch master --repository-type github

Erstellen einer Azure-Pipeline für ein Repository, das in einem Azure Repo im selben Projekt gehostet wird

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleRepoName --branch master --repository-type tfsgit

Erstellen einer Azure-Pipeline für ein Repository mit dem bereits in das Repository eingecheckten Pipeline-Yaml

Service connection required for non Azure Repos can be optionally provided in the command to run it non interatively
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository https://github.com/SampleOrg/SampleRepo --branch master --yml-path azure-pipelines.yml [--service-connection SERVICE_CONNECTION]

Erforderliche Parameter

--name

Name der neuen Pipeline.

Optionale Parameter

--branch

Verzweigungsname, für den die Pipeline konfiguriert wird. Wenn sie weggelassen wird, wird sie automatisch aus dem lokalen Repository erkannt.

--description

Beschreibung für die neue Pipeline.

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true

--folder-path

Pfad des Ordners, in dem die Pipeline erstellt werden muss. Der Standard ist stammordner. z. B. "user1/test_pipelines".

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

ID der Warteschlange in den verfügbaren Agentpools. Wird automatisch erkannt, wenn nicht angegeben.

--repository

Repository, für das die Pipeline konfiguriert werden muss. Dies kann die Klon-URL des Git-Repositorys oder des Namens des Repositorys für ein Azure Repos oder Owner/RepoName im Fall eines GitHub-Repositorys sein. Wenn sie nicht angegeben wird, wird sie automatisch von der Remote-URL des lokalen Git-Repositorys erkannt. Wenn anstelle der URL der Name erwähnt wird, ist auch das Argument "-repository-type" erforderlich.

--repository-type

Typ des Repositorys. Wenn sie weggelassen wird, wird sie automatisch von der Remote-URL des lokalen Repositorys erkannt. 'tfsgit' für Azure Repos, 'github' für GitHub-Repository.

Zulässige Werte: github, tfsgit

--service-connection

ID der Dienstverbindung, die für das Repository für GitHub-Repository erstellt wurde. Verwenden Sie befehl az devops service-endpoint -h zum Erstellen/Auflisten service_connections. Für Azure Repos nicht erforderlich.

--skip-first-run --skip-run

Geben Sie dieses Kennzeichen an, um zu verhindern, dass die erste Ausführung durch den Befehl ausgelöst wird. Der Befehl gibt eine Pipeline zurück, wenn die Ausführung übersprungen wird, andernfalls wird eine Pipelineausführung ausgegeben.

Zulässige Werte: false, true

--yaml-path --yml-path

Pfad der Pipelines-Yaml-Datei im Repository (wenn yaml bereits im Repository vorhanden ist).

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 delete

Löschen sie eine Pipeline.

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

Erforderliche Parameter

--id

ID der Pipeline.

Optionale Parameter

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

--yes -y

Zur Bestätigung nicht auffordern.

Standardwert: False

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 list

Pipelines auflisten.

az pipelines list [--detect {false, true}]
                  [--folder-path]
                  [--name]
                  [--org]
                  [--project]
                  [--query-order {ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None}]
                  [--repository]
                  [--repository-type {bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol}]
                  [--top]

Optionale Parameter

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true

--folder-path

Wenn angegeben, filtern Sie nach Definitionen unter diesem Ordner.

--name

Beschränken Sie die Ergebnisse auf Pipelines mit diesem Namen oder beginnen Sie mit diesem Namen. Beispiele: "FabCI" oder "Fab*".

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

--query-order

Reihenfolge der Ergebnisse.

Zulässige Werte: ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None

--repository

Beschränken Sie die Ergebnisse auf Pipelines, die diesem Repository zugeordnet sind.

--repository-type

Beschränken Sie die Ergebnisse auf Pipelines, die diesem Repositorytyp zugeordnet sind. Es ist obligatorisch, das Argument "Repository" zusammen mit diesem Argument zu übergeben.

Zulässige Werte: bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol

--top

Maximale Anzahl der zu listenden Pipelines.

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 run

Warteschlange (Ausführen) einer Pipeline.

az pipelines run [--branch]
                 [--commit-id]
                 [--detect {false, true}]
                 [--folder-path]
                 [--id]
                 [--name]
                 [--open]
                 [--org]
                 [--parameters]
                 [--project]
                 [--variables]

Optionale Parameter

--branch

Der Name der Verzweigung, auf der die Pipeline ausgeführt werden soll, wird in die Warteschlange gestellt. Beispiel: refs/heads/master oder master or refs/pull/1/merge or refs/tags/tag.

--commit-id

Commit-ID, für die die Pipelineausführung in die Warteschlange gestellt werden soll.

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true

--folder-path

Ordnerpfad der Pipeline. Der Standardordner ist der Stammebenenordner.

--id

ID der Pipeline, die in die Warteschlange gestellt wird. Erforderlich, wenn --name nicht angegeben wird.

--name

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

--open

Öffnen Sie die Pipelineergebnisseite 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/.

--parameters

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

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

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

Rufen Sie die Details einer Pipeline ab.

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

Optionale Parameter

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true

--folder-path

Ordnerpfad der Pipeline. Der Standardordner ist der Stammebenenordner.

--id

ID der Pipeline.

--name

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

--open

Öffnen Sie die Pipelinezusammenfassungsseite 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 update

Aktualisieren einer Pipeline.

az pipelines update --id
                    [--branch]
                    [--description]
                    [--detect {false, true}]
                    [--new-folder-path]
                    [--new-name]
                    [--org]
                    [--project]
                    [--queue-id]
                    [--yaml-path]

Erforderliche Parameter

--id

ID der zu aktualisierenden Pipeline.

Optionale Parameter

--branch

Verzweigungsname, für den die Pipeline konfiguriert wird.

--description

Neue Beschreibung für die Pipeline.

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true

--new-folder-path

Neuer vollständiger Pfad des Ordners, in den die Pipeline verschoben werden soll. z. B. "user1/production_pipelines".

--new-name

Neuer aktualisierter Name der Pipeline.

--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 Agentpools, in dem die Pipeline ausgeführt werden muss.

--yaml-path --yml-path

Pfad der Pipelines-Yaml-Datei im Repository.

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.