az deployment group

  • Reference

Správa Azure Resource Manager šablony 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

Zobrazí seznam nasazení ve skupině prostředků.
az deployment group show

Zobrazení 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 není splněna podmínka nasazení.
az deployment group what-if

Spustí operaci nasazení What-If v oboru skupiny prostředků.

az deployment group cancel

Upravit

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

az deployment group cancel --name
                           --resource-group
                           [--subscription]

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> příkazu .

Volitelné parametry

--subscription

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

az deployment group create

Upravit

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

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]
                           [--subscription]
                           [--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ů z místního souboru š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ů z místního souboru š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ě přepisová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 předplatného 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ů, ve které se má vytvořit nasazení.

Volitelné parametry

--aux-subs

Pomocná předplatná, která se budou používat během nasazování mezi tenanty.

--aux-tenants

Pomocní tenanti, které se budou používat během nasazování mezi tenanty.

--confirm-with-what-if -c

Instruuje příkaz, aby před What-If nasazení spouštěl příkaz deployment. Než bude pokračovat, zobrazí se výzva k potvrzení změn prostředků.

--handle-extended-json-format -j

Podpora zpracování obsahu rozšířené šablony, včetně víceřádkové šablony 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 k zadání chybějících parametrů pro šablonu ARM. Pokud je hodnota true, výzva, která vyžaduje, aby uživatelé zadovali 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í dlouhotr běžící operace.

--parameters -p

Zadejte hodnoty parametrů nasazení.

--proceed-if-no-change

Instruuje příkaz, aby se nasazení svedlo, What-If výsledek neobsahuje žádné změny prostředků. Použije se, když je nastavená možnost --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 chcete vrátit při chybě, nebo použít jako příznak pro vrácení k poslednímu úspěšnému nasazení.

--subscription

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

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

Instruuje příkaz, aby spouštěl what-if (What-If) nasazení.

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

Seznam změn prostředků oddělených mezerami, které se vyloučí z What-If výsledků. Použije se, když je nastavená možnost --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í, když --confirm-with-what-if je nastavená možnost .

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]
                           [--subscription]

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> příkazu .

Volitelné parametry

--no-wait

Nečekejte na dokončení dlouhotr běžící operace.

--subscription

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

az deployment group export

Upravit

Exportuje šablonu použitou k nasazení.

az deployment group export --name
                           --resource-group
                           [--subscription]

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> příkazu .

Volitelné parametry

--subscription

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

az deployment group list

Upravit

Zobrazí seznam nasazení ve skupině prostředků.

az deployment group list --resource-group
                         [--filter]
                         [--query-examples]
                         [--subscription]

Příklady

Zobrazí seznam 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> příkazu .

Volitelné parametry

--filter

Výraz filtru využívající notaci OData. K filtrování provisioningState můžete použít --filter "provisioningState eq '{state}'". Další informace najdete na adrese https://docs.microsoft.com/en-us/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters .

--query-examples

Doporučte pro vás řetězec JMESPath. Můžete zkopírovat jeden z dotazů a vložit ho za parametr --query v uvozovkách, abyste viděli výsledky. Můžete přidat jedno nebo více poziční klíčová slova, abychom mohli na základě těchto klíčových slov poskytnout návrhy.

--subscription

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

az deployment group show

Upravit

Zobrazení nasazení ve skupině prostředků

az deployment group show --name
                         --resource-group
                         [--query-examples]
                         [--subscription]

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> příkazu .

Volitelné parametry

--query-examples

Doporučte pro vás řetězec JMESPath. Můžete zkopírovat jeden z dotazů a vložit ho za parametr --query v uvozovkách, abyste viděli výsledky. Můžete přidat jedno nebo více poziční klíčová slova, abychom mohli na základě těchto klíčových slov poskytnout návrhy.

--subscription

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

az deployment group validate

Upravit

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

az deployment group validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--name]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--query-string]
                             [--rollback-on-error]
                             [--subscription]
                             [--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 vygenerované)

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

Podpora zpracování obsahu rozšířené šablony, včetně víceřádkové šablony 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 k zadání chybějících parametrů pro šablonu ARM. Pokud je hodnota true, výzva, která vyžaduje, aby uživatelé zadovali 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í, ke které se chcete vrátit při chybě, nebo použít jako příznak pro vrácení k poslednímu úspěšnému nasazení.

--subscription

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

--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 není splněna podmínka nasazení.

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

Příklady

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

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, dokud se nevytvoří s ' provisioningState ' na ' úspěch '.

--custom

Počkejte, dokud podmínka nesplňuje vlastní dotaz JMESPath. Například provisioningState! = "InProgress", instanceView. STATUSS [? Code = = ' PowerState/Running '].

--deleted

Počkejte, než se odstraní.

--exists

Počkejte, dokud prostředek neexistuje.

--interval

Interval dotazování v sekundách

výchozí hodnota: 30
--subscription

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

--timeout

Maximální počet sekund čekání.

výchozí hodnota: 3600
--updated

Počkejte, dokud nebude aktualizováno s provisioningStateem v ' uspěl '.

az deployment group what-if

Upravit

Spustí operaci nasazení What-If v oboru skupiny prostředků.

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}]
                            [--subscription]
                            [--template-file]
                            [--template-spec]
                            [--template-uri]

Příklady

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

Spustí operaci nasazení What-If 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

Spustí operaci nasazení What-If ve skupině prostředků bez poměrně tisku výsledku.

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ů, ve které se má spustit nasazení What-If operace v.

Volitelné parametry

--aux-tenants

Pomocní klienti, kteří budou použiti při nasazení napříč klienty.

--exclude-change-types -x

Prostor – seznam typů změn prostředků, 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

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

--no-prompt

Možnost zakázání výzvy k zadání 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 URI šablony v případě propojených šablon.

--result-format -r

Formát výsledků What-If.

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

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

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