az pipelines

Note

This reference is part of the azure-devops extension for the Azure CLI (version 2.30.0 or higher). The extension will automatically install the first time you run an az pipelines command. Learn more about extensions.

Gestire Azure Pipelines.

Questo gruppo di comandi fa parte dell'estensione azure-devops.

Comandi

Nome	Descrizione	Tipo	Status
az pipelines agent	Manage agents.	Extension	GA
az pipelines agent list	Ottenere un elenco di agenti in un pool.	Extension	GA
az pipelines agent show	Mostra i dettagli dell'agente.	Extension	GA
az pipelines build	Manage builds.	Extension	GA
az pipelines build cancel	Annulla se la compilazione è in esecuzione.	Extension	GA
az pipelines build definition	Gestire le definizioni di compilazione.	Extension	GA
az pipelines build definition list	Elencare le definizioni di compilazione.	Extension	GA
az pipelines build definition show	Ottenere i dettagli di una definizione di compilazione.	Extension	GA
az pipelines build list	Elencare i risultati della compilazione.	Extension	GA
az pipelines build queue	Richiedere (coda) una compilazione.	Extension	GA
az pipelines build show	Ottenere i dettagli di una compilazione.	Extension	GA
az pipelines build tag	Gestire i tag di compilazione.	Extension	GA
az pipelines build tag add	Aggiungere tag per una compilazione.	Extension	GA
az pipelines build tag delete	Eliminare un tag di compilazione.	Extension	GA
az pipelines build tag list	Ottenere i tag per una compilazione.	Extension	GA
az pipelines create	Creare una nuova pipeline di Azure (basata su YAML).	Extension	GA
az pipelines delete	Eliminare una pipeline.	Extension	GA
az pipelines folder	Gestire le cartelle per organizzare le pipeline.	Extension	GA
az pipelines folder create	Creare una cartella.	Extension	GA
az pipelines folder delete	Eliminare una cartella.	Extension	GA
az pipelines folder list	Elencare tutte le cartelle.	Extension	GA
az pipelines folder update	Aggiornare il nome o la descrizione di una cartella.	Extension	GA
az pipelines list	List pipelines.	Extension	GA
az pipelines pool	Gestire i pool di agenti.	Extension	GA
az pipelines pool list	Elencare i pool di agenti.	Extension	GA
az pipelines pool show	Mostra i dettagli del pool di agenti.	Extension	GA
az pipelines queue	Gestire le code degli agenti.	Extension	GA
az pipelines queue list	Elencare le code degli agenti.	Extension	GA
az pipelines queue show	Mostra i dettagli della coda dell'agente.	Extension	GA
az pipelines release	Manage releases.	Extension	GA
az pipelines release create	Richiedere (creare) una versione.	Extension	GA
az pipelines release definition	Gestire le definizioni di versione.	Extension	GA
az pipelines release definition list	Elencare le definizioni di versione.	Extension	GA
az pipelines release definition show	Ottenere i dettagli di una definizione di versione.	Extension	GA
az pipelines release list	Elencare i risultati della versione.	Extension	GA
az pipelines release show	Ottenere i dettagli di una versione.	Extension	GA
az pipelines run	Accodamento (esecuzione) di una pipeline.	Extension	GA
az pipelines runs	Gestire le esecuzioni della pipeline.	Extension	GA
az pipelines runs artifact	Gestire gli artefatti di esecuzione della pipeline.	Extension	GA
az pipelines runs artifact download	Scaricare un artefatto della pipeline.	Extension	GA
az pipelines runs artifact list	Elencare gli artefatti associati a un'esecuzione.	Extension	GA
az pipelines runs artifact upload	Caricare un artefatto della pipeline.	Extension	GA
az pipelines runs list	Elencare le esecuzioni della pipeline in un progetto.	Extension	GA
az pipelines runs show	Visualizzare i dettagli di un'esecuzione della pipeline.	Extension	GA
az pipelines runs tag	Gestire i tag di esecuzione della pipeline.	Extension	GA
az pipelines runs tag add	Aggiungere tag per un'esecuzione della pipeline.	Extension	GA
az pipelines runs tag delete	Eliminare un tag di esecuzione della pipeline.	Extension	GA
az pipelines runs tag list	Ottenere i tag per un'esecuzione della pipeline.	Extension	GA
az pipelines show	Ottenere i dettagli di una pipeline.	Extension	GA
az pipelines update	Aggiornare una pipeline.	Extension	GA
az pipelines variable	Gestire le variabili della pipeline.	Extension	GA
az pipelines variable-group	Gestire i gruppi di variabili.	Extension	GA
az pipelines variable-group create	Creare un gruppo di variabili.	Extension	GA
az pipelines variable-group delete	Eliminare un gruppo di variabili.	Extension	GA
az pipelines variable-group list	Elencare i gruppi di variabili.	Extension	GA
az pipelines variable-group show	Visualizzare i dettagli del gruppo di variabili.	Extension	GA
az pipelines variable-group update	Aggiornare un gruppo di variabili.	Extension	GA
az pipelines variable-group variable	Gestire le variabili in un gruppo di variabili.	Extension	GA
az pipelines variable-group variable create	Aggiungere una variabile a un gruppo di variabili.	Extension	GA
az pipelines variable-group variable delete	Eliminare una variabile dal gruppo di variabili.	Extension	GA
az pipelines variable-group variable list	Elencare le variabili in un gruppo di variabili.	Extension	GA
az pipelines variable-group variable update	Aggiornare una variabile in un gruppo di variabili.	Extension	GA
az pipelines variable create	Aggiungere una variabile a una pipeline.	Extension	GA
az pipelines variable delete	Eliminare una variabile dalla pipeline.	Extension	GA
az pipelines variable list	Elencare le variabili in una pipeline.	Extension	GA
az pipelines variable update	Aggiornare una variabile in una pipeline.	Extension	GA

az pipelines create

Creare una nuova pipeline di Azure (basata su YAML).

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]

Esempio

Creare una pipeline di Azure dal contesto del repository di estrazione locale

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'

Creare una pipeline di Azure per un repository ospitato in Github usando l'URL clone

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

Creare una pipeline di Azure per un repository ospitato nell'organizzazione GitHub SampleOrg, il nome del repository SampleRepo

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

Creare una pipeline di Azure per un repository ospitato in un repository di Azure nello stesso progetto

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

Creare una pipeline di Azure per un repository con il file yaml della pipeline già archiviato nel repository

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]

Parametri necessari

--name

Nome della nuova pipeline.

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--branch

Nome del ramo per il quale verrà configurata la pipeline. Se omesso, verrà rilevato automaticamente dal repository locale.

--description

Descrizione per la nuova pipeline.

--detect

Riconoscere automaticamente l'organizzazione.

Proprietà	Valore
Valori accettati:	false, true

--folder-path

Percorso della cartella in cui deve essere creata la pipeline. Il valore predefinito è la cartella radice. e.g. "user1/test_pipelines".

--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

--queue-id

ID della coda nei pool di agenti disponibili. Se non specificato, verrà rilevato automaticamente.

--repository

Repository per il quale deve essere configurata la pipeline. Può essere l'URL clone del repository Git o il nome del repository per azure Repos o Owner/RepoName in caso di repository GitHub. Se omesso, verrà rilevato automaticamente dall'URL remoto del repository Git locale. Se il nome è indicato invece dell'URL, è necessario anche l'argomento --repository-type.

--repository-type

Tipo di repository. Se omesso, verrà rilevato automaticamente dall'URL remoto del repository locale. 'tfsgit' per Azure Repos, 'github' per il repository GitHub.

Proprietà	Valore
Valori accettati:	github, tfsgit

--service-connection

ID della connessione al servizio creata per il repository per il repository GitHub. Usare il comando az devops service-endpoint -h per creare/elencare service_connections. Non obbligatorio per Azure Repos.

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

Specificare questo flag per impedire che la prima esecuzione venga attivata dal comando . Se l'esecuzione viene ignorata, il comando restituirà una pipeline. In caso contrario, verrà restituita un'esecuzione della pipeline.

Proprietà	Valore
Valori accettati:	false, true

--yaml-path --yml-path

Percorso del file yaml delle pipeline nel repository (se yaml è già presente nel repository).

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

az pipelines delete

Eliminare una pipeline.

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

Parametri necessari

--id

ID della pipeline.

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

Riconoscere automaticamente l'organizzazione.

Proprietà	Valore
Valori accettati:	false, true

--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

--yes -y

Non richiedere conferma.

Proprietà	Valore
Valore predefinito:	False

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

az pipelines list

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

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

Riconoscere automaticamente l'organizzazione.

Proprietà	Valore
Valori accettati:	false, true

--folder-path

Se specificato, filtra le definizioni in questa cartella.

--name

Limitare i risultati alle pipeline con questo nome o a partire da questo nome. Esempi: "FabCI" o "Fab*".

--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

--query-order

Ordine dei risultati.

Proprietà	Valore
Valori accettati:	ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None

--repository

Limitare i risultati alle pipeline associate a questo repository.

--repository-type

Limitare i risultati alle pipeline associate a questo tipo di repository. È obbligatorio passare l'argomento 'repository' insieme a questo argomento.

Proprietà	Valore
Valori accettati:	bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol

--top

Numero massimo di pipeline da elencare.

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

az pipelines run

Accodamento (esecuzione) di una pipeline.

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

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--branch

Nome del ramo in cui deve essere accodata l'esecuzione della pipeline. Esempio: refs/heads/master o master o refs/pull/1/merge o refs/tags/tag.

--commit-id

Commit-id in cui deve essere accodata l'esecuzione della pipeline.

--detect

Riconoscere automaticamente l'organizzazione.

Proprietà	Valore
Valori accettati:	false, true

--folder-path

Percorso della cartella della pipeline. Il valore predefinito è la cartella a livello radice.

--id

ID della pipeline da accodare. Obbligatorio se --name non viene specificato.

--name

Nome della pipeline da accodare. Ignorato se viene specificato --id.

--open

Aprire la pagina dei risultati della pipeline nel Web browser.

Proprietà	Valore
Valore predefinito:	False

--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--parameters

Spaziare coppie "name=value" separate per i parametri da impostare.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

--variables

Spaziare coppie "name=value" separate per le variabili da impostare.

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

az pipelines show

Ottenere i dettagli di una pipeline.

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

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

Riconoscere automaticamente l'organizzazione.

Proprietà	Valore
Valori accettati:	false, true

--folder-path

Percorso della cartella della pipeline. Il valore predefinito è la cartella a livello radice.

--id

ID della pipeline.

--name

Nome della pipeline. Ignorato se viene specificato --id.

--open

Aprire la pagina di riepilogo della pipeline nel Web browser.

Proprietà	Valore
Valore predefinito:	False

--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False

az pipelines update

Aggiornare una pipeline.

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

Parametri necessari

--id

ID della pipeline da aggiornare.

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--branch

Nome del ramo per il quale verrà configurata la pipeline.

--description

Nuova descrizione per la pipeline.

--detect

Riconoscere automaticamente l'organizzazione.

Proprietà	Valore
Valori accettati:	false, true

--new-folder-path

Nuovo percorso completo della cartella in cui spostare la pipeline. ad esempio "user1/production_pipelines".

--new-name

Nuovo nome aggiornato della pipeline.

--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

--queue-id

ID coda del pool di agenti in cui deve essere eseguita la pipeline.

--yaml-path --yml-path

Percorso del file yaml delle pipeline nel repository.

Parametri globali

--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà	Valore
Valore predefinito:	False

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà	Valore
Valore predefinito:	False

--output -o

Output format.

Proprietà	Valore
Valore predefinito:	json
Valori accettati:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà	Valore
Valore predefinito:	False