Sdílet prostřednictvím

az deployment sub

  • Reference

Správa nasazení šablon Azure Resource Manageru v oboru předplatného

Příkazy

Name Description Typ Stav
az deployment sub cancel

Zrušení nasazení v oboru předplatného

 Jádro GHANŠTINA
az deployment sub create

Spusťte nasazení v oboru předplatného.

 Jádro GHANŠTINA
az deployment sub delete

Odstraňte nasazení v oboru předplatného.

 Jádro GHANŠTINA
az deployment sub export

Exportujte šablonu použitou pro nasazení.

 Jádro GHANŠTINA
az deployment sub list

Zobrazení seznamu nasazení v oboru předplatného

 Jádro GHANŠTINA
az deployment sub show

Zobrazení nasazení v oboru předplatného

 Jádro GHANŠTINA
az deployment sub validate

Ověřte, jestli je šablona platná v oboru předplatného.

 Jádro GHANŠTINA
az deployment sub 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 sub what-if

Spusťte operaci What-If nasazení v oboru předplatného.

 Jádro GHANŠTINA

az deployment sub cancel

Upravit

Zrušení nasazení v oboru předplatného

az deployment sub cancel --name

Příklady

Zrušení nasazení v oboru předplatného

az deployment sub cancel -n deployment01

Povinné parametry

--name -n

Název nasazení.

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

Upravit

Spusťte nasazení v oboru předplatného.

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

az deployment sub create --location
                         [--confirm-with-what-if]
                         [--handle-extended-json-format]
                         [--name]
                         [--no-prompt {false, true}]
                         [--no-wait]
                         [--parameters]
                         [--proceed-if-no-change]
                         [--query-string]
                         [--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í v oboru předplatného ze souboru vzdálené šablony pomocí parametrů z místního souboru JSON.

az deployment sub create --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Vytvořte nasazení v oboru předplatného ze souboru místní šablony pomocí parametrů z řetězce JSON.

az deployment sub create --location WestUS --template-file azuredeploy.json  \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

Vytvořte nasazení v oboru předplatného z místní šablony pomocí souboru parametrů, vzdáleného souboru parametrů a selektivního přepsání párů klíč/hodnota.

az deployment sub create --location WestUS --template-file azuredeploy.json  \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Povinné parametry

--location -l

Umístění pro uložení metadat nasazení.

Volitelné parametry

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

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

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

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

Upravit

Odstraňte nasazení v oboru předplatného.

az deployment sub delete --name
                         [--no-wait]

Příklady

Odstraňte nasazení v oboru předplatného.

az deployment sub delete -n deployment01

Povinné parametry

--name -n

Název nasazení.

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

Upravit

Exportujte šablonu použitou pro nasazení.

az deployment sub export --name

Příklady

Exportujte šablonu použitou pro nasazení v oboru předplatného.

az deployment sub export --name MyDeployment

Povinné parametry

--name -n

Název nasazení.

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

Upravit

Zobrazení seznamu nasazení v oboru předplatného

az deployment sub list [--filter]

Příklady

Zobrazení seznamu nasazení v oboru předplatného

az deployment sub list

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

Upravit

Zobrazení nasazení v oboru předplatného

az deployment sub show --name

Příklady

Zobrazení nasazení v oboru předplatného

az deployment sub show -n deployment01

Povinné parametry

--name -n

Název nasazení.

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

Upravit

Ověřte, jestli je šablona platná v oboru předplatného.

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

az deployment sub validate --location
                           [--handle-extended-json-format]
                           [--name]
                           [--no-prompt {false, true}]
                           [--parameters]
                           [--query-string]
                           [--template-file]
                           [--template-spec]
                           [--template-uri]

Příklady

Ověřte, jestli je šablona platná v oboru předplatného.

az deployment sub validate --location westus2 --template-file {template-file}

Ověřte, jestli je šablona platná v oboru předplatného. (automaticky vygenerováno)

az deployment sub validate --location westus2 --parameters MyValue=This MyArray=@array.json --template-file azuredeploy.json

Povinné parametry

--location -l

Umístění pro uložení metadat 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í

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

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

Upravit

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

az deployment sub wait --name
                       [--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 sub wait --created --name MyDeployment

Povinné parametry

--name -n

Název nasazení.

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 sub what-if

Upravit

Spusťte operaci What-If nasazení v oboru předplatného.

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

az deployment sub what-if --location
                          [--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                          [--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 v předplatném.

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Spusťte operaci nasazení What-If v předplatném s formátem ResourceIdOnly.

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Spusťte operaci nasazení What-If v předplatném bez toho, aby se výsledek vytiskl.

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Povinné parametry

--location -l

Umístění pro uložení metadat operací What-If nasazení.

Volitelné parametry

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