Sdílet prostřednictvím

az deployment group

  • Reference

Správa nasazení šablon Azure Resource Manageru ve skupině prostředků

Příkazy

Name Description Typ Stav
az deployment group cancel

Zrušte nasazení ve skupině prostředků.

 Jádro GHANŠTINA
az deployment group create

Spusťte nasazení ve skupině prostředků.

 Jádro GHANŠTINA
az deployment group delete

Odstraňte nasazení ve skupině prostředků.

 Jádro GHANŠTINA
az deployment group export

Exportujte šablonu použitou pro nasazení.

 Jádro GHANŠTINA
az deployment group list

Zobrazení seznamu nasazení ve skupině prostředků

 Jádro GHANŠTINA
az deployment group show

Zobrazení nasazení ve skupině prostředků

 Jádro GHANŠTINA
az deployment group validate

Ověřte, jestli je šablona platná ve skupině prostředků.

 Jádro GHANŠTINA
az deployment group wait

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka nasazení.

 Jádro GHANŠTINA
az deployment group what-if

Spusťte operaci What-If nasazení v oboru skupiny prostředků.

 Jádro GHANŠTINA

az deployment group cancel

Upravit

Zrušte nasazení ve skupině prostředků.

az deployment group cancel --name
                           --resource-group

Příklady

Zrušte nasazení ve skupině prostředků.

az deployment group cancel -g testrg -n deployment01

Povinné parametry

--name -n

Název nasazení.

--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

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

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

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

az deployment group create

Upravit

Spusťte nasazení ve skupině prostředků.

Zadejte pouze jeden soubor --template-file | --template-URI | --template-spec pro zadání šablony ARM.

az deployment group create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--confirm-with-what-if]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--proceed-if-no-change]
                           [--query-string]
                           [--rollback-on-error]
                           [--template-file]
                           [--template-spec]
                           [--template-uri]
                           [--what-if]
                           [--what-if-exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                           [--what-if-result-format {FullResourcePayloads, ResourceIdOnly}]

Příklady

Vytvořte nasazení ve skupině prostředků ze vzdáleného souboru šablony pomocí parametrů z místního souboru JSON.

az deployment group create --resource-group testrg --name rollout01 \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Vytvořte nasazení ve skupině prostředků ze souboru místní šablony pomocí parametrů z řetězce JSON.

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json  \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

Vytvořte nasazení ve skupině prostředků ze souboru místní šablony pomocí parametrů z řetězce pole.

az deployment group create --resource-group testgroup --template-file demotemplate.json --parameters exampleString='inline string' exampleArray='("value1", "value2")'

Vytvořte nasazení ve skupině prostředků z místní šablony pomocí souboru parametrů, vzdáleného souboru parametrů a selektivního přepsání párů klíč/hodnota.

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json  --parameters @params.json \
    --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Vytvoření nasazení v oboru skupiny prostředků ze specifikace šablony

az deployment group create --resource-group testrg --template-spec "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Resources/templateSpecs/myTemplateSpec/versions/1.0"

Vytvoření nasazení v oboru skupiny prostředků ze souboru parametrů bicepparam

az deployment group create --resource-group testrg --parameters parameters.bicepparam

Vytvoření nasazení ve skupině prostředků napříč tenanty

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json --parameters @myparameters.json --aux-tenants auxiliary_tenant01 auxiliary_tenant02

Povinné parametry

--resource-group -g

Skupina prostředků, ve které se má vytvořit nasazení

Volitelné parametry

--aux-subs
Zastaralé

Možnost --aux-subs je zastaralá a bude odebrána v budoucí verzi. Místo toho použijte --aux-tenants.

Pomocná předplatná, která se použijí během nasazování napříč tenanty.

--aux-tenants

Pomocné tenanty, které budou použity během nasazování napříč tenanty.

--confirm-with-what-if -c

Před spuštěním nasazení instruujte příkaz, aby spustil What-If nasazení. Pak vás vyzve k potvrzení změn prostředků, než bude pokračovat.

--handle-extended-json-format -j
Zastaralé

Možnost --handle-extended-json-format/-j je zastaralá a bude odebrána v budoucí verzi.

Podpora zpracování rozšířeného obsahu šablony včetně víceřádkového obsahu a komentářů v nasazení

--mode

Režim nasazení.

Přípustné hodnoty: Complete, Incremental
Default value: Incremental
--name -n

Název nasazení.

--no-prompt

Možnost zakázat výzvu k chybějícím parametrům pro šablonu ARM. Pokud je hodnota true, výzva, aby uživatelé zadali chybějící parametr, bude ignorována. Výchozí hodnota je false.

Přípustné hodnoty: false, true
Default value: False
--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
--parameters -p

Zadejte hodnoty parametrů nasazení.

Parametry mohou být ze souboru zadány pomocí syntaxe @{path}, řetězce JSON nebo jako páry <KEY=VALUE>. Parametry se vyhodnocují v pořadí, takže když je hodnota přiřazena dvakrát, použije se druhá hodnota. Nejprve doporučujeme zadat soubor parametrů a pak selektivně přepsat pomocí syntaxe KEY=HODNOTA. Všimněte si také, že pokud zadáte soubor bicepparam, můžete tento argument použít pouze jednou.

--proceed-if-no-change

Pokyn k provedení nasazení, pokud výsledek What-If neobsahuje žádné změny prostředků. Platí, když je nastaven parametr --confirm-with-what-if.

--query-string -q

Řetězec dotazu (token SAS), který se má použít s identifikátorem template-uri v případě propojených šablon.

--rollback-on-error

Název nasazení, ke které se má vrátit zpět k chybě, nebo použít příznak k vrácení zpět k poslednímu úspěšnému nasazení.

--template-file -f

Cesta k souboru šablony nebo souboru Bicep.

--template-spec -s

ID prostředku specifikace šablony.

--template-uri -u

Identifikátor URI souboru šablony.

--what-if -w

Řiděte příkaz, aby spustil what-if nasazení.

--what-if-exclude-change-types -x

Seznam typů změn prostředků oddělených mezerami, které se mají vyloučit z What-If výsledků. Platí, když je nastaven parametr --confirm-with-what-if.

Přípustné hodnoty: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--what-if-result-format -r

Formát What-If výsledků. Platí pro nastavení --confirm-with-what-if.

Přípustné hodnoty: FullResourcePayloads, ResourceIdOnly
Default value: FullResourcePayloads
Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

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

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

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

az deployment group delete

Upravit

Odstraňte nasazení ve skupině prostředků.

az deployment group delete --name
                           --resource-group
                           [--no-wait]

Příklady

Odstraňte nasazení ve skupině prostředků.

az deployment group delete -g testrg -n deployment01

Povinné parametry

--name -n

Název nasazení.

--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

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

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

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

az deployment group export

Upravit

Exportujte šablonu použitou pro nasazení.

az deployment group export --name
                           --resource-group

Příklady

Exportujte šablonu použitou pro nasazení ve skupině prostředků.

az deployment group export --resource-group testrg --name MyDeployment

Povinné parametry

--name -n

Název nasazení.

--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

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

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

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

az deployment group list

Upravit

Zobrazení seznamu nasazení ve skupině prostředků

az deployment group list --resource-group
                         [--filter]

Příklady

Zobrazení seznamu nasazení ve skupině prostředků

az deployment group list -g testrg

Povinné parametry

--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

--filter
Preview

Filtrovací výraz pomocí notace OData K filtrování provisioningState můžete použít parametr --filter provisioningState eq {state}. Pokud chcete získat další informace, navštivte prosím https://learn.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

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

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

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

az deployment group show

Upravit

Zobrazení nasazení ve skupině prostředků

az deployment group show --name
                         --resource-group

Příklady

Zobrazení nasazení ve skupině prostředků

az deployment group show -g testrg -n deployment01

Povinné parametry

--name -n

Název nasazení.

--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

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

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

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

az deployment group validate

Upravit

Ověřte, jestli je šablona platná ve skupině prostředků.

Zadejte pouze jeden soubor --template-file | --template-URI | --template-spec pro zadání šablony ARM.

az deployment group validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--name]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--query-string]
                             [--rollback-on-error]
                             [--template-file]
                             [--template-spec]
                             [--template-uri]

Příklady

Ověřte, jestli je šablona platná ve skupině prostředků.

az deployment group validate --resource-group testrg --template-file {template-file}

Ověřte, jestli je šablona platná ve skupině prostředků. (automaticky vygenerováno)

az deployment group validate --parameters MyValue=This MyArray=@array.json --resource-group testrg --template-file azuredeploy.json

Povinné parametry

--resource-group -g

Skupina prostředků, ve které se má vytvořit nasazení

Volitelné parametry

--handle-extended-json-format -j
Zastaralé

Možnost --handle-extended-json-format/-j je zastaralá a bude odebrána v budoucí verzi.

Podpora zpracování rozšířeného obsahu šablony včetně víceřádkového obsahu a komentářů v nasazení

--mode

Režim nasazení.

Přípustné hodnoty: Complete, Incremental
Default value: Incremental
--name -n

Název nasazení.

--no-prompt

Možnost zakázat výzvu k chybějícím parametrům pro šablonu ARM. Pokud je hodnota true, výzva, aby uživatelé zadali chybějící parametr, bude ignorována. Výchozí hodnota je false.

Přípustné hodnoty: false, true
Default value: False
--parameters -p

Zadejte hodnoty parametrů nasazení.

Parametry mohou být ze souboru zadány pomocí syntaxe @{path}, řetězce JSON nebo jako páry <KEY=VALUE>. Parametry se vyhodnocují v pořadí, takže když je hodnota přiřazena dvakrát, použije se druhá hodnota. Nejprve doporučujeme zadat soubor parametrů a pak selektivně přepsat pomocí syntaxe KEY=HODNOTA.

--query-string -q

Řetězec dotazu (token SAS), který se má použít s identifikátorem template-uri v případě propojených šablon.

--rollback-on-error

Název nasazení, ke které se má vrátit zpět k chybě, nebo použít příznak k vrácení zpět k poslednímu úspěšnému nasazení.

--template-file -f

Cesta k souboru šablony nebo souboru Bicep.

--template-spec -s

ID prostředku specifikace šablony.

--template-uri -u

Identifikátor URI souboru šablony.

Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

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

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

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

az deployment group wait

Upravit

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka nasazení.

az deployment group wait --name
                         --resource-group
                         [--created]
                         [--custom]
                         [--deleted]
                         [--exists]
                         [--interval]
                         [--timeout]
                         [--updated]

Příklady

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka nasazení. (automaticky vygenerováno)

az deployment group wait --created --name MyDeployment --resource-group MyResourceGroup

Povinné parametry

--name -n

Název nasazení.

--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

--created

Počkejte na vytvoření s 'provisioningState' v 'Succeeded'.

Default value: False
--custom

Počkejte, až podmínka splňuje vlastní dotaz JMESPath. Například provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Počkejte na odstranění.

Default value: False
--exists

Počkejte, až prostředek existuje.

Default value: False
--interval

Interval dotazování v sekundách

Default value: 30
--timeout

Maximální čekání v sekundách.

Default value: 3600
--updated

Počkejte, dokud se neaktualizuje stav zřizování ve stavu Úspěch.

Default value: False
Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

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

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

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

az deployment group what-if

Upravit

Spusťte operaci What-If nasazení v oboru skupiny prostředků.

Zadejte pouze jeden soubor --template-file | --template-URI | --template-spec pro zadání šablony ARM.

az deployment group what-if --resource-group
                            [--aux-tenants]
                            [--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                            [--mode {Complete, Incremental}]
                            [--name]
                            [--no-pretty-print]
                            [--no-prompt {false, true}]
                            [--parameters]
                            [--query-string]
                            [--result-format {FullResourcePayloads, ResourceIdOnly}]
                            [--template-file]
                            [--template-spec]
                            [--template-uri]

Příklady

Spusťte operaci nasazení What-If ve skupině prostředků.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Spusťte operaci What-If nasazení ve skupině prostředků s formátem ResourceIdOnly.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Spusťte operaci nasazení What-If ve skupině prostředků, aniž byste výsledek vytiskli.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Povinné parametry

--resource-group -g

Skupina prostředků pro spuštění operace nasazení What-If na adrese.

Volitelné parametry

--aux-tenants

Pomocné tenanty, které budou použity během nasazování napříč tenanty.

--exclude-change-types -x

Seznam typů změn prostředků oddělených mezerami, které se mají vyloučit z What-If výsledků.

Přípustné hodnoty: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--mode

Režim nasazení.

Přípustné hodnoty: Complete, Incremental
Default value: Incremental
--name -n

Název nasazení.

--no-pretty-print

Zakažte pěkný tisk pro What-If výsledky. Při nastavení se použije typ výstupního formátu.

--no-prompt

Možnost zakázat výzvu k chybějícím parametrům pro šablonu ARM. Pokud je hodnota true, výzva, aby uživatelé zadali chybějící parametr, bude ignorována. Výchozí hodnota je false.

Přípustné hodnoty: false, true
Default value: False
--parameters -p

Zadejte hodnoty parametrů nasazení.

Parametry mohou být ze souboru zadány pomocí syntaxe @{path}, řetězce JSON nebo jako páry <KEY=VALUE>. Parametry se vyhodnocují v pořadí, takže když je hodnota přiřazena dvakrát, použije se druhá hodnota. Nejprve doporučujeme zadat soubor parametrů a pak selektivně přepsat pomocí syntaxe KEY=HODNOTA.

--query-string -q

Řetězec dotazu (token SAS), který se má použít s identifikátorem template-uri v případě propojených šablon.

--result-format -r

Formát What-If výsledků.

Přípustné hodnoty: FullResourcePayloads, ResourceIdOnly
Default value: FullResourcePayloads
--template-file -f

Cesta k souboru šablony nebo souboru Bicep.

--template-spec -s

ID prostředku specifikace šablony.

--template-uri -u

Identifikátor URI souboru šablony.

Globální parametry
--debug

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

--help -h

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

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

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

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

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