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. |
Core | GA |
| az deployment group create |
Start een implementatie bij de resourcegroep. |
Core | GA |
| az deployment group delete |
Een implementatie bij de resourcegroep verwijderen. |
Core | GA |
| az deployment group export |
Exporteer de sjabloon die wordt gebruikt voor een implementatie. |
Core | GA |
| az deployment group list |
Implementaties in de resourcegroep weergeven. |
Core | GA |
| az deployment group show |
Een implementatie weergeven in de resourcegroep. |
Core | GA |
| az deployment group validate |
Controleer of een sjabloon geldig is in de resourcegroep. |
Core | GA |
| az deployment group wait |
Plaats de CLI in een wachtstatus totdat aan een implementatievoorwaarde is voldaan. |
Core | GA |
| az deployment group what-if |
Voer een implementatie What-If bewerking uit op het bereik van de resourcegroep. |
Core | 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.
Naam van 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.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van 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.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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]
[--validation-level {Provider, ProviderNoRbac, Template}]
[--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
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
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.
Instrueer de opdracht om de implementatie uit te voeren What-If 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.
| Eigenschap | Waarde |
|---|---|
| Default value: | Incremental |
| Geaccepteerde waarden: | Complete, Incremental |
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 onwaar.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
| Geaccepteerde waarden: | false, true |
Wacht niet totdat de langdurige bewerking is voltooid.
| Eigenschap | Waarde |
|---|---|
| Default value: | 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 <KEY=VALUE> 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.
Het validatieniveau van de implementatie. Kan worden ingesteld op 'Provider' (de standaardinstelling), 'Sjabloon' of 'ProviderNoRbac'. Met een validatieniveau van 'provider' voert ARM volledige validatie uit en controleert u of u voldoende machtigingen hebt om alle resources in de sjabloon te implementeren. Met een validatieniveau van 'providerNoRbac' voert ARM volledige validatie uit, maar controleert arm alleen op leesmachtigingen voor elke resource. Met een validatieniveau van 'sjabloon' wordt alleen statische validatie uitgevoerd: preflight en machtigingencontroles worden overgeslagen.
| Eigenschap | Waarde |
|---|---|
| Geaccepteerde waarden: | Provider, ProviderNoRbac, Template |
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.
| Eigenschap | Waarde |
|---|---|
| Geaccepteerde waarden: | Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported |
De indeling van What-If resultaten. Van toepassing wanneer --confirm-with-what-if is ingesteld.
| Eigenschap | Waarde |
|---|---|
| Default value: | FullResourcePayloads |
| Geaccepteerde waarden: | FullResourcePayloads, ResourceIdOnly |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van 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.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Optionele parameters
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
Wacht niet totdat de langdurige bewerking is voltooid.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van 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.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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.
Naam van 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.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van 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.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Optionele parameters
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
Filterexpressie met behulp van OData-notatie. U kunt --filter 'provisioningState eq '{state}' gebruiken om provisioningState te filteren. Ga naar https://learn.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parametersvoor meer informatie.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van 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.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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.
Naam van 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.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van 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.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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]
[--validation-level {Provider, ProviderNoRbac, Template}]
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. (autogenerated)
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
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
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.
| Eigenschap | Waarde |
|---|---|
| Default value: | Incremental |
| Geaccepteerde waarden: | Complete, Incremental |
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 onwaar.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
| Geaccepteerde waarden: | false, true |
Geef waarden voor de implementatieparameter op.
Parameters kunnen worden opgegeven uit een bestand met behulp van de @{path} syntaxis, een JSON-tekenreeks of als <KEY=VALUE> 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.
Het validatieniveau van de implementatie. Kan worden ingesteld op 'Provider' (de standaardinstelling), 'Sjabloon' of 'ProviderNoRbac'. Met een validatieniveau van 'provider' voert ARM volledige validatie uit en controleert u of u voldoende machtigingen hebt om alle resources in de sjabloon te implementeren. Met een validatieniveau van 'providerNoRbac' voert ARM volledige validatie uit, maar controleert arm alleen op leesmachtigingen voor elke resource. Met een validatieniveau van 'sjabloon' wordt alleen statische validatie uitgevoerd: preflight en machtigingencontroles worden overgeslagen.
| Eigenschap | Waarde |
|---|---|
| Geaccepteerde waarden: | Provider, ProviderNoRbac, Template |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van 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.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
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. (autogenerated)
az deployment group wait --created --name MyDeployment --resource-group MyResourceGroup
Vereiste parameters
De implementatienaam.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Optionele parameters
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
Wacht totdat u 'provisioningState' hebt gemaakt bij 'Succeeded'.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Wait Condition Arguments |
| Default value: | False |
Wacht tot de voorwaarde voldoet aan een aangepaste JMESPath-query. Bijvoorbeeld provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Wait Condition Arguments |
Wacht totdat deze is verwijderd.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Wait Condition Arguments |
| Default value: | False |
Wacht tot de resource bestaat.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Wait Condition Arguments |
| Default value: | False |
Polling-interval in seconden.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Wait Condition Arguments |
| Default value: | 30 |
Maximale wachttijd in seconden.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Wait Condition Arguments |
| Default value: | 3600 |
Wacht totdat deze is bijgewerkt met provisioningState op 'Succeeded'.
| Eigenschap | Waarde |
|---|---|
| Parametergroep: | Wait Condition Arguments |
| Default value: | False |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van 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.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
az deployment group what-if
Voer een implementatie What-If bewerking 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]
[--validation-level {Provider, ProviderNoRbac, Template}]
Voorbeelden
Voer een implementatie What-If bewerking 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 implementatie What-If bewerking 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 implementatie What-If bewerking 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 implementatie What-If bewerking op.
Optionele parameters
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
Hulptenants die worden gebruikt tijdens de implementatie tussen tenants.
Door spaties gescheiden lijst met resourcewijzigingstypen die moeten worden uitgesloten van What-If resultaten.
| Eigenschap | Waarde |
|---|---|
| Geaccepteerde waarden: | Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported |
De implementatiemodus.
| Eigenschap | Waarde |
|---|---|
| Default value: | Incremental |
| Geaccepteerde waarden: | Complete, Incremental |
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 onwaar.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
| Geaccepteerde waarden: | false, true |
Geef waarden voor de implementatieparameter op.
Parameters kunnen worden opgegeven uit een bestand met behulp van de @{path} syntaxis, een JSON-tekenreeks of als <KEY=VALUE> 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.
| Eigenschap | Waarde |
|---|---|
| Default value: | FullResourcePayloads |
| Geaccepteerde waarden: | FullResourcePayloads, ResourceIdOnly |
Het pad naar het sjabloonbestand of Bicep-bestand.
De resource-id van de sjabloonspecificatie.
De URI naar het sjabloonbestand.
Het validatieniveau van de implementatie. Kan worden ingesteld op 'Provider' (de standaardinstelling), 'Sjabloon' of 'ProviderNoRbac'. Met een validatieniveau van 'provider' voert ARM volledige validatie uit en controleert u of u voldoende machtigingen hebt om alle resources in de sjabloon te implementeren. Met een validatieniveau van 'providerNoRbac' voert ARM volledige validatie uit, maar controleert arm alleen op leesmachtigingen voor elke resource. Met een validatieniveau van 'sjabloon' wordt alleen statische validatie uitgevoerd: preflight en machtigingencontroles worden overgeslagen.
| Eigenschap | Waarde |
|---|---|
| Geaccepteerde waarden: | Provider, ProviderNoRbac, Template |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van 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.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |