az group deployment

Hantera Azure Resource Manager-distributioner.

Kommandon

az group deployment cancel

Avbryter en malldistribution som körs.

az group deployment create

Starta en distribution.

az group deployment delete

Tar bort en distribution från distributionshistoriken.

az group deployment export

Exportera den mall som används för en distribution.

az group deployment list

Hämta alla distributioner för en resursgrupp.

az group deployment operation

Hantera distributionsåtgärder.

az group deployment operation list

Hämtar alla distributionsåtgärder för en distribution.

az group deployment operation show

Hämta en distributionsåtgärd.

az group deployment show

Hämtar en distribution.

az group deployment validate

Kontrollera om en mall är syntaktiskt korrekt.

az group deployment wait

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

az group deployment cancel

Avbryter en malldistribution som körs.

Du kan bara avbryta en distribution om provisioningState är Godkänd eller Körs. När distributionen har avbrutits ställs provisioningState in på Avbryt. Om du avbryter en malldistribution stoppas den malldistribution som körs och resursgruppen är delvis distribuerad.

az group deployment cancel --name
                           --resource-group

Obligatoriska parametrar

--name -n

Distributionsnamnet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

az group deployment create

Starta en distribution.

az group deployment create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--rollback-on-error]
                           [--template-file]
                           [--template-uri]

Exempel

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

az group deployment create -g MyResourceGroup --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters "{ \"location\": { \"value\": \"westus\" } }"

Skapa en distribution från en lokal mall med hjälp av en lokal parameterfil, en fjärrparameterfil och selektivt åsidosätta nyckel/värde-par.

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Obligatoriska parametrar

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

--aux-subs

Hjälpprenumerationer som kommer att användas under distributionen mellan klienter.

--aux-tenants

Hjälpklienter som kommer att användas under distributionen mellan klienter.

--handle-extended-json-format -j

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

--mode

Inkrementell (lägg bara till resurser i resursgruppen) eller Slutför (ta bort extra resurser från resursgruppen).

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

Distributionsnamnet. Standardinställningen är mallfilens basnamn.

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

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

--parameters -p

Ange parametervärden för distribution.

--rollback-on-error

Namnet på en distribution som ska återställas till vid fel, eller använd som en flagga för att återställa till den senaste lyckade distributionen.

--template-file -f

En sökväg till en mallfil eller en Bicep-fil i filsystemet.

--template-uri -u

En URI till en fjärrmallfil.

az group deployment delete

Tar bort en distribution från distributionshistoriken.

Det går inte att ta bort en malldistribution som för närvarande körs. Om du tar bort en malldistribution tas de associerade distributionsåtgärderna bort. Om du tar bort en malldistribution påverkas inte resursgruppens tillstånd. Det här är en asynkron åtgärd som returnerar statusen 202 tills malldistributionen har tagits bort. Svarshuvudet Plats innehåller den URI som används för att hämta status för processen. När processen körs returnerar ett anrop till URI:n i location-huvudet statusen 202. När processen är klar returnerar URI:n i location-huvudet statusen 204 när åtgärden lyckades. Om den asynkrona begäran misslyckades returnerar URI:n i platshuvudet en statuskod på felnivå.

az group deployment delete --name
                           --resource-group
                           [--no-wait]

Obligatoriska parametrar

--name -n

Distributionsnamnet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

--no-wait

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

az group deployment export

Exportera den mall som används för en distribution.

az group deployment export --name
                           --resource-group

Exempel

Exportera den mall som används för en distribution. (genereras automatiskt)

az group deployment export --name MyDeployment --resource-group MyResourceGroup

Obligatoriska parametrar

--name -n

Distributionsnamnet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

az group deployment list

Hämta alla distributioner för en resursgrupp.

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

Obligatoriska parametrar

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

--filter

Filtret som ska tillämpas på åtgärden. Du kan till exempel använda $filter=provisioningState eq {state}. Standardvärdet är Ingen.

--top

Antalet resultat som ska hämtas. Om null skickas returneras alla distributioner. Standardvärdet är Ingen.

az group deployment show

Hämtar en distribution.

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

Obligatoriska parametrar

--name -n

Distributionsnamnet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

az group deployment validate

Kontrollera om en mall är syntaktiskt korrekt.

az group deployment validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--rollback-on-error]
                             [--template-file]
                             [--template-uri]

Exempel

Kontrollera om en mall är syntaktiskt korrekt. (genereras automatiskt)

az group deployment validate --parameters "{ \"location\": { \"value\": \"westus\" } }" \
    --resource-group MyResourceGroup --template-file storage.json

Obligatoriska parametrar

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

--handle-extended-json-format -j

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

--mode

Inkrementell (lägg bara till resurser i resursgruppen) eller Slutför (ta bort extra resurser från resursgruppen).

accepterade värden: Complete, Incremental
standardvärde: Incremental
--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
--parameters -p

Ange parametervärden för distribution.

--rollback-on-error

Namnet på en distribution som ska återställas till vid fel, eller använd som en flagga för att återställa till den senaste lyckade distributionen.

--template-file -f

En sökväg till en mallfil eller en Bicep-fil i filsystemet.

--template-uri -u

En URI till en fjärrmallfil.

az group deployment wait

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

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

Exempel

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

az group deployment wait --name MyDeployment --resource-group MyResourceGroup --updated

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

az group deployment wait --created --name MyDeployment --resource-group MyResourceGroup

Obligatoriska parametrar

--name -n

Distributionsnamnet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

--created

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

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

--exists

Vänta tills resursen finns.

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