Share via

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 einen az repos pr-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten von Pull Requests

Befehle

Name Beschreibung Typ Status
az repos pr checkout

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

 Erweiterung Allgemein verfügbar
az repos pr create

Erstellen Sie einen Pull Request.

 Erweiterung Allgemein verfügbar
az repos pr list

Pullanforderungen auflisten.

 Erweiterung Allgemein verfügbar
az repos pr policy

Verwalten sie die Pullanforderungsrichtlinie.

 Erweiterung Allgemein verfügbar
az repos pr policy list

Listen von Richtlinien einer Pullanforderung auf.

 Erweiterung Allgemein verfügbar
az repos pr policy queue

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

 Erweiterung Allgemein verfügbar
az repos pr reviewer

Verwalten von Pull Request-Reviewern

 Erweiterung Allgemein verfügbar
az repos pr reviewer add

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

 Erweiterung Allgemein verfügbar
az repos pr reviewer list

Prüfer einer Pullanforderung auflisten.

 Erweiterung Allgemein verfügbar
az repos pr reviewer remove

Entfernen Sie einen oder mehrere Bearbeiter aus einer Pullanforderung.

 Erweiterung Allgemein verfügbar
az repos pr set-vote

Stimmen Sie über einen Pull-Antrag ab.

 Erweiterung Allgemein verfügbar
az repos pr show

Rufen Sie die Details einer Pullanforderung ab.

 Erweiterung Allgemein verfügbar
az repos pr update

Aktualisieren einer Pullanforderung.

 Erweiterung Allgemein verfügbar
az repos pr work-item

Verwalten von Arbeitsaufgaben, die Pullanforderungen zugeordnet sind.

 Erweiterung Allgemein verfügbar
az repos pr work-item add

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

 Erweiterung Allgemein verfügbar
az repos pr work-item list

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

 Erweiterung Allgemein verfügbar
az repos pr work-item remove

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

 Erweiterung Allgemein verfügbar

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 des Pull Requests.

Optionale Parameter

--remote-name

Name des Git-Remoteservers, für den ein PR ausgelöst wird.

Standardwert: origin
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az repos pr create

Erstellen Sie einen Pull Request.

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 fest, dass der Pull Request automatisch abgeschlossen wird, wenn alle Richtlinien erfüllt sind und der Quellbranch in den Zielbranch 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. Durch Leerzeichen getrennt.

--merge-commit-message

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

--open

Öffnen Sie den Pull Request 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. Durch Leerzeichen getrennt.

--org --organization

Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. 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 nicht als „Standard“ konfiguriert oder über „git config“ übernommen.

--repository -r

Name oder ID des Repositorys, in dem der Pull Request erstellt werden soll.

--required-reviewers

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

--source-branch -s

Name des Quellbranchs. Beispiel: "dev".

--squash

Führen Sie für die Commits im Quellbranch beim Mergen in den Zielbranch einen Squashmerge aus.

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

Name des Zielbranchs. Sofern nicht angegeben, wird standardmäßig der Standardbranch des Zielrepositorys verwendet.

--title

Titel für den neuen Pull Request.

--transition-work-items

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

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

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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 Pull Requests, die von diesem Benutzer erstellt wurden.

--detect

Organisation automatisch erkennen.

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

Beziehen Sie _links für jeden Pull Request ein.

Standardwert: False
--org --organization

Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. 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 sie nicht als Standard konfiguriert oder über die Git-Konfiguration verwendet werden.

--repository -r

Name oder ID des Repositorys.

--reviewer

Beschränken Sie die Ergebnisse auf Pull Requests, bei denen dieser Benutzer ein Reviewer ist.

--skip

Anzahl der zu überspringenden Pull Requests.

--source-branch -s

Beschränken Sie die Ergebnisse auf Pull Requests, die aus diesem Quellbranch stammen.

--status

Beschränken Sie die Ergebnisse auf Pull Requests mit diesem Status.

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

Beschränken Sie die Ergebnisse auf Pull Requests, die auf diesen Branch abzielen.

--top

Maximale Anzahl von aufzulistenden Pull Requests.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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 des Pull Requests.

--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-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. Beispiel: https://dev.azure.com/MyOrganizationName/

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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 des Pull Requests.

Optionale Parameter

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--open

Öffnen Sie den Pull Request in Ihrem Webbrowser.

Standardwert: False
--org --organization

Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. Beispiel: https://dev.azure.com/MyOrganizationName/

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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 des Pull Requests.

Optionale Parameter

--auto-complete

Legen Sie fest, dass der Pull Request automatisch abgeschlossen wird, wenn alle Richtlinien erfüllt sind und der Quellbranch in den Zielbranch 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 den Pull Request. 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-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. Beispiel: https://dev.azure.com/MyOrganizationName/

--squash

Führen Sie für die Commits im Quellbranch beim Mergen in den Zielbranch einen Squashmerge aus.

Zulässige Werte: false, true
--status

Legen Sie den neuen Status für den Pull Request fest.

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

Neuer Titel für den Pull Request.

--transition-work-items

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

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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.