Teilen über

az repos pr

  • Referenz

Hinweis

Diese Referenz ist Teil der azure-devops--Erweiterung für die Azure CLI (Version 2.30.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie ein az repos pr Befehl ausführen. Erfahren Sie mehr über Erweiterungen.

Verwalten von Pullanforderungen.

Befehle

Name Beschreibung Typ Status
az repos pr checkout

Auschecken des PR-Quellzweigs lokal, wenn keine lokalen Änderungen vorhanden sind.

 Erweiterung GA
az repos pr create

Erstellen Sie eine Pullanforderung.

 Erweiterung GA
az repos pr list

Pullanforderungen auflisten.

 Erweiterung GA
az repos pr policy

Verwalten sie die Pullanforderungsrichtlinie.

 Erweiterung GA
az repos pr policy list

Listen von Richtlinien einer Pullanforderung auf.

 Erweiterung GA
az repos pr policy queue

Eine Auswertung einer Richtlinie für eine Pullanforderung in die Warteschlange stellen.

 Erweiterung GA
az repos pr reviewer

Verwalten von Pull-Anforderungsprüfern.

 Erweiterung GA
az repos pr reviewer add

Fügen Sie einer Pullanforderung einen oder mehrere Bearbeiter hinzu.

 Erweiterung GA
az repos pr reviewer list

Prüfer einer Pullanforderung auflisten.

 Erweiterung GA
az repos pr reviewer remove

Entfernen Sie einen oder mehrere Bearbeiter aus einer Pullanforderung.

 Erweiterung GA
az repos pr set-vote

Stimmen Sie über einen Pull-Antrag ab.

 Erweiterung GA
az repos pr show

Rufen Sie die Details einer Pullanforderung ab.

 Erweiterung GA
az repos pr update

Aktualisieren einer Pullanforderung.

 Erweiterung GA
az repos pr work-item

Verwalten von Arbeitsaufgaben, die Pullanforderungen zugeordnet sind.

 Erweiterung GA
az repos pr work-item add

Verknüpfen Sie eine oder mehrere Arbeitsaufgaben mit einer Pullanforderung.

 Erweiterung GA
az repos pr work-item list

Listet verknüpfte Arbeitsaufgaben für eine Pullanforderung auf.

 Erweiterung GA
az repos pr work-item remove

Heben Sie die Verknüpfung einer oder mehrerer Arbeitsaufgaben aus einer Pullanforderung auf.

 Erweiterung GA

az repos pr checkout

Auschecken des PR-Quellzweigs lokal, wenn keine lokalen Änderungen vorhanden sind.

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

Erforderliche Parameter

--id

ID der Pullanforderung.

Optionale Parameter

--remote-name

Name des Git-Remote, mit dem PR ausgelöst wird.

Standardwert: origin
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az repos pr create

Erstellen Sie eine Pullanforderung.

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]
                   [--org]
                   [--project]
                   [--repository]
                   [--required-reviewers]
                   [--source-branch]
                   [--squash {false, true}]
                   [--target-branch]
                   [--title]
                   [--transition-work-items {false, true}]
                   [--work-items]

Optionale Parameter

--auto-complete

Legen Sie die Pullanforderung so fest, dass sie automatisch abgeschlossen wird, wenn alle Richtlinien übergeben wurden und der Quellzweig in die Ziel-Verzweigung zusammengeführt werden kann.

Zulässige Werte: false, true
Standardwert: False
--bypass-policy

Umgehen Sie erforderliche Richtlinien (falls vorhanden) und schließt die Pullanforderung ab, sobald sie zusammengeführt werden kann.

Zulässige Werte: false, true
Standardwert: False
--bypass-policy-reason

Grund für die Umgehung der erforderlichen Richtlinien.

--delete-source-branch

Löschen Sie den Quellzweig, nachdem die Pullanforderung abgeschlossen und mit der Ziel-Verzweigung zusammengeführt wurde.

Zulässige Werte: false, true
Standardwert: False
--description -d

Beschreibung für die neue Pullanforderung. Kann Markdown enthalten. Jeder wert, der an diese Arge gesendet wird, ist eine neue Zeile. Beispiel: --description "First Line" "Second Line".

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--draft

Verwenden Sie dieses Kennzeichen, um die Pullanforderung im Statusmodus "Entwurf/Arbeit" zu erstellen.

Zulässige Werte: false, true
--labels

Die Bezeichnungen, die der Pullanforderung zugeordnet sind. Leerzeichen getrennt.

--merge-commit-message

Meldung, die angezeigt wird, wenn Commits zusammengeführt werden.

--open

Öffnen Sie die Pull-Anforderung in Ihrem Webbrowser.

Standardwert: False
--optional-reviewers --reviewers

Zusätzliche Benutzer oder Gruppen, die als optionale Prüfer in die neue Pullanforderung einbezogen werden sollen. Leerzeichen getrennt.

--org --organization

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

--project -p

Name oder ID des Projekts. Sie können das Standardprojekt mit az devops configure -d project=NAME_OR_ID konfigurieren. Erforderlich, wenn es nicht als Standard konfiguriert oder über git config übernommen wurde.

--repository -r

Name oder ID des Repositorys, um die Pullanforderung zu erstellen.

--required-reviewers

Zusätzliche Benutzer oder Gruppen, die als erforderliche Prüfer in die neue Pullanforderung einbezogen werden sollen. Leerzeichen getrennt.

--source-branch -s

Name des Quellzweigs. Beispiel: "dev".

--squash

Die Commits werden beim Zusammenführen in die Ziel-Verzweigung in der Quellzweige eingegliedert.

Zulässige Werte: false, true
Standardwert: False
--target-branch -t

Name des Zielzweigs. Wenn nicht angegeben, wird standardmäßig der Standardverzweigung des Ziel-Repositorys verwendet.

--title

Titel für die neue Pullanforderung.

--transition-work-items

Übergehen Sie alle Arbeitsaufgaben, die mit der Pullanforderung verknüpft sind, in den nächsten logischen Zustand. (z. B. Aktiv -> aufgelöst).

Zulässige Werte: false, true
Standardwert: False
--work-items

IDs der Arbeitsaufgaben, die mit der neuen Pullanforderung verknüpft werden sollen. Leerzeichen getrennt.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az repos pr list

Pullanforderungen auflisten.

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

Optionale Parameter

--creator

Beschränken Sie die Ergebnisse auf Pullanforderungen, die von diesem Benutzer erstellt wurden.

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--include-links

Schließen Sie _links für jede Pullanforderung ein.

Standardwert: False
--org --organization

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

--project -p

Name oder ID des Projekts. Sie können das Standardprojekt mit az devops configure -d project=NAME_OR_ID konfigurieren. Erforderlich, wenn es nicht als Standard konfiguriert oder über git config übernommen wurde.

--repository -r

Name oder ID des Repositorys.

--reviewer

Beschränken Sie die Ergebnisse auf Pullanforderungen, bei denen dieser Benutzer ein Bearbeiter ist.

--skip

Anzahl der Pullanforderungen, die übersprungen werden sollen.

--source-branch -s

Beschränken Sie die Ergebnisse auf Pullanforderungen, die aus diesem Quellzweig stammen.

--status

Beschränken Sie die Ergebnisse auf Pullanforderungen mit diesem Status.

Zulässige Werte: abandoned, active, all, completed
--target-branch -t

Beschränken Sie die Ergebnisse auf Pullanforderungen, die auf diese Verzweigung abzielen.

--top

Maximale Anzahl von Pullanforderungen für die Liste.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az repos pr set-vote

Stimmen Sie über einen Pull-Antrag ab.

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

Erforderliche Parameter

--id

ID der Pullanforderung.

--vote

Neuer Abstimmungswert für die Pullanforderung.

Zulässige Werte: approve, approve-with-suggestions, reject, reset, wait-for-author

Optionale Parameter

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--org --organization

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az repos pr show

Rufen Sie die Details einer Pullanforderung ab.

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

Erforderliche Parameter

--id

ID der Pullanforderung.

Optionale Parameter

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--open

Öffnen Sie die Pull-Anforderung in Ihrem Webbrowser.

Standardwert: False
--org --organization

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az repos pr update

Aktualisieren einer Pullanforderung.

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]
                   [--squash {false, true}]
                   [--status {abandoned, active, completed}]
                   [--title]
                   [--transition-work-items {false, true}]

Erforderliche Parameter

--id

ID der Pullanforderung.

Optionale Parameter

--auto-complete

Legen Sie die Pullanforderung so fest, dass sie automatisch abgeschlossen wird, wenn alle Richtlinien übergeben wurden und der Quellzweig in die Ziel-Verzweigung zusammengeführt werden kann.

Zulässige Werte: false, true
--bypass-policy

Umgehen Sie erforderliche Richtlinien (falls vorhanden) und schließt die Pullanforderung ab, sobald sie zusammengeführt werden kann.

Zulässige Werte: false, true
--bypass-policy-reason

Grund für die Umgehung der erforderlichen Richtlinien.

--delete-source-branch

Löschen Sie den Quellzweig, nachdem die Pullanforderung abgeschlossen und mit der Ziel-Verzweigung zusammengeführt wurde.

Zulässige Werte: false, true
--description -d

Neue Beschreibung für die Pullanforderung. Kann Markdown enthalten. Jeder wert, der an diese Arge gesendet wird, ist eine neue Zeile. Beispiel: --description "First Line" "Second Line".

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--draft

Veröffentlichen Sie die PR, oder konvertieren Sie sie in den Entwurfsmodus.

Zulässige Werte: false, true
--merge-commit-message

Meldung, die angezeigt wird, wenn Commits zusammengeführt werden.

--org --organization

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

--squash

Die Commits werden beim Zusammenführen in die Ziel-Verzweigung in der Quellzweige eingegliedert.

Zulässige Werte: false, true
--status

Legen Sie den neuen Status der Pullanforderung fest.

Zulässige Werte: abandoned, active, completed
--title

Neuer Titel für die Pullanforderung.

--transition-work-items

Übergehen Sie alle Arbeitsaufgaben, die mit der Pullanforderung verknüpft sind, in den nächsten logischen Zustand. (z. B. Aktiv -> aufgelöst).

Zulässige Werte: false, true
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.