az deployment mg

  • Referens

Hantera distribution av Azure Resource Manager-mallar i hanteringsgruppen.

Kommandon

Name Description Typ Status
az deployment mg cancel

Avbryt en distribution i hanteringsgruppen.

 Kärna Allmän tillgänglighet
az deployment mg create

Starta en distribution i hanteringsgruppen.

 Kärna Allmän tillgänglighet
az deployment mg delete

Ta bort en distribution i hanteringsgruppen.

 Kärna Allmän tillgänglighet
az deployment mg export

Exportera mallen som används för en distribution.

 Kärna Allmän tillgänglighet
az deployment mg list

Lista distributioner i hanteringsgruppen.

 Kärna Allmän tillgänglighet
az deployment mg show

Visa en distribution i hanteringsgruppen.

 Kärna Allmän tillgänglighet
az deployment mg validate

Kontrollera om en mall är giltig i hanteringsgruppen.

 Kärna Allmän tillgänglighet
az deployment mg wait

Placera CLI i vänteläge tills ett distributionsvillkor uppfylls.

 Kärna Allmän tillgänglighet
az deployment mg what-if

Kör en distributionsåtgärd för Konsekvens i hanteringsgruppens omfång.

 Kärna Allmän tillgänglighet

az deployment mg cancel

Redigera

Avbryt en distribution i hanteringsgruppen.

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

Exempel

Avbryt en distribution i hanteringsgruppen.

az deployment mg cancel -m testmg -n deployment01

Obligatoriska parametrar

--management-group-id -m

Hanteringsgruppens ID.

--name -n

Distributionsnamnet.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az deployment mg create

Redigera

Starta en distribution i hanteringsgruppen.

Ange endast en av --template-file FILE | --template-uri URI | --template-spec för att mata in ARM-mallen.

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

Exempel

Skapa en distribution i hanteringsgruppen från en fjärrmallfil med parametrar från en lokal JSON-fil.

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

Skapa en distribution i hanteringsgruppen från en lokal mallfil med parametrar från en JSON-sträng.

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

Skapa en distribution i hanteringsgruppen från en lokal mall med hjälp av en parameterfil, en fjärrparparfil och selektivt åsidosättande nyckel-/värdepar.

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

Obligatoriska parametrar

--location -l

Platsen där distributionsmetadata ska lagras.

--management-group-id -m

Hanteringsgruppens ID för att skapa distribution på.

Valfria parametrar

--confirm-with-what-if -c

Instruera kommandot att köra distributionen What-If innan du kör distributionen. Sedan uppmanas du att bekräfta resursändringar innan den fortsätter.

--handle-extended-json-format -j
Inaktuell

Alternativet "--handle-extended-json-format/-j" har blivit inaktuellt och tas bort i en framtida version.

Stöd för att hantera utökat mallinnehåll, inklusive flera ledningar och kommentarer i distributionen.

--mode

Läget som används för att distribuera resurser. Det här värdet kan vara antingen Inkrementellt eller Slutfört. I inkrementellt läge distribueras resurser utan att befintliga resurser som inte ingår i mallen tas bort. I fullständigt läge distribueras resurser och befintliga resurser i resursgruppen som inte ingår i mallen tas bort. Var försiktig när du använder Slutfört läge eftersom du oavsiktligt kan ta bort resurser.

accepterade värden: Complete, Incremental
standardvärde: Incremental
--name -n

Distributionsnamnet.

--no-prompt

Alternativet för att inaktivera frågan om saknade parametrar för ARM-mallen. När värdet är sant ignoreras uppmaningen som kräver att användarna anger en parameter som saknas. Standardvärdet är "false".

accepterade värden: false, true
standardvärde: False
--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
--parameters -p

Ange parametervärden för distribution.

Parametrar kan anges från en fil med hjälp av syntaxen @{path} , en JSON-sträng eller som <KEY=VALUE-par> . Parametrar utvärderas i ordning, så när ett värde tilldelas två gånger används det senare värdet. Vi rekommenderar att du anger parameterfilen först och sedan åsidosätter selektivt med hjälp av KEY=VALUE-syntax.

--proceed-if-no-change

Instruera kommandot att köra distributionen om konsekvensresultatet inte innehåller några resursändringar. Gäller när --confirm-with-what-if har angetts.

--query-string -q

Frågesträngen (en SAS-token) som ska användas med mall-uri när det gäller länkade mallar.

--template-file -f

Sökvägen till mallfilen eller Bicep-filen.

--template-spec -s

Resurs-ID:t för mallspecifikationen.

--template-uri -u

URI:n till mallfilen.

--what-if -w

Instruera kommandot att köra distributionen What-If.

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

Blankstegsavgränsad lista över resursändringstyper som ska undantas från konsekvensresultat. Gäller när --confirm-with-what-if har angetts.

accepterade värden: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--what-if-result-format -r

Formatet för Konsekvensresultat. Gäller när --confirm-with-what-if har angetts.

accepterade värden: FullResourcePayloads, ResourceIdOnly
standardvärde: FullResourcePayloads
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az deployment mg delete

Redigera

Ta bort en distribution i hanteringsgruppen.

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

Exempel

Ta bort en distribution i hanteringsgruppen.

az deployment mg delete -m testmg -n deployment01

Obligatoriska parametrar

--management-group-id -m

Hanteringsgruppens ID.

--name -n

Distributionsnamnet.

Valfria parametrar

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az deployment mg export

Redigera

Exportera mallen som används för en distribution.

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

Exempel

Exportera mallen som används för en distribution i hanteringsgruppen.

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

Obligatoriska parametrar

--management-group-id -m

Hanteringsgruppens ID.

--name -n

Distributionsnamnet.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az deployment mg list

Redigera

Lista distributioner i hanteringsgruppen.

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

Exempel

Lista distributioner i hanteringsgruppen.

az deployment mg list -m testmg

Obligatoriska parametrar

--management-group-id -m

Hanteringsgruppens ID.

Valfria parametrar

--filter
Förhandsgranskning

Filtrera uttryck med OData-notation. Du kan använda --filter "provisioningState eq {state}" för att filtrera provisioningState. Mer information finns i https://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az deployment mg show

Redigera

Visa en distribution i hanteringsgruppen.

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

Exempel

Visa en distribution i hanteringsgruppen.

az deployment mg show -m testmg -n deployment01

Obligatoriska parametrar

--management-group-id -m

Hanteringsgruppens ID.

--name -n

Distributionsnamnet.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az deployment mg validate

Redigera

Kontrollera om en mall är giltig i hanteringsgruppen.

Ange endast en av --template-file FILE | --template-uri URI | --template-spec för att mata in ARM-mallen.

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]

Exempel

Kontrollera om en mall är giltig i hanteringsgruppen.

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

Kontrollera om en mall är giltig i hanteringsgruppen. (automatiskt genererad)

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

Obligatoriska parametrar

--location -l

Platsen där distributionsmetadata ska lagras.

--management-group-id -m

Hanteringsgruppens ID för att skapa distribution på.

Valfria parametrar

--handle-extended-json-format -j
Inaktuell

Alternativet "--handle-extended-json-format/-j" har blivit inaktuellt och tas bort i en framtida version.

Stöd för att hantera utökat mallinnehåll, inklusive flera ledningar och kommentarer i distributionen.

--name -n

Distributionsnamnet.

--no-prompt

Alternativet för att inaktivera frågan om saknade parametrar för ARM-mallen. När värdet är sant ignoreras uppmaningen som kräver att användarna anger en parameter som saknas. Standardvärdet är "false".

accepterade värden: false, true
standardvärde: False
--parameters -p

Ange parametervärden för distribution.

Parametrar kan anges från en fil med hjälp av syntaxen @{path} , en JSON-sträng eller som <KEY=VALUE-par> . Parametrar utvärderas i ordning, så när ett värde tilldelas två gånger används det senare värdet. Vi rekommenderar att du anger parameterfilen först och sedan åsidosätter selektivt med hjälp av KEY=VALUE-syntax.

--query-string -q

Frågesträngen (en SAS-token) som ska användas med mall-uri när det gäller länkade mallar.

--template-file -f

Sökvägen till mallfilen eller Bicep-filen.

--template-spec -s

Resurs-ID:t för mallspecifikationen.

--template-uri -u

URI:n till mallfilen.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az deployment mg wait

Redigera

Placera CLI i vänteläge tills ett distributionsvillkor uppfylls.

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

Obligatoriska parametrar

--management-group-id -m

Hanteringsgruppens ID.

--name -n

Distributionsnamnet.

Valfria parametrar

--created

Vänta tills du har skapat med "provisioningState" på "Lyckades".

standardvärde: False
--custom

Vänta tills villkoret uppfyller en anpassad JMESPath-fråga. T.ex. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Vänta tills den har tagits bort.

standardvärde: False
--exists

Vänta tills resursen finns.

standardvärde: False
--interval

Avsökningsintervall i sekunder.

standardvärde: 30
--timeout

Maximal väntetid i sekunder.

standardvärde: 3600
--updated

Vänta tills det har uppdaterats med provisioningState på Lyckades.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az deployment mg what-if

Redigera

Kör en distributionsåtgärd för Konsekvens i hanteringsgruppens omfång.

Ange endast en av --template-file FILE | --template-uri URI | --template-spec för att mata in ARM-mallen.

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]

Exempel

Kör en distributionsåtgärd vad händer om i en hanteringsgrupp.

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

Kör en distributionsåtgärd för konsekvensanalys i en hanteringsgrupp med ResourceIdOnly-format.

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

Kör en distributionsåtgärd för Konsekvens i en hanteringsgrupp utan att skriva ut resultatet på ett snyggt sätt.

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

Obligatoriska parametrar

--location -l

Platsen där distributionsmetadata ska lagras.

--management-group-id -m

Hanteringsgruppens ID för att skapa distribution på.

Valfria parametrar

--exclude-change-types -x

Blankstegsavgränsad lista över resursändringstyper som ska undantas från konsekvensresultat.

accepterade värden: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--name -n

Distributionsnamnet.

--no-pretty-print

Inaktivera ganska skrivskyddade resultat för konsekvensanalys. När den anges används formattypen för utdata.

--no-prompt

Alternativet för att inaktivera frågan om saknade parametrar för ARM-mallen. När värdet är sant ignoreras uppmaningen som kräver att användarna anger en parameter som saknas. Standardvärdet är "false".

accepterade värden: false, true
standardvärde: False
--parameters -p

Ange parametervärden för distribution.

Parametrar kan anges från en fil med hjälp av syntaxen @{path} , en JSON-sträng eller som <KEY=VALUE-par> . Parametrar utvärderas i ordning, så när ett värde tilldelas två gånger används det senare värdet. Vi rekommenderar att du anger parameterfilen först och sedan åsidosätter selektivt med hjälp av KEY=VALUE-syntax.

--query-string -q

Frågesträngen (en SAS-token) som ska användas med mall-uri när det gäller länkade mallar.

--result-format -r

Formatet för Konsekvensresultat.

accepterade värden: FullResourcePayloads, ResourceIdOnly
standardvärde: FullResourcePayloads
--template-file -f

Sökvägen till mallfilen eller Bicep-filen.

--template-spec -s

Resurs-ID:t för mallspecifikationen.

--template-uri -u

URI:n till mallfilen.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.