Freigeben über

az repos policy build

  • Referenz

Hinweis

Diese Referenz ist Teil der Azure-devops-Erweiterung für die Azure CLI (Version 2.30.0 oder höher). Die Erweiterung installiert automatisch, wenn Sie einen Az Repos-Richtlinienbuildbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Buildrichtlinie verwalten.

Befehle

Name Beschreibung Typ Status
az repos policy build create

Erstellen Sie eine Buildrichtlinie.

 Durchwahl Allgemein verfügbar
az repos policy build update

Aktualisieren der Buildrichtlinie.

 Durchwahl Allgemein verfügbar

az repos policy build create

Erstellen Sie eine Buildrichtlinie.

az repos policy build create --blocking {false, true}
                             --branch
                             --build-definition-id
                             --display-name
                             --enabled {false, true}
                             --manual-queue-only {false, true}
                             --queue-on-source-update-only {false, true}
                             --repository-id
                             --valid-duration
                             [--branch-match-type {exact, prefix}]
                             [--detect {false, true}]
                             [--org]
                             [--path-filter]
                             [--project]

Erforderliche Parameter

--blocking

Gibt an, ob die Richtlinie blockiert werden soll.

Zulässige Werte: false, true
--branch

Verzweigung, auf die diese Richtlinie angewendet werden soll. Beispiel: Master.

--build-definition-id

Builddefinitions-ID.

--display-name

Anzeigename für diese Buildrichtlinie, um die Richtlinie zu identifizieren. Beispiel: "Manuelle Warteschlangenrichtlinie".

--enabled

Gibt an, ob die Richtlinie aktiviert ist.

Zulässige Werte: false, true
--manual-queue-only

Gibt an, ob nur die manuelle Warteschlange für Builds zulässig ist.

Zulässige Werte: false, true
--queue-on-source-update-only

Warteschlange nur beim Quellupdate.

Zulässige Werte: false, true
--repository-id

ID des Repositorys, auf das die Richtlinie angewendet werden soll.

--valid-duration

Gültigkeitsdauer der Richtlinie (in Minuten).

Optionale Parameter

--branch-match-type

Bestimmt, wie das Branch-Argument verwendet wird, um eine Richtlinie anzuwenden. Wenn der Wert "exact" ist, wird die Richtlinie auf eine Verzweigung angewendet, die eine genaue Übereinstimmung für das Argument "-branch" aufweist. Wenn der Wert "Präfix" ist, wird die Richtlinie auf alle Verzweigungsordner angewendet, die dem präfix entsprechen, das vom Argument "-branch" bereitgestellt wird.

Zulässige Werte: exact, prefix
Standardwert: exact
--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/

--path-filter

Filterpfade, auf die die Richtlinie angewendet wird. Unterstützt absolute Pfade, Wild Karte s und mehrere Durch ';' getrennte Pfade. Beispiel: /WebApp/Models/Data.cs, /WebApp/* oder *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

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

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 policy build update

Aktualisieren der Buildrichtlinie.

az repos policy build update --id
                             [--blocking {false, true}]
                             [--branch]
                             [--branch-match-type {exact, prefix}]
                             [--build-definition-id]
                             [--detect {false, true}]
                             [--display-name]
                             [--enabled {false, true}]
                             [--manual-queue-only {false, true}]
                             [--org]
                             [--path-filter]
                             [--project]
                             [--queue-on-source-update-only {false, true}]
                             [--repository-id]
                             [--valid-duration]

Erforderliche Parameter

--id --policy-id

ID der Richtlinie.

Optionale Parameter

--blocking

Gibt an, ob die Richtlinie blockiert werden soll.

Zulässige Werte: false, true
--branch

Verzweigung, auf die diese Richtlinie angewendet werden soll. Beispiel: Master.

--branch-match-type

Bestimmt, wie das Branch-Argument verwendet wird, um eine Richtlinie anzuwenden. Wenn der Wert "exact" ist, wird die Richtlinie auf eine Verzweigung angewendet, die eine genaue Übereinstimmung für das Argument "-branch" aufweist. Wenn der Wert "Präfix" ist, wird die Richtlinie auf alle Verzweigungsordner angewendet, die dem präfix entsprechen, das vom Argument "-branch" bereitgestellt wird.

Zulässige Werte: exact, prefix
--build-definition-id

Builddefinitions-ID.

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--display-name

Anzeigename für diese Buildrichtlinie, um die Richtlinie zu identifizieren. Beispiel: "Manuelle Warteschlangenrichtlinie".

--enabled

Gibt an, ob die Richtlinie aktiviert ist.

Zulässige Werte: false, true
--manual-queue-only

Gibt an, ob nur die manuelle Warteschlange für Builds zulässig ist.

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/

--path-filter

Filterpfade, auf die die Richtlinie angewendet wird. Unterstützt absolute Pfade, Wild Karte s und mehrere Durch ';' getrennte Pfade. Beispiel: /WebApp/Models/Data.cs, /WebApp/* oder *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

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

--queue-on-source-update-only

Warteschlange nur beim Quellupdate.

Zulässige Werte: false, true
--repository-id

ID des Repositorys, auf das die Richtlinie angewendet werden soll.

--valid-duration

Gültigkeitsdauer der Richtlinie (in Minuten).

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.