Delen via


az deployment group

Azure Resource Manager-sjabloonimplementatie beheren bij de resourcegroep.

Opdracht

Name Description Type Status
az deployment group cancel

Annuleer een implementatie bij de resourcegroep.

Basis GA
az deployment group create

Start een implementatie bij de resourcegroep.

Basis GA
az deployment group delete

Een implementatie bij de resourcegroep verwijderen.

Basis GA
az deployment group export

Exporteer de sjabloon die wordt gebruikt voor een implementatie.

Basis GA
az deployment group list

Implementaties in de resourcegroep weergeven.

Basis GA
az deployment group show

Een implementatie weergeven in de resourcegroep.

Basis GA
az deployment group validate

Controleer of een sjabloon geldig is in de resourcegroep.

Basis GA
az deployment group wait

Plaats de CLI in een wachtstatus totdat aan een implementatievoorwaarde is voldaan.

Basis GA
az deployment group what-if

Voer een what-if-implementatiebewerking uit op het bereik van de resourcegroep.

Basis GA

az deployment group cancel

Annuleer een implementatie bij de resourcegroep.

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

Voorbeelden

Annuleer een implementatie bij de resourcegroep.

az deployment group cancel -g testrg -n deployment01

Vereiste parameters

--name -n

De implementatienaam.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az deployment group create

Start een implementatie bij de resourcegroep.

Geef slechts één van het bestand --template-file op | --template-URI-URI | --template-spec om de ARM-sjabloon in te voeren.

az deployment group create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--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]
                           [--rollback-on-error]
                           [--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}]

Voorbeelden

Maak een implementatie bij de resourcegroep vanuit een extern sjabloonbestand met behulp van parameters uit een lokaal JSON-bestand.

az deployment group create --resource-group testrg --name rollout01 \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Maak een implementatie bij de resourcegroep op basis van een lokaal sjabloonbestand met behulp van parameters uit een JSON-tekenreeks.

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json  \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

Maak een implementatie bij de resourcegroep op basis van een lokaal sjabloonbestand met behulp van parameters uit een matrixtekenreeks.

az deployment group create --resource-group testgroup --template-file demotemplate.json --parameters exampleString='inline string' exampleArray='("value1", "value2")'

Maak een implementatie bij de resourcegroep op basis van een lokale sjabloon met behulp van een parameterbestand, een extern parameterbestand en selectief overschrijven van sleutel-/waardeparen.

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json  --parameters @params.json \
    --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Een implementatie op resourcegroepbereik maken op basis van een sjabloonspecificatie

az deployment group create --resource-group testrg --template-spec "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Resources/templateSpecs/myTemplateSpec/versions/1.0"

Een implementatie maken op resourcegroepbereik vanuit een bicepparam-parameterbestand

az deployment group create --resource-group testrg --parameters parameters.bicepparam

Een implementatie maken in de resourcegroep tussen tenants

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json --parameters @myparameters.json --aux-tenants auxiliary_tenant01 auxiliary_tenant02

Vereiste parameters

--resource-group -g

De resourcegroep voor het maken van implementatie op.

Optionele parameters

--aux-subs
Afgeschaft

Optie '--aux-subs' is afgeschaft en wordt verwijderd in een toekomstige release. Gebruik in plaats daarvan '--aux-tenants'.

Hulpabonnementen die worden gebruikt tijdens de implementatie in tenants.

--aux-tenants

Hulptenants die worden gebruikt tijdens de implementatie tussen tenants.

--confirm-with-what-if -c

Geef de opdracht de opdracht om wat-als-implementatie uit te voeren voordat u de implementatie uitvoert. Vervolgens wordt u gevraagd om resourcewijzigingen te bevestigen voordat deze doorgaat.

--handle-extended-json-format -j
Afgeschaft

Optie '--handle-extended-json-format/-j' is afgeschaft en wordt verwijderd in een toekomstige release.

Ondersteuning voor het afhandelen van uitgebreide sjablooninhoud, inclusief meerdere regels en opmerkingen in de implementatie.

--mode

De implementatiemodus.

Geaccepteerde waarden: Complete, Incremental
Default value: Incremental
--name -n

De implementatienaam.

--no-prompt

De optie voor het uitschakelen van de prompt voor ontbrekende parameters voor een ARM-sjabloon. Wanneer de waarde waar is, wordt de prompt die gebruikers vragen om een ontbrekende parameter op te geven genegeerd. De standaardwaarde is false.

Geaccepteerde waarden: false, true
Default value: False
--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Default value: False
--parameters -p

Geef waarden voor de implementatieparameter op.

Parameters kunnen worden opgegeven uit een bestand met behulp van de @{path} syntaxis, een JSON-tekenreeks of als <SLEUTEL=WAARDE-paren> . Parameters worden op volgorde geëvalueerd, dus wanneer er twee keer een waarde wordt toegewezen, wordt de laatste waarde gebruikt. U wordt aangeraden eerst het parameterbestand op te leveren en vervolgens selectief te overschrijven met behulp van de syntaxis KEY=VALUE. Als u een bicepparam-bestand opgeeft, kunt u dit argument slechts één keer gebruiken.

--proceed-if-no-change

Geef de opdracht de opdracht om de implementatie uit te voeren als het What-If-resultaat geen resourcewijzigingen bevat. Van toepassing wanneer --confirm-with-what-if is ingesteld.

--query-string -q

De querytekenreeks (een SAS-token) die moet worden gebruikt met de sjabloon-URI in het geval van gekoppelde sjablonen.

--rollback-on-error

De naam van een implementatie om terug te keren naar fout, of gebruik deze als vlag om terug te keren naar de laatste geslaagde implementatie.

--template-file -f

Het pad naar het sjabloonbestand of Bicep-bestand.

--template-spec -s

De resource-id van de sjabloonspecificatie.

--template-uri -u

De URI naar het sjabloonbestand.

--what-if -w

Geef de opdracht de opdracht om de what-if-implementatie uit te voeren.

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

Door spaties gescheiden lijst met resourcewijzigingstypen die moeten worden uitgesloten van What-If-resultaten. Van toepassing wanneer --confirm-with-what-if is ingesteld.

Geaccepteerde waarden: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--what-if-result-format -r

De indeling van What-If-resultaten. Van toepassing wanneer --confirm-with-what-if deze is ingesteld.

Geaccepteerde waarden: FullResourcePayloads, ResourceIdOnly
Default value: FullResourcePayloads
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az deployment group delete

Een implementatie bij de resourcegroep verwijderen.

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

Voorbeelden

Een implementatie bij de resourcegroep verwijderen.

az deployment group delete -g testrg -n deployment01

Vereiste parameters

--name -n

De implementatienaam.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Default value: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az deployment group export

Exporteer de sjabloon die wordt gebruikt voor een implementatie.

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

Voorbeelden

Exporteer de sjabloon die wordt gebruikt voor een implementatie in de resourcegroep.

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

Vereiste parameters

--name -n

De implementatienaam.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az deployment group list

Implementaties in de resourcegroep weergeven.

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

Voorbeelden

Implementaties in de resourcegroep weergeven.

az deployment group list -g testrg

Vereiste parameters

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--filter
Preview

Filterexpressie met behulp van OData-notatie. U kunt --filter 'provisioningState eq '{state}' gebruiken om provisioningState te filteren. Ga voor meer informatie naar https://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az deployment group show

Een implementatie weergeven in de resourcegroep.

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

Voorbeelden

Een implementatie weergeven in de resourcegroep.

az deployment group show -g testrg -n deployment01

Vereiste parameters

--name -n

De implementatienaam.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az deployment group validate

Controleer of een sjabloon geldig is in de resourcegroep.

Geef slechts één van het bestand --template-file op | --template-URI-URI | --template-spec om de ARM-sjabloon in te voeren.

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

Voorbeelden

Controleer of een sjabloon geldig is in de resourcegroep.

az deployment group validate --resource-group testrg --template-file {template-file}

Controleer of een sjabloon geldig is in de resourcegroep. (automatisch gegenereerd)

az deployment group validate --parameters MyValue=This MyArray=@array.json --resource-group testrg --template-file azuredeploy.json

Vereiste parameters

--resource-group -g

De resourcegroep voor het maken van implementatie op.

Optionele parameters

--handle-extended-json-format -j
Afgeschaft

Optie '--handle-extended-json-format/-j' is afgeschaft en wordt verwijderd in een toekomstige release.

Ondersteuning voor het afhandelen van uitgebreide sjablooninhoud, inclusief meerdere regels en opmerkingen in de implementatie.

--mode

De implementatiemodus.

Geaccepteerde waarden: Complete, Incremental
Default value: Incremental
--name -n

De implementatienaam.

--no-prompt

De optie voor het uitschakelen van de prompt voor ontbrekende parameters voor een ARM-sjabloon. Wanneer de waarde waar is, wordt de prompt die gebruikers vragen om een ontbrekende parameter op te geven genegeerd. De standaardwaarde is false.

Geaccepteerde waarden: false, true
Default value: False
--parameters -p

Geef waarden voor de implementatieparameter op.

Parameters kunnen worden opgegeven uit een bestand met behulp van de @{path} syntaxis, een JSON-tekenreeks of als <SLEUTEL=WAARDE-paren> . Parameters worden op volgorde geëvalueerd, dus wanneer er twee keer een waarde wordt toegewezen, wordt de laatste waarde gebruikt. U wordt aangeraden eerst het parameterbestand op te leveren en vervolgens selectief te overschrijven met behulp van de syntaxis KEY=VALUE.

--query-string -q

De querytekenreeks (een SAS-token) die moet worden gebruikt met de sjabloon-URI in het geval van gekoppelde sjablonen.

--rollback-on-error

De naam van een implementatie om terug te keren naar fout, of gebruik deze als vlag om terug te keren naar de laatste geslaagde implementatie.

--template-file -f

Het pad naar het sjabloonbestand of Bicep-bestand.

--template-spec -s

De resource-id van de sjabloonspecificatie.

--template-uri -u

De URI naar het sjabloonbestand.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az deployment group wait

Plaats de CLI in een wachtstatus totdat aan een implementatievoorwaarde is voldaan.

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

Voorbeelden

Plaats de CLI in een wachtstatus totdat aan een implementatievoorwaarde is voldaan. (automatisch gegenereerd)

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

Vereiste parameters

--name -n

De implementatienaam.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--created

Wacht totdat u 'provisioningState' hebt gemaakt bij 'Succeeded'.

Default value: False
--custom

Wacht tot de voorwaarde voldoet aan een aangepaste JMESPath-query. Bijvoorbeeld provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wacht totdat deze is verwijderd.

Default value: False
--exists

Wacht tot de resource bestaat.

Default value: False
--interval

Polling-interval in seconden.

Default value: 30
--timeout

Maximale wachttijd in seconden.

Default value: 3600
--updated

Wacht totdat deze is bijgewerkt met provisioningState op 'Succeeded'.

Default value: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az deployment group what-if

Voer een what-if-implementatiebewerking uit op het bereik van de resourcegroep.

Geef slechts één van het bestand --template-file op | --template-URI-URI | --template-spec om de ARM-sjabloon in te voeren.

az deployment group what-if --resource-group
                            [--aux-tenants]
                            [--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                            [--mode {Complete, Incremental}]
                            [--name]
                            [--no-pretty-print]
                            [--no-prompt {false, true}]
                            [--parameters]
                            [--query-string]
                            [--result-format {FullResourcePayloads, ResourceIdOnly}]
                            [--template-file]
                            [--template-spec]
                            [--template-uri]

Voorbeelden

Voer een what-if-implementatiebewerking uit in een resourcegroep.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Voer een what-if-implementatiebewerking uit in een resourcegroep met de ResourceIdOnly-indeling.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Voer een wat-als-implementatiebewerking uit in een resourcegroep zonder het resultaat mooi af te drukken.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Vereiste parameters

--resource-group -g

De resourcegroep voor het uitvoeren van de what-if-implementatiebewerking op.

Optionele parameters

--aux-tenants

Hulptenants die worden gebruikt tijdens de implementatie tussen tenants.

--exclude-change-types -x

Door spaties gescheiden lijst met resourcewijzigingstypen die moeten worden uitgesloten van What-If-resultaten.

Geaccepteerde waarden: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--mode

De implementatiemodus.

Geaccepteerde waarden: Complete, Incremental
Default value: Incremental
--name -n

De implementatienaam.

--no-pretty-print

Schakel vrij afdrukken uit voor What-If-resultaten. Wanneer dit is ingesteld, wordt het type uitvoerindeling gebruikt.

--no-prompt

De optie voor het uitschakelen van de prompt voor ontbrekende parameters voor een ARM-sjabloon. Wanneer de waarde waar is, wordt de prompt die gebruikers vragen om een ontbrekende parameter op te geven genegeerd. De standaardwaarde is false.

Geaccepteerde waarden: false, true
Default value: False
--parameters -p

Geef waarden voor de implementatieparameter op.

Parameters kunnen worden opgegeven uit een bestand met behulp van de @{path} syntaxis, een JSON-tekenreeks of als <SLEUTEL=WAARDE-paren> . Parameters worden op volgorde geëvalueerd, dus wanneer er twee keer een waarde wordt toegewezen, wordt de laatste waarde gebruikt. U wordt aangeraden eerst het parameterbestand op te leveren en vervolgens selectief te overschrijven met behulp van de syntaxis KEY=VALUE.

--query-string -q

De querytekenreeks (een SAS-token) die moet worden gebruikt met de sjabloon-URI in het geval van gekoppelde sjablonen.

--result-format -r

De indeling van What-If-resultaten.

Geaccepteerde waarden: FullResourcePayloads, ResourceIdOnly
Default value: FullResourcePayloads
--template-file -f

Het pad naar het sjabloonbestand of Bicep-bestand.

--template-spec -s

De resource-id van de sjabloonspecificatie.

--template-uri -u

De URI naar het sjabloonbestand.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.