az repos pr

Note

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 repos pr . Altre informazioni sulle estensioni.

Gestire le richieste pull.

Comandi

Nome	Descrizione	Tipo	Status
az repos pr checkout	Eseguire il checkout del ramo di origine della richiesta pull in locale, se non sono presenti modifiche locali.	Extension	GA
az repos pr create	Creare una richiesta pull.	Extension	GA
az repos pr list	Elencare le richieste pull.	Extension	GA
az repos pr policy	Gestire i criteri di richiesta pull.	Extension	GA
az repos pr policy list	Elencare i criteri di una richiesta pull.	Extension	GA
az repos pr policy queue	Accoda una valutazione di un criterio per una richiesta pull.	Extension	GA
az repos pr reviewer	Gestire i revisori delle richieste pull.	Extension	GA
az repos pr reviewer add	Aggiungere uno o più revisori a una richiesta pull.	Extension	GA
az repos pr reviewer list	Elencare i revisori di una richiesta pull.	Extension	GA
az repos pr reviewer remove	Rimuovere uno o più revisori da una richiesta pull.	Extension	GA
az repos pr set-vote	Votare su una richiesta pull.	Extension	GA
az repos pr show	Ottenere i dettagli di una richiesta pull.	Extension	GA
az repos pr update	Aggiornare una richiesta pull.	Extension	GA
az repos pr work-item	Gestire gli elementi di lavoro associati alle richieste pull.	Extension	GA
az repos pr work-item add	Collegare uno o più elementi di lavoro a una richiesta pull.	Extension	GA
az repos pr work-item list	Elencare gli elementi di lavoro collegati per una richiesta pull.	Extension	GA
az repos pr work-item remove	Scollegare uno o più elementi di lavoro da una richiesta pull.	Extension	GA

az repos pr checkout

Eseguire il checkout del ramo di origine della richiesta pull in locale, se non sono presenti modifiche locali.

az repos pr checkout --id
                     [--remote-name]

Parametri necessari

--id

ID della richiesta di pull.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--remote-name

Nome del git remote in base al quale viene fatta la pull request.

Proprietà	Valore
Valore predefinito:	origin

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

Formato dell'output.

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 repos pr create

Creare una richiesta pull.

az repos pr create [--auto-complete {false, true}]
                   [--bypass-policy {false, true}]
                   [--bypass-policy-reason]
                   [--delete-source-branch {false, true}]
                   [--description]
                   [--detect {false, true}]
                   [--draft {false, true}]
                   [--labels]
                   [--merge-commit-message]
                   [--open]
                   [--optional-reviewers --reviewers]
                   [--org --organization]
                   [--project]
                   [--repository]
                   [--required-reviewers]
                   [--source-branch]
                   [--squash {false, true}]
                   [--target-branch]
                   [--title]
                   [--transition-work-items {false, true}]
                   [--work-items]

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--auto-complete

Impostare la richiesta pull da completare automaticamente quando tutti i criteri sono stati superati e il ramo di origine può essere unito al ramo di destinazione.

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

--bypass-policy

Ignorare i criteri obbligatori (se presenti) e completa la richiesta pull una volta che può essere unita.

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

--bypass-policy-reason

Motivo per ignorare i criteri richiesti.

--delete-source-branch

Eliminare il ramo di origine dopo che la richiesta pull è stata completata e unita nel ramo di destinazione.

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

--description -d

Descrizione per la nuova richiesta pull. Può includere markdown. Ogni valore inviato a questo argomento sarà una nuova riga. Ad esempio: --description "Prima riga" "Seconda riga".

--detect

Riconoscere automaticamente l'organizzazione.

Proprietà	Valore
Valori accettati:	false, true

--draft

Usare questo flag per creare la richiesta pull in modalità bozza/lavoro in corso.

Proprietà	Valore
Valori accettati:	false, true

--labels

Etichette associate alla richiesta pull. Spazio separato.

--merge-commit-message

Messaggio visualizzato quando vengono uniti i commit.

--open

Apri la pull request nel tuo browser web.

Proprietà	Valore
Valore predefinito:	False

--optional-reviewers --reviewers

Altri utenti o gruppi da includere come revisori facoltativi nella nuova richiesta pull. Spazio separato.

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

--repository -r

Nome o ID del repository in cui creare la richiesta pull.

--required-reviewers

Altri utenti o gruppi da includere come revisori necessari nella nuova richiesta pull. Spazio separato.

--source-branch -s

Nome del ramo di origine. Esempio: "dev".

--squash

Eseguire lo squash dei commit nel ramo di origine durante l'unione nel ramo di destinazione.

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

--target-branch -t

Nome del ramo di destinazione. Se non specificato, per impostazione predefinita viene impostato il ramo predefinito del repository di destinazione.

--title

Titolo per la nuova richiesta pull.

--transition-work-items

Eseguire la transizione di tutti gli elementi di lavoro collegati alla richiesta pull nello stato logico successivo. (ad esempio, Attivo -> risolto).

Proprietà	Valore
Valore predefinito:	False
Valori accettati:	false, true

--work-items

ID degli elementi di lavoro da collegare alla nuova richiesta pull. Spazio separato.

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

Formato dell'output.

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 repos pr list

Elencare le richieste pull.

az repos pr list [--creator]
                 [--detect {false, true}]
                 [--include-links]
                 [--org --organization]
                 [--project]
                 [--repository]
                 [--reviewer]
                 [--skip]
                 [--source-branch]
                 [--status {abandoned, active, all, completed}]
                 [--target-branch]
                 [--top]

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--creator

Limitare i risultati ai pull request creati da questo utente.

--detect

Riconoscere automaticamente l'organizzazione.

Proprietà	Valore
Valori accettati:	false, true

--include-links

Includere _links per ciascuna richiesta di pull.

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.

--repository -r

Nome o ID del repository.

--reviewer

Limitare i risultati alle richieste pull in cui l'utente è un revisore.

--skip

Numero di richieste pull da ignorare.

--source-branch -s

Limitare i risultati alle pull request provenienti da questo ramo di origine.

--status

Limitare i risultati ai pull request con questo stato.

Proprietà	Valore
Valori accettati:	abandoned, active, all, completed

--target-branch -t

Limitare i risultati alle pull request destinate a questo ramo.

--top

Numero massimo di richieste pull 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

Formato dell'output.

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 repos pr set-vote

Votare su una richiesta pull.

az repos pr set-vote --id
                     --vote {approve, approve-with-suggestions, reject, reset, wait-for-author}
                     [--detect {false, true}]
                     [--org --organization]

Parametri necessari

--id

ID della richiesta di pull.

--vote

Nuovo valore di voto per la richiesta pull.

Proprietà	Valore
Valori accettati:	approve, approve-with-suggestions, reject, reset, wait-for-author

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

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

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

Formato dell'output.

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 repos pr show

Ottenere i dettagli di una richiesta pull.

az repos pr show --id
                 [--detect {false, true}]
                 [--open]
                 [--org --organization]

Parametri necessari

--id

ID della richiesta di pull.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--detect

Riconoscere automaticamente l'organizzazione.

Proprietà	Valore
Valori accettati:	false, true

--open

Apri la pull request nel tuo browser web.

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

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

Formato dell'output.

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 repos pr update

Aggiornare una richiesta pull.

az repos pr update --id
                   [--auto-complete {false, true}]
                   [--bypass-policy {false, true}]
                   [--bypass-policy-reason]
                   [--delete-source-branch {false, true}]
                   [--description]
                   [--detect {false, true}]
                   [--draft {false, true}]
                   [--merge-commit-message]
                   [--org --organization]
                   [--squash {false, true}]
                   [--status {abandoned, active, completed}]
                   [--title]
                   [--transition-work-items {false, true}]

Parametri necessari

--id

ID della richiesta di pull.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--auto-complete

Impostare la richiesta pull da completare automaticamente quando tutti i criteri sono stati superati e il ramo di origine può essere unito al ramo di destinazione.

Proprietà	Valore
Valori accettati:	false, true

--bypass-policy

Ignorare i criteri obbligatori (se presenti) e completa la richiesta pull una volta che può essere unita.

Proprietà	Valore
Valori accettati:	false, true

--bypass-policy-reason

Motivo per ignorare i criteri richiesti.

--delete-source-branch

Eliminare il ramo di origine dopo che la richiesta pull è stata completata e unita nel ramo di destinazione.

Proprietà	Valore
Valori accettati:	false, true

--description -d

Nuova descrizione per la richiesta pull. Può includere markdown. Ogni valore inviato a questo argomento sarà una nuova riga. Ad esempio: --description "Prima riga" "Seconda riga".

--detect

Riconoscere automaticamente l'organizzazione.

Proprietà	Valore
Valori accettati:	false, true

--draft

Pubblicare la richiesta pull o convertirla in modalità bozza.

Proprietà	Valore
Valori accettati:	false, true

--merge-commit-message

Messaggio visualizzato quando vengono uniti i commit.

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

--squash

Eseguire lo squash dei commit nel ramo di origine durante l'unione nel ramo di destinazione.

Proprietà	Valore
Valori accettati:	false, true

--status

Impostare il nuovo stato della richiesta pull.

Proprietà	Valore
Valori accettati:	abandoned, active, completed

--title

Nuovo titolo per la richiesta pull.

--transition-work-items

Eseguire la transizione di tutti gli elementi di lavoro collegati alla richiesta pull nello stato logico successivo. (ad esempio, Attivo -> risolto).

Proprietà	Valore
Valori accettati:	false, true

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

Formato dell'output.

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