az pipelines

Referenz

Verwalten von Azure Pipelines

Diese Befehlsgruppe ist Teil der Azure-devops-Erweiterung.

Befehle

az pipelines agent	Verwalten von Agents
az pipelines agent list	Rufen Sie eine Liste der Agents in einem Pool ab.
az pipelines agent show	Anzeigen von Agentdetails.
az pipelines build	Verwalten von Builds
az pipelines build definition	Verwalten von Builddefinitionen
az pipelines build definition list	Listenbuilddefinitionen.
az pipelines build definition show	Rufen Sie die Details einer Builddefinition ab.
az pipelines build list	Listenbuildergebnisse.
az pipelines build queue	Anforderung (Warteschlange) eines Builds.
az pipelines build show	Rufen Sie die Details eines Builds ab.
az pipelines build tag	Verwalten von Buildtags
az pipelines build tag add	Fügen Sie Tag(n) für einen Build hinzu.
az pipelines build tag delete	Löschen eines Buildtags
az pipelines build tag list	Abrufen von Tags für einen Build.
az pipelines create	Erstellen Sie eine neue Azure-Pipeline (YAML-basiert).
az pipelines delete	Löschen einer Pipeline.
az pipelines folder	Verwalten von Ordnern zum Organisieren von Pipelines
az pipelines folder create	Erstellen Sie einen Ordner.
az pipelines folder delete	Löschen eines Ordners.
az pipelines folder list	Alle Ordner auflisten.
az pipelines folder update	Aktualisieren eines Ordnernamens oder einer Beschreibung.
az pipelines list	Listenpipelinen.
az pipelines pool	Verwalten von Agentpools
az pipelines pool list	Agentpools auflisten.
az pipelines pool show	Anzeigen von Agentpooldetails.
az pipelines queue	Verwalten von Agent-Warteschlangen
az pipelines queue list	Listen-Agent-Warteschlangen.
az pipelines queue show	Details der Agentwarteschlange anzeigen.
az pipelines release	Verwalten von Releases
az pipelines release create	Anfordern (Erstellen) einer Version.
az pipelines release definition	Verwalten von Releasedefinitionen
az pipelines release definition list	Listenfreigabedefinitionen.
az pipelines release definition show	Rufen Sie die Details einer Releasedefinition ab.
az pipelines release list	Ergebnisse der Veröffentlichung auflisten.
az pipelines release show	Rufen Sie die Details einer Version ab.
az pipelines run	Warteschlange (Ausführen) einer Pipeline.
az pipelines runs	Verwalten von Pipelineausführungen
az pipelines runs artifact	Verwalten der Artefakte von Pipelineausführungen
az pipelines runs artifact download	Laden Sie ein Pipelineartefakt herunter.
az pipelines runs artifact list	Listenartefakte, die einer Ausführung zugeordnet sind.
az pipelines runs artifact upload	Laden Sie ein Pipelineartefakt hoch.
az pipelines runs list	Listet die Pipeline in einem Projekt auf.
az pipelines runs show	Details einer Pipelineausführung anzeigen.
az pipelines runs tag	Verwalten der Tags von Pipelineausführungen
az pipelines runs tag add	Fügen Sie Tag(n) für eine Pipelineausführung hinzu.
az pipelines runs tag delete	Löschen eines Pipelineausführungstags.
az pipelines runs tag list	Abrufen von Tags für eine Pipelineausführung.
az pipelines show	Rufen Sie die Details einer Pipeline ab.
az pipelines update	Aktualisieren einer Pipeline.
az pipelines variable	Verwalten von Pipelinevariablen.
az pipelines variable create	Fügen Sie einer Pipeline eine Variable hinzu.
az pipelines variable delete	Löschen sie eine Variable aus der Pipeline.
az pipelines variable list	Listet die Variablen in einer Pipeline auf.
az pipelines variable update	Aktualisieren einer Variablen in einer Pipeline
az pipelines variable-group	Verwalten von Variablengruppen
az pipelines variable-group create	Erstellen Sie eine Variablegruppe.
az pipelines variable-group delete	Löschen einer Variablengruppe.
az pipelines variable-group list	Listenvariablengruppen.
az pipelines variable-group show	Anzeigen von Variablengruppendetails.
az pipelines variable-group update	Aktualisieren einer Variablengruppe
az pipelines variable-group variable	Verwalten von Variablen in einer Variablengruppe
az pipelines variable-group variable create	Fügen Sie einer Variablengruppe eine Variable hinzu.
az pipelines variable-group variable delete	Löschen sie eine Variable aus der Variablengruppe.
az pipelines variable-group variable list	Listet die Variablen in einer Variablengruppe auf.
az pipelines variable-group variable update	Aktualisieren einer Variablen in einer Variablengruppe

az pipelines create

Erstellen Sie eine neue 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 Auscheck-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 in 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 nicht angegeben 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. Standard ist Stammordner. z. B. "user1/test_pipelines".

--org --organization

Url der Azure DevOps-Organisation. Sie können die Standardorganisation mithilfe von az devops configure -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 mithilfe von az devops configure -d project=NAME_OR_ID konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde.

--queue-id

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

--repository

Repository, für das die Pipeline konfiguriert werden muss. Kann die Klon-URL des Git-Repositorys oder des Repositorys für einen Azure Repos oder Owner/RepoName im Fall des GitHub-Repositorys klonen. Wenn es nicht angegeben wird, wird es automatisch aus der Remote-URL des lokalen Git-Repositorys erkannt. Wenn der Name anstelle der URL erwähnt wird, ist auch das Argument "-repository-type" erforderlich.

--repository-type

Typ des Repositorys. Wenn sie nicht angegeben 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/Eintrag service_connections. Für Azure Repos nicht erforderlich.

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

Geben Sie dieses Flag an, um zu verhindern, dass die erste Ausführung durch den Befehl ausgelöst wird. 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 Repo (wenn yaml bereits im Repo 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.

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

Die Organisation wird automatisch erkannt.

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 aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

--project -p

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

--yes -y

Nicht zur Bestätigung auffordern

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.

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

Listenpipelinen.

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

Die Organisation wird automatisch erkannt.

Zulässige Werte: false, true

--folder-path

Wenn angegeben, filtern Sie nach Definitionen unter diesem Ordner.

--name

Beschränken Sie 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 Ergebnisse auf Pipelines, die diesem Repository zugeordnet sind.

--repository-type

Beschränken Sie 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 von Pipelines, die listet werden sollen.

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.

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

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

--commit-id

Commit-ID, auf der die Pipeline ausgeführt wird, muss in die Warteschlange gestellt werden.

--detect

Die Organisation wird automatisch erkannt.

Zulässige Werte: false, true

--folder-path

Ordnerpfad der Pipeline. Standard ist Der Stammebenenordner.

--id

ID der Pipeline zur Warteschlange. Erforderlich, wenn --Name nicht angegeben wird.

--name

Name der Pipeline für die Warteschlange. Ignoriert, wenn --id angegeben wird.

--open

Öffnen Sie die Pipelineergebnisseseite im Webbrowser.

--org --organization

--parameters

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

--project -p

--variables

Leerzeichen getrennte "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.

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

Die Organisation wird automatisch erkannt.

Zulässige Werte: false, true

--folder-path

Ordnerpfad der Pipeline. Standard ist Der Stammebenenordner.

--id

Die ID der Pipeline.

--name

Name der Pipeline. Ignoriert, wenn --id angegeben wird.

--open

Öffnen Sie die Pipelinezusammenfassungsseite im Webbrowser.

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

--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 Pipeline, die aktualisiert werden soll.

Optionale Parameter

--branch

Verzweigungsname, für den die Pipeline konfiguriert wird.

--description

Neue Beschreibung für die Pipeline.

--detect

Die Organisation wird automatisch erkannt.

Zulässige Werte: false, true

--new-folder-path

Neuer vollständiger Pfad des Ordners, um die Pipeline zu verschieben. 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 Repo.

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.

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

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

Feedback