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 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 der neuen Pipeline.
Optionale Parameter
Verzweigungsname, für den die Pipeline konfiguriert wird. Wenn sie weggelassen wird, wird sie automatisch aus dem lokalen Repository erkannt.
Beschreibung für die neue Pipeline.
Organisation automatisch erkennen.
Pfad des Ordners, in dem die Pipeline erstellt werden muss. Der Standard ist stammordner. z. B. "user1/test_pipelines".
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/.
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.
ID der Warteschlange in den verfügbaren Agentpools. Wird automatisch erkannt, wenn nicht angegeben.
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.
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.
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.
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.
Pfad der Pipelines-Yaml-Datei im Repository (wenn yaml bereits im Repository vorhanden ist).
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
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
Die ID der Pipeline.
Optionale Parameter
Organisation automatisch erkennen.
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/.
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.
Nicht zur Bestätigung auffordern
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
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
Organisation automatisch erkennen.
Wenn angegeben, filtern Sie nach Definitionen unter diesem Ordner.
Beschränken Sie die Ergebnisse auf Pipelines mit diesem Namen oder beginnen Sie mit diesem Namen. Beispiele: „FabCI“ oder „Fab*“.
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/.
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.
Reihenfolge der Ergebnisse.
Beschränken Sie die Ergebnisse auf Pipelines, die diesem Repository zugeordnet sind.
Beschränken Sie die Ergebnisse auf Pipelines, die diesem Repositorytyp zugeordnet sind. Es ist obligatorisch, das Argument "Repository" zusammen mit diesem Argument zu übergeben.
Maximale Anzahl der zu listenden Pipelines.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
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
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, für die die Pipelineausführung in die Warteschlange gestellt werden soll.
Organisation automatisch erkennen.
Ordnerpfad der Pipeline. Der Standardwert ist der Ordner auf Stammebene.
ID der pipeline to queue. Erforderlich, wenn --name nicht angegeben wird.
Name der Pipeline, die in die Warteschlange gestellt werden soll. Wird ignoriert, wenn --id angegeben wird.
Öffnen Sie die Pipelineergebnisseite in Ihrem Webbrowser.
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/
Leerzeichentrennte "name=value"-Paare für die Parameter, die Sie festlegen möchten.
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.
Leerzeichentrennte "name=value"-Paare für die Variablen, die Sie festlegen möchten.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
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
Organisation automatisch erkennen.
Ordnerpfad der Pipeline. Der Standardwert ist der Ordner auf Stammebene.
Die ID der Pipeline.
Name der Pipeline. Wird ignoriert, wenn --id angegeben wird.
Öffnen Sie die Pipelinezusammenfassungsseite in Ihrem Webbrowser.
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/.
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
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
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 der zu aktualisierenden Pipeline.
Optionale Parameter
Verzweigungsname, für den die Pipeline konfiguriert wird.
Neue Beschreibung für die Pipeline.
Organisation automatisch erkennen.
Neuer vollständiger Pfad des Ordners, in den die Pipeline verschoben werden soll. z. B. "user1/production_pipelines".
Neuer aktualisierter Name der Pipeline.
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/.
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.
Warteschlangen-ID des Agentpools, in dem die Pipeline ausgeführt werden muss.
Pfad der Pipelines-Yaml-Datei im Repository.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.