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
De implementatienaam.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
De resourcegroep voor het maken van implementatie op.
Optionele parameters
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.
Hulptenants die worden gebruikt tijdens de implementatie tussen tenants.
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.
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.
De implementatiemodus.
De implementatienaam.
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.
Wacht niet totdat de langdurige bewerking is voltooid.
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.
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.
De querytekenreeks (een SAS-token) die moet worden gebruikt met de sjabloon-URI in het geval van gekoppelde sjablonen.
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.
Het pad naar het sjabloonbestand of Bicep-bestand.
De resource-id van de sjabloonspecificatie.
De URI naar het sjabloonbestand.
Geef de opdracht de opdracht om de what-if-implementatie uit te voeren.
Door spaties gescheiden lijst met resourcewijzigingstypen die moeten worden uitgesloten van What-If-resultaten. Van toepassing wanneer --confirm-with-what-if is ingesteld.
De indeling van What-If-resultaten. Van toepassing wanneer --confirm-with-what-if
deze is ingesteld.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
De implementatienaam.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Optionele parameters
Wacht niet totdat de langdurige bewerking is voltooid.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
De implementatienaam.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Optionele parameters
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
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
De implementatienaam.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
De resourcegroep voor het maken van implementatie op.
Optionele parameters
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.
De implementatiemodus.
De implementatienaam.
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.
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.
De querytekenreeks (een SAS-token) die moet worden gebruikt met de sjabloon-URI in het geval van gekoppelde sjablonen.
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.
Het pad naar het sjabloonbestand of Bicep-bestand.
De resource-id van de sjabloonspecificatie.
De URI naar het sjabloonbestand.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
De implementatienaam.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Optionele parameters
Wacht totdat u 'provisioningState' hebt gemaakt bij 'Succeeded'.
Wacht tot de voorwaarde voldoet aan een aangepaste JMESPath-query. Bijvoorbeeld provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Wacht totdat deze is verwijderd.
Wacht tot de resource bestaat.
Polling-interval in seconden.
Maximale wachttijd in seconden.
Wacht totdat deze is bijgewerkt met provisioningState op 'Succeeded'.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
De resourcegroep voor het uitvoeren van de what-if-implementatiebewerking op.
Optionele parameters
Hulptenants die worden gebruikt tijdens de implementatie tussen tenants.
Door spaties gescheiden lijst met resourcewijzigingstypen die moeten worden uitgesloten van What-If-resultaten.
De implementatiemodus.
De implementatienaam.
Schakel vrij afdrukken uit voor What-If-resultaten. Wanneer dit is ingesteld, wordt het type uitvoerindeling gebruikt.
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.
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.
De querytekenreeks (een SAS-token) die moet worden gebruikt met de sjabloon-URI in het geval van gekoppelde sjablonen.
De indeling van What-If-resultaten.
Het pad naar het sjabloonbestand of Bicep-bestand.
De resource-id van de sjabloonspecificatie.
De URI naar het sjabloonbestand.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.