Dela via


az group deployment

Den här kommandogruppen har blivit inaktuell och tas bort i en framtida version. Använd "distributionsgrupp" i stället.

Hantera Azure Resource Manager-distributioner.

Kommandon

Name Description Typ Status
az group deployment cancel

Avbryter en malldistribution som körs.

Kärna Inaktuell
az group deployment create

Starta en distribution.

Kärna Inaktuell
az group deployment delete

Tar bort en distribution från distributionshistoriken.

Kärna Inaktuell
az group deployment export

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

Kärna Inaktuell
az group deployment list

Hämta alla distributioner för en resursgrupp.

Kärna Inaktuell
az group deployment operation

Hantera distributionsåtgärder.

Kärna Inaktuell
az group deployment operation list

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

Kärna Inaktuell
az group deployment operation show

Hämta en distributionsåtgärd.

Kärna Inaktuell
az group deployment show

Hämtar en distribution.

Kärna Inaktuell
az group deployment validate

Kontrollera om en mall är syntaktiskt korrekt.

Kärna Inaktuell
az group deployment wait

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

Kärna Inaktuell

az group deployment cancel

Inaktuell

Det här kommandot är implicit inaktuellt eftersom kommandogruppen "gruppdistribution" är inaktuell och tas bort i en framtida version. Använd "distributionsgrupp" i stället.

Avbryter en malldistribution som körs.

Du kan bara avbryta en distribution om provisioningState accepteras eller körs. När distributionen har avbrutits är provisioningState inställt på Avbryt. Om du avbryter en malldistribution stoppas malldistributionen 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 .az configure --defaults group=<name>

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 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 group deployment create

Inaktuell

Det här kommandot är implicit inaktuellt eftersom kommandogruppen "gruppdistribution" är inaktuell och tas bort i en framtida version. Använd "distributionsgrupp" i stället.

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ärrparparfil och selektivt åsidosätta nyckel-/värdepar.

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 .az configure --defaults group=<name>

Valfria parametrar

--aux-subs
Inaktuell

Alternativet "--aux-subs" har blivit inaktuellt och tas bort i en framtida version. Använd "--aux-tenants" i stället.

Extraprenumerationer som ska användas under distributionen mellan klientorganisationer.

--aux-tenants

Hjälpklienter som ska användas under distributionen mellan klientorganisationer.

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

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

Godkända värden: Complete, Incremental
Standardvärde: Incremental
--name -n

Distributionsnamnet. Standard för mallfilbasnamnet.

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

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

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

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 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 group deployment delete

Inaktuell

Det här kommandot är implicit inaktuellt eftersom kommandogruppen "gruppdistribution" är inaktuell och tas bort i en framtida version. Använd "distributionsgrupp" i stället.

Tar bort en distribution från distributionshistoriken.

Det går inte att ta bort en malldistribution som körs för närvarande. Om du tar bort en malldistribution tas de associerade distributionsåtgärderna bort. Att ta bort en malldistribution påverkar inte resursgruppens tillstånd. Det här är en asynkron åtgärd som returnerar statusen 202 tills malldistributionen har tagits bort. Platssvarshuvudet innehåller den URI som används för att hämta processens status. När processen körs returnerar ett anrop till URI:n i platsrubriken statusen 202. När processen är klar returnerar URI:n i platsrubriken statusen 204 vid slutförande. 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 .az configure --defaults group=<name>

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 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 group deployment export

Inaktuell

Det här kommandot är implicit inaktuellt eftersom kommandogruppen "gruppdistribution" är inaktuell och tas bort i en framtida version. Använd "distributionsgrupp" i stället.

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

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

Exempel

Exportera mallen som används för en distribution. (automatiskt genererad)

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 .az configure --defaults group=<name>

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 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 group deployment list

Inaktuell

Det här kommandot är implicit inaktuellt eftersom kommandogruppen "gruppdistribution" är inaktuell och tas bort i en framtida version. Använd "distributionsgrupp" i stället.

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 .az configure --defaults group=<name>

Valfria parametrar

--filter

Det filter som ska användas för å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 returnerar alla distributioner. Standardvärdet är Ingen.

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 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 group deployment show

Inaktuell

Det här kommandot är implicit inaktuellt eftersom kommandogruppen "gruppdistribution" är inaktuell och tas bort i en framtida version. Använd "distributionsgrupp" i stället.

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 .az configure --defaults group=<name>

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 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 group deployment validate

Inaktuell

Det här kommandot är implicit inaktuellt eftersom kommandogruppen "gruppdistribution" är inaktuell och tas bort i en framtida version. Använd "distributionsgrupp" i stället.

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. (automatiskt genererad)

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 .az configure --defaults group=<name>

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.

--mode

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

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

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

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

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 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 group deployment wait

Inaktuell

Det här kommandot är implicit inaktuellt eftersom kommandogruppen "gruppdistribution" är inaktuell och tas bort i en framtida version. Använd "distributionsgrupp" i stället.

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. (automatiskt genererad)

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

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

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 .az configure --defaults group=<name>

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