Teilen ü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 wird automatisch installiert, wenn Sie einen Az Repos-Richtlinienbuild Befehl ausführen. Erfahren Sie mehr über Erweiterungen.

Buildrichtlinie verwalten.

Befehle

Name Beschreibung Typ Status
az repos policy build create

Erstellen Sie eine Buildrichtlinie.

 Erweiterung GA
az repos policy build update

Aktualisieren der Buildrichtlinie.

 Erweiterung GA

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

--path-filter

Filterpfade, auf die die Richtlinie angewendet wird. Unterstützt absolute Pfade, Wildcards 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 es nicht als Standard konfiguriert oder über git config übernommen wurde.

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 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 von Builds zulässig ist.

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

--path-filter

Filterpfade, auf die die Richtlinie angewendet wird. Unterstützt absolute Pfade, Wildcards 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 es nicht als Standard konfiguriert oder über git config übernommen wurde.

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

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.