Udostępnij przez

az repos policy build

Note

Ta dokumentacja jest częścią rozszerzenia azure-devops dla interfejsu wiersza polecenia platformy Azure (wersja 2.30.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az repos policy build. Dowiedz się więcej o rozszerzeniach.

Zarządzanie zasadami kompilacji.

Polecenia

Nazwa Opis Typ Stan
az repos policy build create

Tworzenie zasad kompilacji.

 Extension ogólna dostępność
az repos policy build update

Aktualizowanie zasad kompilacji.

 Extension ogólna dostępność

az repos policy build create

Tworzenie zasad kompilacji.

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 --organization]
                             [--path-filter]
                             [--project]

Parametry wymagane

--blocking

Czy zasady powinny być blokowane, czy nie.

Właściwość Wartość
Dopuszczalne wartości: false, true
--branch

Gałąź, na której mają być stosowane te zasady. Na przykład: master.

--build-definition-id

Identyfikator definicji kompilacji.

--display-name

Nazwa wyświetlana dla tych zasad kompilacji w celu zidentyfikowania zasad. Na przykład: "Zasady kolejki ręcznej".

--enabled

Bez względu na to, czy zasady są włączone, czy nie.

Właściwość Wartość
Dopuszczalne wartości: false, true
--manual-queue-only

Czy zezwalać tylko na ręczną kolejkę kompilacji.

Właściwość Wartość
Dopuszczalne wartości: false, true
--queue-on-source-update-only

Kolejka tylko w przypadku aktualizacji źródłowej.

Właściwość Wartość
Dopuszczalne wartości: false, true
--repository-id

Identyfikator repozytorium, w którym mają być stosowane zasady.

--valid-duration

Czas trwania ważności zasad (w minutach).

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--branch-match-type

Określa, jak argument gałęzi jest używany do stosowania zasad. Jeśli wartość to "exact", zasady zostaną zastosowane w gałęzi, która ma dokładne dopasowanie do argumentu --branch. Jeśli wartość to "prefiks", zasady są stosowane we wszystkich folderach gałęzi, które są zgodne z prefiksem dostarczonym przez argument --branch.

Właściwość Wartość
Domyślna wartość: exact
Dopuszczalne wartości: exact, prefix
--detect

Automatycznie wykrywaj organizację.

Właściwość Wartość
Dopuszczalne wartości: false, true
--org --organization

Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=ORG_URL. Wymagane, jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.

--path-filter

Ścieżki filtru, na których są stosowane zasady. Obsługuje ścieżki bezwzględne, symbole wieloznaczne i wiele ścieżek oddzielonych znakami ";". Przykład: /WebApp/Models/Data.cs, /WebApp/* lub *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

--project -p

Nazwa lub identyfikator projektu. Projekt domyślny można skonfigurować przy użyciu polecenia az devops configure -d project=NAME_OR_ID. Wymagane, jeśli nie jest skonfigurowane jako domyślne lub przejęte za pośrednictwem git config.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az repos policy build update

Aktualizowanie zasad kompilacji.

az repos policy build update --id --policy-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 --organization]
                             [--path-filter]
                             [--project]
                             [--queue-on-source-update-only {false, true}]
                             [--repository-id]
                             [--valid-duration]

Parametry wymagane

--id --policy-id

Identyfikator zasad.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--blocking

Czy zasady powinny być blokowane, czy nie.

Właściwość Wartość
Dopuszczalne wartości: false, true
--branch

Gałąź, na której mają być stosowane te zasady. Na przykład: master.

--branch-match-type

Określa, jak argument gałęzi jest używany do stosowania zasad. Jeśli wartość to "exact", zasady zostaną zastosowane w gałęzi, która ma dokładne dopasowanie do argumentu --branch. Jeśli wartość to "prefiks", zasady są stosowane we wszystkich folderach gałęzi, które są zgodne z prefiksem dostarczonym przez argument --branch.

Właściwość Wartość
Dopuszczalne wartości: exact, prefix
--build-definition-id

Identyfikator definicji kompilacji.

--detect

Automatycznie wykrywaj organizację.

Właściwość Wartość
Dopuszczalne wartości: false, true
--display-name

Nazwa wyświetlana dla tych zasad kompilacji w celu zidentyfikowania zasad. Na przykład: "Zasady kolejki ręcznej".

--enabled

Bez względu na to, czy zasady są włączone, czy nie.

Właściwość Wartość
Dopuszczalne wartości: false, true
--manual-queue-only

Czy zezwalać tylko na ręczną kolejkę kompilacji.

Właściwość Wartość
Dopuszczalne wartości: false, true
--org --organization

Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=ORG_URL. Wymagane, jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.

--path-filter

Ścieżki filtru, na których są stosowane zasady. Obsługuje ścieżki bezwzględne, symbole wieloznaczne i wiele ścieżek oddzielonych znakami ";". Przykład: /WebApp/Models/Data.cs, /WebApp/* lub *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

--project -p

Nazwa lub identyfikator projektu. Projekt domyślny można skonfigurować przy użyciu polecenia az devops configure -d project=NAME_OR_ID. Wymagane, jeśli nie jest skonfigurowane jako domyślne lub przejęte za pośrednictwem git config.

--queue-on-source-update-only

Kolejka tylko w przypadku aktualizacji źródłowej.

Właściwość Wartość
Dopuszczalne wartości: false, true
--repository-id

Identyfikator repozytorium, w którym mają być stosowane zasady.

--valid-duration

Czas trwania ważności zasad (w minutach).

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False