az deployment mg

  • Reference

Správa nasazení šablon Azure Resource Manageru ve skupině pro správu

Příkazy

Name Description Typ Stav
az deployment mg cancel

Zrušení nasazení ve skupině pro správu

 Základ GA
az deployment mg create

Spusťte nasazení ve skupině pro správu.

 Základ GA
az deployment mg delete

Odstraňte nasazení ve skupině pro správu.

 Základ GA
az deployment mg export

Exportujte šablonu použitou pro nasazení.

 Základ GA
az deployment mg list

Zobrazení seznamu nasazení ve skupině pro správu

 Základ GA
az deployment mg show

Zobrazení nasazení ve skupině pro správu

 Základ GA
az deployment mg validate

Ověřte, jestli je šablona platná ve skupině pro správu.

 Základ GA
az deployment mg wait

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

 Základ GA
az deployment mg what-if

Spusťte operaci citlivostní operace nasazení v oboru skupiny pro správu.

 Základ GA

az deployment mg cancel

Upravit

Zrušení nasazení ve skupině pro správu

az deployment mg cancel --management-group-id
                        --name

Příklady

Zrušení nasazení ve skupině pro správu

az deployment mg cancel -m testmg -n deployment01

Povinné parametry

--management-group-id -m

ID skupiny pro správu.

--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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--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.

az deployment mg create

Upravit

Spusťte nasazení ve skupině pro správu.

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

az deployment mg create --location
                        --management-group-id
                        [--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]
                        [--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ě pro správu ze vzdáleného souboru šablony pomocí parametrů z místního souboru JSON.

az deployment mg create --management-group-id testrg --name rollout01 --location WestUS \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Vytvořte nasazení ve skupině pro správu ze souboru místní šablony pomocí parametrů z řetězce JSON.

az deployment mg create --management-group-id testmg --name rollout01 --location WestUS \
    --template-file azuredeploy.json \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

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

az deployment mg create --management-group-id testmg --name rollout01 --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í.

--management-group-id -m

ID skupiny pro správu, ve které se má vytvořit 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í

--mode

Režim, který se používá k nasazení prostředků. Tato hodnota může být přírůstková nebo úplná. V přírůstkovém režimu se prostředky nasazují bez odstranění existujících prostředků, které nejsou součástí šablony. V režimu Dokončení se prostředky nasadí a existující prostředky ve skupině prostředků, které nejsou součástí šablony, se odstraní. Při použití režimu Dokončení buďte opatrní, protože nechtěně odstraňte prostředky.

přijímané hodnoty: Complete, Incremental
výchozí hodnota: 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řijímané hodnoty: false, true
výchozí hodnota: False
--no-wait

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

výchozí hodnota: False
--parameters -p

Zadejte hodnoty parametrů nasazení.

Parametry mohou být ze souboru zadány pomocí @{path} syntaxe, ř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

Pokud výsledek what-If neobsahuje žádné změny prostředků, příkaz k provedení nasazení. 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

Seznamtypůch Platí, když je nastaven parametr --confirm-with-what-if.

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

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

přijímané hodnoty: FullResourcePayloads, ResourceIdOnly
výchozí hodnota: 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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--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.

az deployment mg delete

Upravit

Odstraňte nasazení ve skupině pro správu.

az deployment mg delete --management-group-id
                        --name
                        [--no-wait]

Příklady

Odstraňte nasazení ve skupině pro správu.

az deployment mg delete -m testmg -n deployment01

Povinné parametry

--management-group-id -m

ID skupiny pro správu.

--name -n

Název nasazení.

Volitelné parametry

--no-wait

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

výchozí hodnota: 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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--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.

az deployment mg export

Upravit

Exportujte šablonu použitou pro nasazení.

az deployment mg export --management-group-id
                        --name

Příklady

Exportujte šablonu použitou pro nasazení ve skupině pro správu.

az deployment mg export --management-group-id testmg --name MyDeployment

Povinné parametry

--management-group-id -m

ID skupiny pro správu.

--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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--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.

az deployment mg list

Upravit

Zobrazení seznamu nasazení ve skupině pro správu

az deployment mg list --management-group-id
                      [--filter]

Příklady

Zobrazení seznamu nasazení ve skupině pro správu

az deployment mg list -m testmg

Povinné parametry

--management-group-id -m

ID skupiny pro správu.

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 https://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parametersprosím .

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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--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.

az deployment mg show

Upravit

Zobrazení nasazení ve skupině pro správu

az deployment mg show --management-group-id
                      --name

Příklady

Zobrazení nasazení ve skupině pro správu

az deployment mg show -m testmg -n deployment01

Povinné parametry

--management-group-id -m

ID skupiny pro správu.

--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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--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.

az deployment mg validate

Upravit

Ověřte, jestli je šablona platná ve skupině pro správu.

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

az deployment mg validate --location
                          --management-group-id
                          [--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á ve skupině pro správu.

az deployment mg validate --management-group-id testmg --location WestUS --template-file {template-file}

Ověřte, jestli je šablona platná ve skupině pro správu. (automaticky vygenerováno)

az deployment mg validate --location WestUS --management-group-id testmg --name mydeployment --parameters @myparameters.json --template-file azuredeploy.json

Povinné parametry

--location -l

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

--management-group-id -m

ID skupiny pro správu, 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í

--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řijímané hodnoty: false, true
výchozí hodnota: False
--parameters -p

Zadejte hodnoty parametrů nasazení.

Parametry mohou být ze souboru zadány pomocí @{path} syntaxe, ř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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--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.

az deployment mg wait

Upravit

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

az deployment mg wait --management-group-id
                      --name
                      [--created]
                      [--custom]
                      [--deleted]
                      [--exists]
                      [--interval]
                      [--timeout]
                      [--updated]

Povinné parametry

--management-group-id -m

ID skupiny pro správu.

--name -n

Název nasazení.

Volitelné parametry

--created

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

výchozí hodnota: 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í.

výchozí hodnota: False
--exists

Počkejte, až prostředek existuje.

výchozí hodnota: False
--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, dokud se neaktualizuje stav zřizování ve stavu Úspěch.

výchozí hodnota: 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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--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.

az deployment mg what-if

Upravit

Spusťte operaci citlivostní operace nasazení v oboru skupiny pro správu.

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

az deployment mg what-if --location
                         --management-group-id
                         [--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 citlivostní operace nasazení ve skupině pro správu.

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Spusťte operaci citlivostní operace nasazení ve skupině pro správu s formátem ResourceIdOnly.

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Spusťte operaci citlivostní operace nasazení ve skupině pro správu, aniž byste výsledek vytiskli.

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Povinné parametry

--location -l

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

--management-group-id -m

ID skupiny pro správu, ve které se má vytvořit nasazení

Volitelné parametry

--exclude-change-types -x

Seznamtypůch

přijímané hodnoty: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--name -n

Název nasazení.

--no-pretty-print

Zakažte možnost pretty-print pro výsledky citlivostní dokumentace. 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řijímané hodnoty: false, true
výchozí hodnota: False
--parameters -p

Zadejte hodnoty parametrů nasazení.

Parametry mohou být ze souboru zadány pomocí @{path} syntaxe, ř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 výsledků citlivostní dokumentace.

přijímané hodnoty: FullResourcePayloads, ResourceIdOnly
výchozí hodnota: 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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--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.