az repos policy build

Note

Tento odkaz je součástí rozšíření azure-devops pro Azure CLI (verze 2.30.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az repos policy build. Přečtěte si další informace o rozšířeních.

Správa zásad sestavení

Příkazy

Name Description Typ Stav
az repos policy build create

Vytvořte zásadu sestavení.

Extension GA
az repos policy build update

Aktualizujte zásady sestavení.

Extension GA

az repos policy build create

Vytvořte zásadu sestavení.

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
                             [--acquire-policy-token]
                             [--branch-match-type {exact, prefix}]
                             [--change-reference]
                             [--detect {false, true}]
                             [--org --organization]
                             [--path-filter]
                             [--project]

Povinné parametry

--blocking

Bez ohledu na to, jestli by zásady měly být blokující, nebo ne.

Vlastnost Hodnota
Přípustné hodnoty: false, true
--branch

Větev, u které by se tato zásada měla použít. Příklad: master.

--build-definition-id

ID definice sestavení

--display-name

Zobrazovaný název této zásady sestavení pro identifikaci zásad. Příklad: "Zásady ruční fronty".

--enabled

Bez ohledu na to, jestli je zásada povolená nebo ne.

Vlastnost Hodnota
Přípustné hodnoty: false, true
--manual-queue-only

Určuje, jestli chcete povolit pouze ruční frontu sestavení.

Vlastnost Hodnota
Přípustné hodnoty: false, true
--queue-on-source-update-only

Fronta pouze při aktualizaci zdroje.

Vlastnost Hodnota
Přípustné hodnoty: false, true
--repository-id

ID úložiště, pro které se má zásada použít.

--valid-duration

Doba platnosti zásad (v minutách).

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost Hodnota
Skupina parametrů: Global Policy Arguments
--branch-match-type

Určuje způsob použití argumentu větve k použití zásady. Pokud je hodnota "přesná", zásada se použije ve větvi, která má přesnou shodu u argumentu --branch. Pokud je hodnota prefix, zásada se použije ve všech složkách větví, které odpovídají předponě poskytnuté argumentem --branch.

Vlastnost Hodnota
Default value: exact
Přípustné hodnoty: exact, prefix
--change-reference

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost Hodnota
Skupina parametrů: Global Policy Arguments
--detect

Automaticky rozpozná organizaci.

Vlastnost Hodnota
Přípustné hodnoty: false, true
--org --organization

Azure DevOps adresu URL organizace. Výchozí organizaci můžete nakonfigurovat pomocí příkazu az devops configure -d organization=ORG_URL. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.

--path-filter

Cesty filtru, pro které se zásady použijí. Podporuje absolutní cesty, zástupné řady a více cest oddělených znakem ;. Příklad: /WebApp/Models/Data.cs, /WebApp/* nebo *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

--project -p

Název nebo ID projektu. Výchozí projekt můžete nakonfigurovat pomocí příkazu az devops configure -d project=NAME_OR_ID. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo získáno prostřednictvím konfigurace Gitu.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az repos policy build update

Aktualizujte zásady sestavení.

az repos policy build update --id --policy-id
                             [--acquire-policy-token]
                             [--blocking {false, true}]
                             [--branch]
                             [--branch-match-type {exact, prefix}]
                             [--build-definition-id]
                             [--change-reference]
                             [--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]

Povinné parametry

--id --policy-id

ID zásady.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--acquire-policy-token

Získání tokenu Azure Policy automaticky pro tuto operaci prostředku

Vlastnost Hodnota
Skupina parametrů: Global Policy Arguments
--blocking

Bez ohledu na to, jestli by zásady měly být blokující, nebo ne.

Vlastnost Hodnota
Přípustné hodnoty: false, true
--branch

Větev, u které by se tato zásada měla použít. Příklad: master.

--branch-match-type

Určuje způsob použití argumentu větve k použití zásady. Pokud je hodnota "přesná", zásada se použije ve větvi, která má přesnou shodu u argumentu --branch. Pokud je hodnota prefix, zásada se použije ve všech složkách větví, které odpovídají předponě poskytnuté argumentem --branch.

Vlastnost Hodnota
Přípustné hodnoty: exact, prefix
--build-definition-id

ID definice sestavení

--change-reference

Související referenční ID odkazu na změnu pro tuto operaci prostředku.

Vlastnost Hodnota
Skupina parametrů: Global Policy Arguments
--detect

Automaticky rozpozná organizaci.

Vlastnost Hodnota
Přípustné hodnoty: false, true
--display-name

Zobrazovaný název této zásady sestavení pro identifikaci zásad. Příklad: "Zásady ruční fronty".

--enabled

Bez ohledu na to, jestli je zásada povolená nebo ne.

Vlastnost Hodnota
Přípustné hodnoty: false, true
--manual-queue-only

Určuje, jestli chcete povolit pouze ruční frontu sestavení.

Vlastnost Hodnota
Přípustné hodnoty: false, true
--org --organization

Azure DevOps adresu URL organizace. Výchozí organizaci můžete nakonfigurovat pomocí příkazu az devops configure -d organization=ORG_URL. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.

--path-filter

Cesty filtru, pro které se zásady použijí. Podporuje absolutní cesty, zástupné řady a více cest oddělených znakem ;. Příklad: /WebApp/Models/Data.cs, /WebApp/* nebo *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

--project -p

Název nebo ID projektu. Výchozí projekt můžete nakonfigurovat pomocí příkazu az devops configure -d project=NAME_OR_ID. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo získáno prostřednictvím konfigurace Gitu.

--queue-on-source-update-only

Fronta pouze při aktualizaci zdroje.

Vlastnost Hodnota
Přípustné hodnoty: false, true
--repository-id

ID úložiště, pro které se má zásada použít.

--valid-duration

Doba platnosti zásad (v minutách).

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False