az deployment sub

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	Core	GA
az deployment sub create	Spusťte nasazení v oboru předplatného.	Core	GA
az deployment sub delete	Odstraňte nasazení v oboru předplatného.	Core	GA
az deployment sub export	Exportujte šablonu použitou pro nasazení.	Core	GA
az deployment sub list	Zobrazení seznamu nasazení v oboru předplatného	Core	GA
az deployment sub show	Zobrazení nasazení v oboru předplatného	Core	GA
az deployment sub validate	Ověřte, jestli je šablona platná v oboru předplatného.	Core	GA
az deployment sub wait	Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka nasazení.	Core	GA
az deployment sub what-if	Spusťte operaci What-If nasazení v oboru předplatného.	Core	GA

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

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 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]
                         [--validation-level {Provider, ProviderNoRbac, Template}]
                         [--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

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.

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

Vlastnost	Hodnota
Default value:	False
Přípustné hodnoty:	false, true

--no-wait

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

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

--validation-level

Úroveň ověření nasazení. Může být nastavena na "Provider" (výchozí), "Template" nebo "ProviderNoRbac". S úrovní ověření poskytovatele arm provede úplné ověření a zkontroluje, jestli máte dostatečná oprávnění k nasazení všech prostředků v šabloně. S úrovní ověření providerNoRbac provede ARM úplné ověření, ale zkontroluje oprávnění ke čtení pouze u každého prostředku. S úrovní ověřování "šablona" se provede pouze statické ověřování: předběžné kontroly a kontroly oprávnění se přeskočí.

Vlastnost	Hodnota
Přípustné hodnoty:	Provider, ProviderNoRbac, Template

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

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

Vlastnost	Hodnota
Default value:	FullResourcePayloads
Přípustné hodnoty:	FullResourcePayloads, ResourceIdOnly

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

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.

--no-wait

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

Vlastnost	Hodnota
Default value:	False

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

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

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.

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

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

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 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]
                           [--validation-level {Provider, ProviderNoRbac, Template}]

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. (autogenerated)

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

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.

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

Vlastnost	Hodnota
Default value:	False
Přípustné hodnoty:	false, true

--parameters -p

Zadejte hodnoty parametrů nasazení.

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

--validation-level

Vlastnost	Hodnota
Přípustné hodnoty:	Provider, ProviderNoRbac, Template

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 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í. (autogenerated)

az deployment sub wait --created --name MyDeployment

Povinné parametry

--name -n

Název nasazení.

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.

--created

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

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

--custom

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

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments

--deleted

Počkejte na odstranění.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

--exists

Počkejte, až prostředek existuje.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

--interval

Interval dotazování v sekundách

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	30

--timeout

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

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	3600

--updated

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

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

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 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]
                          [--validation-level {Provider, ProviderNoRbac, Template}]

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

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.

--exclude-change-types -x

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

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

Vlastnost	Hodnota
Default value:	False
Přípustné hodnoty:	false, true

--parameters -p

Zadejte hodnoty parametrů nasazení.

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

Vlastnost	Hodnota
Default value:	FullResourcePayloads
Přípustné hodnoty:	FullResourcePayloads, ResourceIdOnly

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

--validation-level

Vlastnost	Hodnota
Přípustné hodnoty:	Provider, ProviderNoRbac, Template

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

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

az deployment sub

Příkazy

az deployment sub cancel

Příklady

Povinné parametry

az deployment sub create

Příklady

Povinné parametry

Volitelné parametry

az deployment sub delete

Příklady

Povinné parametry

Volitelné parametry

az deployment sub export

Příklady

Povinné parametry

az deployment sub list

Příklady

Volitelné parametry

az deployment sub show

Příklady

Povinné parametry

az deployment sub validate

Příklady

Povinné parametry

Volitelné parametry

az deployment sub wait

Příklady

Povinné parametry

Volitelné parametry

az deployment sub what-if

Příklady

Povinné parametry

Volitelné parametry

Váš názor