az pipelines

Note

Den här referensen är en del av azure-devops-tillägget för Azure CLI (version 2.30.0 eller senare). Tillägget installeras automatiskt första gången du kör kommandot az pipelines . Läs mer om tillägg.

Hantera Azure Pipelines.

Den här kommandogruppen är en del av azure-devops-tillägget.

Kommandon

Name	Description	Typ	Status
az pipelines agent	Hantera agenter.	Extension	GA
az pipelines agent list	Hämta en lista över agenter i en pool.	Extension	GA
az pipelines agent show	Visa agentinformation.	Extension	GA
az pipelines build	Hantera byggen.	Extension	GA
az pipelines build cancel	Avbryter om bygget körs.	Extension	GA
az pipelines build definition	Hantera byggdefinitioner.	Extension	GA
az pipelines build definition list	Lista versionsdefinitioner.	Extension	GA
az pipelines build definition show	Hämta information om en byggdefinition.	Extension	GA
az pipelines build list	Visa en lista över byggresultat.	Extension	GA
az pipelines build queue	Begär (kö) en version.	Extension	GA
az pipelines build show	Hämta information om ett bygge.	Extension	GA
az pipelines build tag	Hantera byggtaggar.	Extension	GA
az pipelines build tag add	Lägg till taggar för en version.	Extension	GA
az pipelines build tag delete	Ta bort en byggtagg.	Extension	GA
az pipelines build tag list	Hämta taggar för ett bygge.	Extension	GA
az pipelines create	Skapa en ny Azure Pipeline (YAML-baserad).	Extension	GA
az pipelines delete	Ta bort en pipeline.	Extension	GA
az pipelines folder	Hantera mappar för att organisera pipelines.	Extension	GA
az pipelines folder create	Skapa en mapp.	Extension	GA
az pipelines folder delete	Ta bort en mapp.	Extension	GA
az pipelines folder list	Visa en lista över alla mappar.	Extension	GA
az pipelines folder update	Uppdatera ett mappnamn eller en beskrivning.	Extension	GA
az pipelines list	Lista pipelines.	Extension	GA
az pipelines pool	Hantera agentpooler.	Extension	GA
az pipelines pool list	Lista agentpooler.	Extension	GA
az pipelines pool show	Visa information om agentpoolen.	Extension	GA
az pipelines queue	Hantera agentköer.	Extension	GA
az pipelines queue list	Lista agentköer.	Extension	GA
az pipelines queue show	Visa information om agentkön.	Extension	GA
az pipelines release	Hantera versioner.	Extension	GA
az pipelines release create	Begär (skapa) en version.	Extension	GA
az pipelines release definition	Hantera versionsdefinitioner.	Extension	GA
az pipelines release definition list	Lista versionsdefinitioner.	Extension	GA
az pipelines release definition show	Hämta information om en versionsdefinition.	Extension	GA
az pipelines release list	Lista versionsresultat.	Extension	GA
az pipelines release show	Hämta information om en version.	Extension	GA
az pipelines run	Köa (kör) en pipeline.	Extension	GA
az pipelines runs	Hantera pipelinekörningar.	Extension	GA
az pipelines runs artifact	Hantera pipelinekörningsartefakter.	Extension	GA
az pipelines runs artifact download	Ladda ned en pipelineartefakt.	Extension	GA
az pipelines runs artifact list	Lista artefakter som är associerade med en körning.	Extension	GA
az pipelines runs artifact upload	Ladda upp en pipelineartefakt.	Extension	GA
az pipelines runs list	Visa en lista över pipelinekörningar i ett projekt.	Extension	GA
az pipelines runs show	Visa information om en pipelinekörning.	Extension	GA
az pipelines runs tag	Hantera pipelinekörningstaggar.	Extension	GA
az pipelines runs tag add	Lägg till taggar för en pipelinekörning.	Extension	GA
az pipelines runs tag delete	Ta bort en pipelinekörningstagg.	Extension	GA
az pipelines runs tag list	Hämta taggar för en pipelinekörning.	Extension	GA
az pipelines show	Hämta information om en pipeline.	Extension	GA
az pipelines update	Uppdatera en pipeline.	Extension	GA
az pipelines variable	Hantera pipelinevariabler.	Extension	GA
az pipelines variable-group	Hantera variabelgrupper.	Extension	GA
az pipelines variable-group create	Skapa en variabelgrupp.	Extension	GA
az pipelines variable-group delete	Ta bort en variabelgrupp.	Extension	GA
az pipelines variable-group list	Lista variabelgrupper.	Extension	GA
az pipelines variable-group show	Visa information om variabelgrupper.	Extension	GA
az pipelines variable-group update	Uppdatera en variabelgrupp.	Extension	GA
az pipelines variable-group variable	Hantera variabler i en variabelgrupp.	Extension	GA
az pipelines variable-group variable create	Lägg till en variabel i en variabelgrupp.	Extension	GA
az pipelines variable-group variable delete	Ta bort en variabel från variabelgruppen.	Extension	GA
az pipelines variable-group variable list	Visa en lista över variablerna i en variabelgrupp.	Extension	GA
az pipelines variable-group variable update	Uppdatera en variabel i en variabelgrupp.	Extension	GA
az pipelines variable create	Lägg till en variabel i en pipeline.	Extension	GA
az pipelines variable delete	Ta bort en variabel från pipelinen.	Extension	GA
az pipelines variable list	Visa en lista över variablerna i en pipeline.	Extension	GA
az pipelines variable update	Uppdatera en variabel i en pipeline.	Extension	GA

az pipelines create

Skapa en ny Azure Pipeline (YAML-baserad).

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

Exempel

Skapa en Azure Pipeline från en lokal kassalagringsplatskontext

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'

Skapa en Azure Pipeline för en lagringsplats som finns på Github med klon-URL

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

Skapa en Azure Pipeline för en lagringsplats som finns i Github-organisationen SampleOrg, lagringsplatsens namn SampleRepo

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

Skapa en Azure Pipeline för en lagringsplats som finns i en Azure-lagringsplats i samma projekt

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

Skapa en Azure Pipeline för en lagringsplats med pipelinen yaml redan incheckad på lagringsplatsen

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]

Obligatoriska parametrar

--name

Namnet på den nya pipelinen.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--branch

Grennamn som pipelinen ska konfigureras för. Om den utelämnas identifieras den automatiskt från den lokala lagringsplatsen.

--description

Beskrivning för den nya pipelinen.

--detect

Identifiera organisationen automatiskt.

Egenskap	Värde
Godkända värden:	false, true

--folder-path

Sökväg till mappen där pipelinen måste skapas. Standardvärdet är rotmappen. t.ex. "user1/test_pipelines".

--org --organization

Url för Azure DevOps-organisation. Du kan konfigurera standardorganisationen med az devops konfigurera -d organization=ORG_URL. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration. Exempel: https://dev.azure.com/MyOrganizationName/.

--project -p

Projektets namn eller ID. Du kan konfigurera standardprojektet med az devops configure -d project=NAME_OR_ID. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration.

--queue-id

ID för kön i tillgängliga agentpooler. Identifieras automatiskt om det inte anges.

--repository

Lagringsplats som pipelinen måste konfigureras för. Kan vara klonings-URL för git-lagringsplatsen eller namnet på lagringsplatsen för en Azure Repos eller Owner/RepoName om det gäller GitHub-lagringsplatsen. Om den utelämnas identifieras den automatiskt från fjärr-URL:en för den lokala git-lagringsplatsen. Om namnet nämns i stället för url krävs även argumentet --repository-type.

--repository-type

Typ av lagringsplats. Om den utelämnas identifieras den automatiskt från fjärr-URL:en för den lokala lagringsplatsen. "tfsgit" för Azure Repos, "github" för GitHub-lagringsplatsen.

Egenskap	Värde
Godkända värden:	github, tfsgit

--service-connection

ID för tjänstanslutningen som skapats för lagringsplatsen för GitHub-lagringsplatsen. Använd kommandot az devops service-endpoint -h för att skapa/lista service_connections. Krävs inte för Azure-lagringsplatser.

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

Ange den här flaggan för att förhindra att den första körningen utlöses av kommandot. Kommandot returnerar en pipeline om körningen hoppas över, annars matas en pipelinekörning ut.

Egenskap	Värde
Godkända värden:	false, true

--yaml-path --yml-path

Sökvägen till yaml-filen pipelines på lagringsplatsen (om yaml redan finns på lagringsplatsen).

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az pipelines delete

Ta bort en pipeline.

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

Obligatoriska parametrar

--id

ID för pipelinen.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--detect

Identifiera organisationen automatiskt.

Egenskap	Värde
Godkända värden:	false, true

--org --organization

Url för Azure DevOps-organisation. Du kan konfigurera standardorganisationen med az devops konfigurera -d organization=ORG_URL. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration. Exempel: https://dev.azure.com/MyOrganizationName/.

--project -p

Projektets namn eller ID. Du kan konfigurera standardprojektet med az devops configure -d project=NAME_OR_ID. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration.

--yes -y

Fråga inte efter bekräftelse.

Egenskap	Värde
Standardvärde:	False

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az pipelines list

Lista pipelines.

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

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--detect

Identifiera organisationen automatiskt.

Egenskap	Värde
Godkända värden:	false, true

--folder-path

Om det anges filtrerar du till definitioner under den här mappen.

--name

Begränsa resultatet till pipelines med det här namnet eller börja med det här namnet. Exempel: "FabCI" eller "Fab*".

--org --organization

Url för Azure DevOps-organisation. Du kan konfigurera standardorganisationen med az devops konfigurera -d organization=ORG_URL. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration. Exempel: https://dev.azure.com/MyOrganizationName/.

--project -p

Projektets namn eller ID. Du kan konfigurera standardprojektet med az devops configure -d project=NAME_OR_ID. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration.

--query-order

Resultatordning.

Egenskap	Värde
Godkända värden:	ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None

--repository

Begränsa resultatet till pipelines som är associerade med den här lagringsplatsen.

--repository-type

Begränsa resultatet till pipelines som är associerade med den här lagringsplatsen. Det är obligatoriskt att skicka argumentet "lagringsplats" tillsammans med det här argumentet.

Egenskap	Värde
Godkända värden:	bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol

--top

Maximalt antal pipelines som ska listas.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az pipelines run

Köa (kör) en pipeline.

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

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--branch

Namnet på den gren där pipelinekörningen ska placeras i kö. Exempel: refs/heads/master eller master eller refs/pull/1/merge eller refs/tags/tag.

--commit-id

Inchecknings-ID som pipelinekörningen ska placeras i kö på.

--detect

Identifiera organisationen automatiskt.

Egenskap	Värde
Godkända värden:	false, true

--folder-path

Mappsökväg för pipeline. Standard är mappen på rotnivå.

--id

ID för pipelinen som ska köas. Krävs om --name inte anges.

--name

Namnet på pipelinen som ska köas. Ignorerade om --id har angetts.

--open

Öppna resultatsidan för pipelinen i webbläsaren.

Egenskap	Värde
Standardvärde:	False

--org --organization

Url för Azure DevOps-organisation. Du kan konfigurera standardorganisationen med az devops konfigurera -d organization=ORG_URL. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration. Exempel: https://dev.azure.com/MyOrganizationName/.

--parameters

Blankstegsavgränsade "name=value"-par för de parametrar som du vill ange.

--project -p

Projektets namn eller ID. Du kan konfigurera standardprojektet med az devops configure -d project=NAME_OR_ID. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration.

--variables

Blankstegsavgränsade "name=value"-par för de variabler som du vill ange.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az pipelines show

Hämta information om en pipeline.

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

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--detect

Identifiera organisationen automatiskt.

Egenskap	Värde
Godkända värden:	false, true

--folder-path

Mappsökväg för pipeline. Standard är mappen på rotnivå.

--id

ID för pipelinen.

--name

Namnet på pipelinen. Ignorerade om --id har angetts.

--open

Öppna sammanfattningssidan för pipelinen i webbläsaren.

Egenskap	Värde
Standardvärde:	False

--org --organization

Url för Azure DevOps-organisation. Du kan konfigurera standardorganisationen med az devops konfigurera -d organization=ORG_URL. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration. Exempel: https://dev.azure.com/MyOrganizationName/.

--project -p

Projektets namn eller ID. Du kan konfigurera standardprojektet med az devops configure -d project=NAME_OR_ID. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az pipelines update

Uppdatera en pipeline.

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

Obligatoriska parametrar

--id

ID för pipelinen som ska uppdateras.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--branch

Grennamn som pipelinen ska konfigureras för.

--description

Ny beskrivning för pipelinen.

--detect

Identifiera organisationen automatiskt.

Egenskap	Värde
Godkända värden:	false, true

--new-folder-path

Ny fullständig sökväg för mappen som pipelinen ska flyttas till. t.ex. "user1/production_pipelines".

--new-name

Nytt uppdaterat namn på pipelinen.

--org --organization

Url för Azure DevOps-organisation. Du kan konfigurera standardorganisationen med az devops konfigurera -d organization=ORG_URL. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration. Exempel: https://dev.azure.com/MyOrganizationName/.

--project -p

Projektets namn eller ID. Du kan konfigurera standardprojektet med az devops configure -d project=NAME_OR_ID. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration.

--queue-id

Kö-ID för agentpoolen där pipelinen måste köras.

--yaml-path --yml-path

Sökväg till yaml-filen pipelines på lagringsplatsen.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False