az deployment group

  • Reference

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

Příkazy

az deployment group cancel

Zrušte nasazení ve skupině prostředků.
az deployment group create

Spusťte nasazení ve skupině prostředků.
az deployment group delete

Odstraňte nasazení ve skupině prostředků.
az deployment group export

Exportuje šablonu použitou k nasazení.
az deployment group list

Vypíše nasazení ve skupině prostředků.
az deployment group show

Umožňuje zobrazit nasazení ve skupině prostředků.
az deployment group validate

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

Umístěte rozhraní příkazového řádku do stavu čekání, dokud se nesplní podmínka nasazení.
az deployment group what-if

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

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

az deployment group create

Upravit

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

Zadejte pouze jeden ze 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 souboru vzdálené š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"

Povinné parametry

--resource-group -g

Skupina prostředků pro vytvoření nasazení na adrese.

Volitelné parametry

--aux-subs

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

--aux-tenants

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

--confirm-with-what-if -c

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

--handle-extended-json-format -j

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

--mode

Režim nasazení.

přijímané hodnoty: Complete, Incremental
výchozí hodnota: Incremental
--name -n

Název nasazení.

--no-prompt

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

přijímané hodnoty: false, true
--no-wait

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

--parameters -p

Zadejte hodnoty parametrů nasazení.

--proceed-if-no-change

Pokyn, aby příkaz spustil nasazení, pokud výsledek What-If neobsahuje žádné změny prostředků. Platí, pokud je nastavena hodnota --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í pro vrácení zpět k chybě nebo použití příznaku 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

Instruujte příkaz, aby spustil nasazení what-If.

--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í, pokud je nastavena hodnota --confirm-with-what-if.

přijímané hodnoty: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--what-if-result-format -r

Formát What-If výsledků. Platí, pokud --confirm-with-what-if je nastavena.

přijímané hodnoty: FullResourcePayloads, ResourceIdOnly
výchozí hodnota: FullResourcePayloads

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.

az deployment group export

Upravit

Exportuje šablonu použitou k 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>.

az deployment group list

Upravit

Vypíše nasazení ve skupině prostředků.

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

Příklady

Vypíše 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

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

az deployment group show

Upravit

Umožňuje zobrazit nasazení ve skupině prostředků.

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

Příklady

Umožňuje zobrazit 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>.

az deployment group validate

Upravit

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

Zadejte pouze jeden ze 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ů pro vytvoření nasazení na adrese.

Volitelné parametry

--handle-extended-json-format -j

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

--mode

Režim nasazení.

přijímané hodnoty: Complete, Incremental
výchozí hodnota: Incremental
--name -n

Název nasazení.

--no-prompt

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

přijímané 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.

--rollback-on-error

Název nasazení pro vrácení zpět k chybě nebo použití příznaku 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.

az deployment group wait

Upravit

Umístěte rozhraní příkazového řádku do stavu čekání, dokud se nesplní 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 se nesplní 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, až se vytvoří s 'provisioningState' na 'Succeeded'.

--custom

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

--deleted

Počkejte na odstranění.

--exists

Počkejte, až prostředek existuje.

--interval

Interval dotazování v sekundách

výchozí hodnota: 30
--timeout

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

výchozí hodnota: 3600
--updated

Počkejte, až se aktualizuje stav provisioningState na adrese Succeeded(Úspěch).

az deployment group what-if

Upravit

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

Zadejte pouze jeden ze 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 What-If nasazení 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 museli výsledek vytisknout.

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é se použijí 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řijímané hodnoty: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--mode

Režim nasazení.

přijímané hodnoty: Complete, Incremental
výchozí hodnota: Incremental
--name -n

Název nasazení.

--no-pretty-print

Zakázat hezký 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 chybějících parametrů pro šablonu ARM. Pokud je hodnota true, výzva, která vyžaduje, aby uživatelé zadali chybějící parametr, bude ignorována. Výchozí hodnota je False.

přijímané 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ů.

přijímané hodnoty: FullResourcePayloads, ResourceIdOnly
výchozí hodnota: FullResourcePayloads
--template-file -f

Cesta k souboru šablony nebo souboru Bicpe

--template-spec -s

ID prostředku specifikace šablony.

--template-uri -u

Identifikátor URI souboru šablony.