az pipelines

Kommentar

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.

Anknytning Allmän tillgänglighet
az pipelines agent list

Hämta en lista över agenter i en pool.

Anknytning Allmän tillgänglighet
az pipelines agent show

Visa agentinformation.

Anknytning Allmän tillgänglighet
az pipelines build

Hantera versioner.

Anknytning Allmän tillgänglighet
az pipelines build cancel

Avbryter om bygget körs.

Anknytning Allmän tillgänglighet
az pipelines build definition

Hantera byggdefinitioner.

Anknytning Allmän tillgänglighet
az pipelines build definition list

Lista versionsdefinitioner.

Anknytning Allmän tillgänglighet
az pipelines build definition show

Hämta information om en byggdefinition.

Anknytning Allmän tillgänglighet
az pipelines build list

Visa en lista över byggresultat.

Anknytning Allmän tillgänglighet
az pipelines build queue

Begär (kö) en version.

Anknytning Allmän tillgänglighet
az pipelines build show

Hämta information om ett bygge.

Anknytning Allmän tillgänglighet
az pipelines build tag

Hantera byggtaggar.

Anknytning Allmän tillgänglighet
az pipelines build tag add

Lägg till taggar för en version.

Anknytning Allmän tillgänglighet
az pipelines build tag delete

Ta bort en byggtagg.

Anknytning Allmän tillgänglighet
az pipelines build tag list

Hämta taggar för ett bygge.

Anknytning Allmän tillgänglighet
az pipelines create

Skapa en ny Azure Pipeline (YAML-baserad).

Anknytning Allmän tillgänglighet
az pipelines delete

Ta bort en pipeline.

Anknytning Allmän tillgänglighet
az pipelines folder

Hantera mappar för att organisera pipelines.

Anknytning Allmän tillgänglighet
az pipelines folder create

Skapa en mapp.

Anknytning Allmän tillgänglighet
az pipelines folder delete

Ta bort en mapp.

Anknytning Allmän tillgänglighet
az pipelines folder list

Visa en lista över alla mappar.

Anknytning Allmän tillgänglighet
az pipelines folder update

Uppdatera ett mappnamn eller en beskrivning.

Anknytning Allmän tillgänglighet
az pipelines list

Lista pipelines.

Anknytning Allmän tillgänglighet
az pipelines pool

Hantera agentpooler.

Anknytning Allmän tillgänglighet
az pipelines pool list

Lista agentpooler.

Anknytning Allmän tillgänglighet
az pipelines pool show

Visa information om agentpoolen.

Anknytning Allmän tillgänglighet
az pipelines queue

Hantera agentköer.

Anknytning Allmän tillgänglighet
az pipelines queue list

Lista agentköer.

Anknytning Allmän tillgänglighet
az pipelines queue show

Visa information om agentkön.

Anknytning Allmän tillgänglighet
az pipelines release

Hantera versioner.

Anknytning Allmän tillgänglighet
az pipelines release create

Begär (skapa) en version.

Anknytning Allmän tillgänglighet
az pipelines release definition

Hantera versionsdefinitioner.

Anknytning Allmän tillgänglighet
az pipelines release definition list

Lista versionsdefinitioner.

Anknytning Allmän tillgänglighet
az pipelines release definition show

Hämta information om en versionsdefinition.

Anknytning Allmän tillgänglighet
az pipelines release list

Lista versionsresultat.

Anknytning Allmän tillgänglighet
az pipelines release show

Hämta information om en version.

Anknytning Allmän tillgänglighet
az pipelines run

Köa (kör) en pipeline.

Anknytning Allmän tillgänglighet
az pipelines runs

Hantera pipelinekörningar.

Anknytning Allmän tillgänglighet
az pipelines runs artifact

Hantera pipelinekörningsartefakter.

Anknytning Allmän tillgänglighet
az pipelines runs artifact download

Ladda ned en pipelineartefakt.

Anknytning Allmän tillgänglighet
az pipelines runs artifact list

Lista artefakter som är associerade med en körning.

Anknytning Allmän tillgänglighet
az pipelines runs artifact upload

Ladda upp en pipelineartefakt.

Anknytning Allmän tillgänglighet
az pipelines runs list

Visa en lista över pipelinekörningar i ett projekt.

Anknytning Allmän tillgänglighet
az pipelines runs show

Visa information om en pipelinekörning.

Anknytning Allmän tillgänglighet
az pipelines runs tag

Hantera pipelinekörningstaggar.

Anknytning Allmän tillgänglighet
az pipelines runs tag add

Lägg till taggar för en pipelinekörning.

Anknytning Allmän tillgänglighet
az pipelines runs tag delete

Ta bort en pipelinekörningstagg.

Anknytning Allmän tillgänglighet
az pipelines runs tag list

Hämta taggar för en pipelinekörning.

Anknytning Allmän tillgänglighet
az pipelines show

Hämta information om en pipeline.

Anknytning Allmän tillgänglighet
az pipelines update

Uppdatera en pipeline.

Anknytning Allmän tillgänglighet
az pipelines variable

Hantera pipelinevariabler.

Anknytning Allmän tillgänglighet
az pipelines variable-group

Hantera variabelgrupper.

Anknytning Allmän tillgänglighet
az pipelines variable-group create

Skapa en variabelgrupp.

Anknytning Allmän tillgänglighet
az pipelines variable-group delete

Ta bort en variabelgrupp.

Anknytning Allmän tillgänglighet
az pipelines variable-group list

Lista variabelgrupper.

Anknytning Allmän tillgänglighet
az pipelines variable-group show

Visa information om variabelgrupper.

Anknytning Allmän tillgänglighet
az pipelines variable-group update

Uppdatera en variabelgrupp.

Anknytning Allmän tillgänglighet
az pipelines variable-group variable

Hantera variabler i en variabelgrupp.

Anknytning Allmän tillgänglighet
az pipelines variable-group variable create

Lägg till en variabel i en variabelgrupp.

Anknytning Allmän tillgänglighet
az pipelines variable-group variable delete

Ta bort en variabel från variabelgruppen.

Anknytning Allmän tillgänglighet
az pipelines variable-group variable list

Visa en lista över variablerna i en variabelgrupp.

Anknytning Allmän tillgänglighet
az pipelines variable-group variable update

Uppdatera en variabel i en variabelgrupp.

Anknytning Allmän tillgänglighet
az pipelines variable create

Lägg till en variabel i en pipeline.

Anknytning Allmän tillgänglighet
az pipelines variable delete

Ta bort en variabel från pipelinen.

Anknytning Allmän tillgänglighet
az pipelines variable list

Visa en lista över variablerna i en pipeline.

Anknytning Allmän tillgänglighet
az pipelines variable update

Uppdatera en variabel i en pipeline.

Anknytning Allmän tillgänglighet

az pipelines create

Skapa en ny Azure Pipeline (YAML-baserad).

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]

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

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

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

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

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

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az pipelines delete

Ta bort en pipeline.

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

Obligatoriska parametrar

--id

ID för pipelinen.

Valfria parametrar

--detect

Identifiera organisationen automatiskt.

accepterade värden: false, true
--org --organization

Url för Azure DevOps-organisation. Du kan konfigurera standardorganisationen med az devops configure -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.

standardvärde: False
Globala parametrar
--debug

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

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az pipelines list

Lista pipelines.

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]

Valfria parametrar

--detect

Identifiera organisationen automatiskt.

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

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

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

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az pipelines run

Köa (kör) en pipeline.

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

Valfria parametrar

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

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

standardvärde: False
--org --organization

Url för Azure DevOps-organisation. Du kan konfigurera standardorganisationen med az devops configure -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.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az pipelines show

Hämta information om en pipeline.

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

Valfria parametrar

--detect

Identifiera organisationen automatiskt.

accepterade 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å pipeline. Ignorerade om --id har angetts.

--open

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

standardvärde: False
--org --organization

Url för Azure DevOps-organisation. Du kan konfigurera standardorganisationen med az devops configure -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.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az pipelines update

Uppdatera en pipeline.

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

Obligatoriska parametrar

--id

ID för pipelinen som ska uppdateras.

Valfria parametrar

--branch

Grennamn som pipelinen ska konfigureras för.

--description

Ny beskrivning för pipelinen.

--detect

Identifiera organisationen automatiskt.

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

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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