Dela via

az deployment sub

  • Referens

Hantera distribution av Azure Resource Manager-mallar i prenumerationsomfånget.

Kommandon

Name Description Typ Status
az deployment sub cancel

Avbryt en distribution i prenumerationsomfånget.

 Kärna GA
az deployment sub create

Starta en distribution i prenumerationsomfånget.

 Kärna GA
az deployment sub delete

Ta bort en distribution i prenumerationsomfånget.

 Kärna GA
az deployment sub export

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

 Kärna GA
az deployment sub list

Visa en lista över distributioner i prenumerationsomfånget.

 Kärna GA
az deployment sub show

Visa en distribution i prenumerationsomfånget.

 Kärna GA
az deployment sub validate

Kontrollera om en mall är giltig i prenumerationsomfånget.

 Kärna GA
az deployment sub wait

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

 Kärna GA
az deployment sub what-if

Kör en distribution What-If åtgärd i prenumerationsomfånget.

 Kärna GA

az deployment sub cancel

Redigera

Avbryt en distribution i prenumerationsomfånget.

az deployment sub cancel --name

Exempel

Avbryt en distribution i prenumerationsomfånget.

az deployment sub cancel -n deployment01

Obligatoriska parametrar

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

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

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

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az deployment sub create

Redigera

Starta en distribution i prenumerationsomfånget.

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

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]
                         [--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 prenumerationsomfånget från en fjärrmallfil med parametrar från en lokal JSON-fil.

az deployment sub create --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Skapa en distribution i prenumerationsomfånget från en lokal mallfil med hjälp av parametrar från en JSON-sträng.

az deployment sub create --location WestUS --template-file azuredeploy.json  \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

Skapa en distribution i prenumerationsomfånget från en lokal mall med hjälp av en parameterfil, en fjärrparfil och selektivt åsidosätta nyckel-/värdepar.

az deployment sub create --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.

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.

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

Godkända 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 @{path} syntax, 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 det What-If resultatet 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 What-If resultat. Gäller när --confirm-with-what-if har angetts.

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

Formatet för What-If resultat. Gäller när --confirm-with-what-if anges.

Godkända 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.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

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

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az deployment sub delete

Redigera

Ta bort en distribution i prenumerationsomfånget.

az deployment sub delete --name
                         [--no-wait]

Exempel

Ta bort en distribution i prenumerationsomfånget.

az deployment sub delete -n deployment01

Obligatoriska parametrar

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

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

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

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az deployment sub export

Redigera

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

az deployment sub export --name

Exempel

Exportera mallen som används för en distribution i prenumerationsomfånget.

az deployment sub export --name MyDeployment

Obligatoriska parametrar

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

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

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

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az deployment sub list

Redigera

Visa en lista över distributioner i prenumerationsomfånget.

az deployment sub list [--filter]

Exempel

Visa en lista över distributioner i prenumerationsomfånget.

az deployment sub list

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://learn.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.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

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

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az deployment sub show

Redigera

Visa en distribution i prenumerationsomfånget.

az deployment sub show --name

Exempel

Visa en distribution i prenumerationsomfånget.

az deployment sub show -n deployment01

Obligatoriska parametrar

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

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

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

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az deployment sub validate

Redigera

Kontrollera om en mall är giltig i prenumerationsomfånget.

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

az deployment sub validate --location
                           [--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 prenumerationsomfånget.

az deployment sub validate --location westus2 --template-file {template-file}

Kontrollera om en mall är giltig i prenumerationsomfånget. (automatiskt genererad)

az deployment sub validate --location westus2 --parameters MyValue=This MyArray=@array.json --template-file azuredeploy.json

Obligatoriska parametrar

--location -l

Platsen där distributionsmetadata ska lagras.

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

Godkända 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 @{path} syntax, 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.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

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

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az deployment sub wait

Redigera

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

az deployment sub wait --name
                       [--created]
                       [--custom]
                       [--deleted]
                       [--exists]
                       [--interval]
                       [--timeout]
                       [--updated]

Exempel

Placera CLI i vänteläge tills ett distributionsvillkor uppfylls. (automatiskt genererad)

az deployment sub wait --created --name MyDeployment

Obligatoriska parametrar

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

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

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

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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

az deployment sub what-if

Redigera

Kör en distribution What-If åtgärd i prenumerationsomfånget.

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

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]

Exempel

Kör en distributionsåtgärd What-If i en prenumeration.

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Kör en distribution What-If åtgärd i en prenumeration med ResourceIdOnly-format.

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Kör en distribution What-If åtgärd i en prenumeration utan att skriva ut resultatet.

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Obligatoriska parametrar

--location -l

Platsen där distributionen ska lagras What-If åtgärdsmetadata.

Valfria parametrar

--exclude-change-types -x

Blankstegsavgränsad lista över resursändringstyper som ska undantas från What-If resultat.

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

Distributionsnamnet.

--no-pretty-print

Inaktivera snygg utskrift för What-If resultat. 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 falskt.

Godkända 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 @{path} syntax, 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 What-If resultat.

Godkända 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.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

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

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

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