az pipelines

Nota

Questo riferimento fa parte dell'estensione azure-devops per l'interfaccia della riga di comando di Azure (versione 2.30.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az pipelines . Altre informazioni sulle estensioni.

Gestire Azure Pipelines.

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

Comandi

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

az pipelines create

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

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]

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

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

Rilevare automaticamente l'organizzazione.

valori accettati: false, true

--folder-path

Percorso della cartella in cui deve essere creata la pipeline. Il valore predefinito è la cartella radice. ad esempio "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.

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.

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

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

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

--subscription

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

--verbose

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

az pipelines delete

Eliminare una pipeline.

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

Parametri necessari

--id

ID della pipeline.

Parametri facoltativi

--detect

Rilevare automaticamente l'organizzazione.

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

Indica che non è richiesta la conferma.

valore predefinito: False

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

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

--subscription

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

--verbose

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

az pipelines list

Elencare le pipeline.

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]

Parametri facoltativi

--detect

Rilevare automaticamente l'organizzazione.

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.

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.

valori accettati: bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol

--top

Numero massimo di pipeline da elencare.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

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

--subscription

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

--verbose

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

az pipelines run

Accodamento (esecuzione) di una pipeline.

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

Parametri facoltativi

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

Rilevare automaticamente l'organizzazione.

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.

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

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

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

--subscription

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

--verbose

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

az pipelines show

Ottenere i dettagli di una pipeline.

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

Parametri facoltativi

--detect

Rilevare automaticamente l'organizzazione.

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.

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

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

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

--subscription

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

--verbose

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

az pipelines update

Aggiornare una pipeline.

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

Parametri necessari

--id

ID della pipeline da aggiornare.

Parametri facoltativi

--branch

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

--description

Nuova descrizione per la pipeline.

--detect

Rilevare automaticamente l'organizzazione.

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

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

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

--subscription

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

--verbose

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