az repos pr
Note
Den här referensen är en del av tillägget azure-devops för Azure CLI (version 2.30.0 eller senare). Tillägget installeras automatiskt första gången du kör ett kommandot az repos pr. Läs mer om tillägg.
Hantera pull-begäranden.
Kommandon
| Name | Description | Typ | Status |
|---|---|---|---|
| az repos pr checkout |
Checka ut PR-källgrenen lokalt om det inte finns några lokala ändringar. |
Extension | GA |
| az repos pr create |
Skapa en pull-begäran. |
Extension | GA |
| az repos pr list |
Lista pull-begäranden. |
Extension | GA |
| az repos pr policy |
Hantera pull-begärandeprincip. |
Extension | GA |
| az repos pr policy list |
Lista principer för en pull-begäran. |
Extension | GA |
| az repos pr policy queue |
Köa en utvärdering av en princip för en pull-begäran. |
Extension | GA |
| az repos pr reviewer |
Hantera granskare av pull-begäranden. |
Extension | GA |
| az repos pr reviewer add |
Lägg till en eller flera granskare i en pull-begäran. |
Extension | GA |
| az repos pr reviewer list |
Visa en lista över granskare av en pull-begäran. |
Extension | GA |
| az repos pr reviewer remove |
Ta bort en eller flera granskare från en pull-begäran. |
Extension | GA |
| az repos pr set-vote |
Rösta på en pull-begäran. |
Extension | GA |
| az repos pr show |
Hämta information om en pull-begäran. |
Extension | GA |
| az repos pr update |
Uppdatera en pull-begäran. |
Extension | GA |
| az repos pr work-item |
Hantera arbetsobjekt som är associerade med pull-begäranden. |
Extension | GA |
| az repos pr work-item add |
Länka ett eller flera arbetsobjekt till en pull-begäran. |
Extension | GA |
| az repos pr work-item list |
Lista länkade arbetsobjekt för en pull-begäran. |
Extension | GA |
| az repos pr work-item remove |
Ta bort länk till ett eller flera arbetsobjekt från en pull-begäran. |
Extension | GA |
az repos pr checkout
Checka ut PR-källgrenen lokalt om det inte finns några lokala ändringar.
az repos pr checkout --id
[--acquire-policy-token]
[--change-reference]
[--remote-name]
Obligatoriska parametrar
ID för pull-begäran.
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.
Hämtar en Azure Policy token automatiskt för den här resursåtgärden.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Global Policy Arguments |
Det relaterade ändringsreferens-ID:t för den här resursåtgärden.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Global Policy Arguments |
Namnet på den git-fjärranslutning mot vilken PR har skapats.
| Egenskap | Värde |
|---|---|
| Standardvärde: | origin |
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
az repos pr create
Skapa en pull-begäran.
az repos pr create [--acquire-policy-token]
[--auto-complete {false, true}]
[--bypass-policy {false, true}]
[--bypass-policy-reason]
[--change-reference]
[--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]
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.
Hämtar en Azure Policy token automatiskt för den här resursåtgärden.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Global Policy Arguments |
Ställ in pull-begäran så att den slutförs automatiskt när alla principer har passerat och källgrenen kan sammanfogas till målgrenen.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
| Godkända värden: | false, true |
Kringgå nödvändiga principer (om några) och slutför pull-begäran när den kan sammanfogas.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
| Godkända värden: | false, true |
Orsak till att kringgå de principer som krävs.
Det relaterade ändringsreferens-ID:t för den här resursåtgärden.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Global Policy Arguments |
Ta bort källgrenen när pull-begäran har slutförts och sammanfogats till målgrenen.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
| Godkända värden: | false, true |
Beskrivning för den nya pull-begäran. Kan innehålla markdown. Varje värde som skickas till denna arg blir en ny rad. Exempel: --description "First Line" "Second Line".
Identifiera organisationen automatiskt.
| Egenskap | Värde |
|---|---|
| Godkända värden: | false, true |
Använd den här flaggan för att skapa pull-begäran i utkast/arbete i förloppsläge.
| Egenskap | Värde |
|---|---|
| Godkända värden: | false, true |
Etiketterna som är associerade med pull-begäran. Mellanslag separerade.
Meddelande som visas när incheckningar sammanfogas.
Öppna pull-begäran i webbläsaren.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Ytterligare användare eller grupper som ska inkluderas som valfria granskare i den nya pull-begäran. Mellanslag separerade.
Azure DevOps organisations-URL. 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/.
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.
Namn eller ID för lagringsplatsen för att skapa pull-begäran.
Ytterligare användare eller grupper som ska inkluderas som nödvändiga granskare för den nya pull-begäran. Mellanslag separerade.
Namnet på källgrenen. Exempel: "dev".
Slå samman incheckningarna i källgrenen när du sammanfogar till målgrenen.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
| Godkända värden: | false, true |
Namn på målgrenen. Om det inte anges används standardgrenen för mållagringsplatsen.
Rubrik för den nya pull-begäran.
Flytta alla arbetsobjekt som är länkade till pull-begäran till nästa logiska tillstånd. (t.ex. Aktiv –> Löst).
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
| Godkända värden: | false, true |
ID:n för de arbetsobjekt som ska länkas till den nya pull-begäran. Mellanslag separerade.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
az repos pr list
Lista pull-begäranden.
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]
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.
Begränsa resultatet till pull-begäranden som skapats av den här användaren.
Identifiera organisationen automatiskt.
| Egenskap | Värde |
|---|---|
| Godkända värden: | false, true |
Inkludera _links för varje pull request.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Azure DevOps organisations-URL. 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/.
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.
Namn eller ID för lagringsplatsen.
Begränsa resultatet till pull-begäranden där den här användaren är granskare.
Antal pull-begäranden att hoppa över.
Begränsa resultatet till pull-begäranden som kommer från den här källgrenen.
Begränsa resultatet till pull-begäranden med den här statusen.
| Egenskap | Värde |
|---|---|
| Godkända värden: | abandoned, active, all, completed |
Begränsa resultatet till pull-begäranden som riktar sig mot den här grenen.
Maximalt antal pull-begäranden som ska listas.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
az repos pr set-vote
Rösta på en pull-begäran.
az repos pr set-vote --id
--vote {approve, approve-with-suggestions, reject, reset, wait-for-author}
[--acquire-policy-token]
[--change-reference]
[--detect {false, true}]
[--org --organization]
Obligatoriska parametrar
ID för pull-begäran.
Nytt röstvärde för pull-begäran.
| Egenskap | Värde |
|---|---|
| Godkända värden: | approve, approve-with-suggestions, reject, reset, wait-for-author |
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.
Hämtar en Azure Policy token automatiskt för den här resursåtgärden.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Global Policy Arguments |
Det relaterade ändringsreferens-ID:t för den här resursåtgärden.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Global Policy Arguments |
Identifiera organisationen automatiskt.
| Egenskap | Värde |
|---|---|
| Godkända värden: | false, true |
Azure DevOps organisations-URL. 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/.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
az repos pr show
Hämta information om en pull-begäran.
az repos pr show --id
[--detect {false, true}]
[--open]
[--org --organization]
Obligatoriska parametrar
ID för pull-begäran.
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.
Identifiera organisationen automatiskt.
| Egenskap | Värde |
|---|---|
| Godkända värden: | false, true |
Öppna pull-begäran i webbläsaren.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Azure DevOps organisations-URL. 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/.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
az repos pr update
Uppdatera en pull-begäran.
az repos pr update --id
[--acquire-policy-token]
[--auto-complete {false, true}]
[--bypass-policy {false, true}]
[--bypass-policy-reason]
[--change-reference]
[--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}]
Obligatoriska parametrar
ID för pull-begäran.
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.
Hämtar en Azure Policy token automatiskt för den här resursåtgärden.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Global Policy Arguments |
Ställ in pull-begäran så att den slutförs automatiskt när alla principer har passerat och källgrenen kan sammanfogas till målgrenen.
| Egenskap | Värde |
|---|---|
| Godkända värden: | false, true |
Kringgå nödvändiga principer (om några) och slutför pull-begäran när den kan sammanfogas.
| Egenskap | Värde |
|---|---|
| Godkända värden: | false, true |
Orsak till att kringgå de principer som krävs.
Det relaterade ändringsreferens-ID:t för den här resursåtgärden.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Global Policy Arguments |
Ta bort källgrenen när pull-begäran har slutförts och sammanfogats till målgrenen.
| Egenskap | Värde |
|---|---|
| Godkända värden: | false, true |
Ny beskrivning för pull-begäran. Kan innehålla markdown. Varje värde som skickas till denna arg blir en ny rad. Exempel: --description "First Line" "Second Line".
Identifiera organisationen automatiskt.
| Egenskap | Värde |
|---|---|
| Godkända värden: | false, true |
Publicera PR eller konvertera till utkastläge.
| Egenskap | Värde |
|---|---|
| Godkända värden: | false, true |
Meddelande som visas när incheckningar sammanfogas.
Azure DevOps organisations-URL. 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/.
Slå samman incheckningarna i källgrenen när du sammanfogar till målgrenen.
| Egenskap | Värde |
|---|---|
| Godkända värden: | false, true |
Ange det nya tillståndet för pull-begäran.
| Egenskap | Värde |
|---|---|
| Godkända värden: | abandoned, active, completed |
Ny rubrik för pull-begäran.
Flytta alla arbetsobjekt som är länkade till pull-begäran till nästa logiska tillstånd. (t.ex. Aktiv –> Löst).
| Egenskap | Värde |
|---|---|
| Godkända värden: | false, true |
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |