az pipelines

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-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten von Azure Pipelines

Diese Befehlsgruppe ist Teil der Azure-devops-Erweiterung.

Befehle

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

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 der Name anstelle von URL Erwähnung 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

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 delete

Löschen sie eine Pipeline.

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

Erforderliche Parameter

--id

Die ID der Pipeline.

Optionale Parameter

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true

--org --organization

--project -p

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

--project -p

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

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 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 Standardwert ist der Ordner auf Stammebene.

--id

ID der pipeline to queue. 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

--parameters

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

--project -p

--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 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 Standardwert ist der Ordner auf Stammebene.

--id

Die 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

--project -p

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

--project -p

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

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.

Freigeben über

az pipelines

Befehle

az pipelines create

Beispiele

Erforderliche Parameter

Optionale Parameter

az pipelines delete

Erforderliche Parameter

Optionale Parameter

az pipelines list

Optionale Parameter

az pipelines run

Optionale Parameter

az pipelines show

Optionale Parameter

az pipelines update

Erforderliche Parameter

Optionale Parameter

Zusätzliche Ressourcen