az deployment group

De Azure Resource Manager sjabloonimplementatie in de resourcegroep beheren.

Opdracht

az deployment group cancel

Annuleer een implementatie in de resourcegroep.

az deployment group create

Start een implementatie in de resourcegroep.

az deployment group delete

Verwijder een implementatie in de resourcegroep.

az deployment group export

De sjabloon exporteren die is gebruikt voor een implementatie.

az deployment group list

Lijst met implementaties in de resourcegroep.

az deployment group show

Een implementatie in de resourcegroep tonen.

az deployment group validate

Valideer of een sjabloon geldig is voor de resourcegroep.

az deployment group wait

Plaats de CLI in een wachttoestand totdat aan een implementatievoorwaarde wordt voldaan.

az deployment group what-if

Voer een implementatie-What-If uit op het bereik van de resourcegroep.

az deployment group cancel

Annuleer een implementatie in de resourcegroep.

az deployment group cancel --name
                           --resource-group
                           [--subscription]

Voorbeelden

Annuleer een implementatie in de resourcegroep.

az deployment group cancel -g testrg -n deployment01

Vereiste parameters

--name -n

De naam van de implementatie.

--resource-group -g

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

Optionele parameters

--subscription

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

az deployment group create

Start een implementatie in de resourcegroep.

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]
                           [--subscription]
                           [--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 in de resourcegroep op basis van 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 in 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 in de resourcegroep op basis van een lokaal sjabloonbestand met behulp van parameters uit een matrixreeks.

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

Maak een implementatie in de resourcegroep op basis van een lokale sjabloon met behulp van een parameterbestand, een extern parameterbestand en het 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 maken op abonnementsbereik 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"

Vereiste parameters

--resource-group -g

De resourcegroep voor het maken van implementatie op.

Optionele parameters

--aux-subs

Aanvullende abonnementen die worden gebruikt tijdens de implementatie tussen tenants.

--aux-tenants

Aanvullende tenants die worden gebruikt tijdens de implementatie tussen tenants.

--confirm-with-what-if -c

Instrueren de opdracht om implementatie-What-If uit te voeren voordat de implementatie wordt uitgevoerd. Vervolgens wordt u gevraagd om wijzigingen in de resource te bevestigen voordat deze worden voortgezet.

--handle-extended-json-format -j

Ondersteuning voor het verwerken van uitgebreide sjablooninhoud, inclusief meerderelijnen en opmerkingen in de implementatie.

--mode

De implementatiemodus.

geaccepteerde waarden: Complete, Incremental
standaardwaarde: Incremental
--name -n

De naam van de implementatie.

--no-prompt

De optie om de prompt met ontbrekende parameters voor de ARM-sjabloon uit te schakelen. Wanneer de waarde true is, wordt de prompt waarvoor gebruikers ontbrekende parameter moeten opgeven, genegeerd. De standaardwaarde is false.

geaccepteerde waarden: false, true
--no-wait

Wacht niet tot de langlopende bewerking is uitgevoerd.

--parameters -p

Waarden voor implementatieparameters opgeven.

--proceed-if-no-change

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

--query-string -q

De queryreeks (een SAS-token) die moet worden gebruikt met de template-uri in het geval van gekoppelde sjablonen.

--rollback-on-error

De naam van een implementatie die bij een fout moet worden terugdraaien, of als vlag gebruiken om terug te draaien naar de laatste geslaagde implementatie.

--subscription

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

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

Instrueert u de opdracht om implementatie What-If 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 is ingesteld.

geaccepteerde waarden: FullResourcePayloads, ResourceIdOnly
standaardwaarde: FullResourcePayloads

az deployment group delete

Verwijder een implementatie in de resourcegroep.

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

Voorbeelden

Verwijder een implementatie in de resourcegroep.

az deployment group delete -g testrg -n deployment01

Vereiste parameters

--name -n

De naam van de implementatie.

--resource-group -g

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

Optionele parameters

--no-wait

Wacht niet tot de langlopende bewerking is uitgevoerd.

--subscription

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

az deployment group export

De sjabloon exporteren die is gebruikt voor een implementatie.

az deployment group export --name
                           --resource-group
                           [--subscription]

Voorbeelden

Exporteert 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 naam van de implementatie.

--resource-group -g

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

Optionele parameters

--subscription

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

az deployment group list

Lijst met implementaties in de resourcegroep.

az deployment group list --resource-group
                         [--filter]
                         [--query-examples]
                         [--subscription]

Voorbeelden

Lijst met implementaties in de resourcegroep.

az deployment group list -g testrg

Vereiste parameters

--resource-group -g

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

Optionele parameters

--filter

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

--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiƫren en plakken na de parameter --query tussen dubbele aanhalingstekens om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

--subscription

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

az deployment group show

Een implementatie in de resourcegroep tonen.

az deployment group show --name
                         --resource-group
                         [--query-examples]
                         [--subscription]

Voorbeelden

Een implementatie in de resourcegroep tonen.

az deployment group show -g testrg -n deployment01

Vereiste parameters

--name -n

De naam van de implementatie.

--resource-group -g

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

Optionele parameters

--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiƫren en plakken na de parameter --query tussen dubbele aanhalingstekens om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

--subscription

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

az deployment group validate

Valideer of een sjabloon geldig is voor de resourcegroep.

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

Voorbeelden

Valideer of een sjabloon geldig is voor de resourcegroep.

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

Valideer of een sjabloon geldig is voor 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

Ondersteuning voor het verwerken van uitgebreide sjablooninhoud, inclusief meerderelijnen en opmerkingen in de implementatie.

--mode

De implementatiemodus.

geaccepteerde waarden: Complete, Incremental
standaardwaarde: Incremental
--name -n

De naam van de implementatie.

--no-prompt

De optie om de prompt met ontbrekende parameters voor de ARM-sjabloon uit te schakelen. Wanneer de waarde true is, wordt de prompt waarvoor gebruikers ontbrekende parameter moeten opgeven, genegeerd. De standaardwaarde is false.

geaccepteerde waarden: false, true
--parameters -p

Waarden voor implementatieparameters opgeven.

--query-string -q

De queryreeks (een SAS-token) die moet worden gebruikt met de template-uri in het geval van gekoppelde sjablonen.

--rollback-on-error

De naam van een implementatie die bij een fout moet worden terugdraaien, of als vlag gebruiken om terug te draaien naar de laatste geslaagde implementatie.

--subscription

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

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

az deployment group wait

Plaats de CLI in een wachttoestand totdat aan een implementatievoorwaarde wordt voldaan.

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

Voorbeelden

Plaats de CLI in een wachttoestand totdat aan een implementatievoorwaarde wordt voldaan. (automatisch gegenereerd)

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

Vereiste parameters

--name -n

De naam van de implementatie.

--resource-group -g

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

Optionele parameters

--created

Wacht totdat u met provisioningState bij Succeeded hebt gemaakt.

--custom

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

--deleted

Wacht totdat u deze hebt verwijderd.

--exists

Wacht totdat de resource bestaat.

--interval

Pollinginterval in seconden.

standaardwaarde: 30
--subscription

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

--timeout

Maximale wachttijd in seconden.

standaardwaarde: 3600
--updated

Wacht totdat de provisioningState is bijgewerkt op 'Succeeded'.

az deployment group what-if

Voer een implementatie-What-If uit op het bereik van de resourcegroep.

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}]
                            [--subscription]
                            [--template-file]
                            [--template-spec]
                            [--template-uri]

Voorbeelden

Voer een implementatie What-If een resourcegroep uit.

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

Voer een implementatie What-If op een resourcegroep met resource-idOnly-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 een resourcegroep uit 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 What-If bewerking op .

Optionele parameters

--aux-tenants

Aanvullende tenants 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
standaardwaarde: Incremental
--name -n

De naam van de implementatie.

--no-pretty-print

Schakel pretty-print uit voor What-If resultaten. Wanneer dit is ingesteld, wordt het uitvoerindelingstype gebruikt.

--no-prompt

De optie om het vragen om ontbrekende parameters voor de ARM-sjabloon uit te schakelen. Wanneer de waarde true is, wordt de prompt die vereist dat gebruikers ontbrekende parameter opgeven genegeerd. De standaardwaarde is false.

geaccepteerde waarden: false, true
--parameters -p

Waarden voor implementatieparameters opgeven.

--query-string -q

De queryreeks (een SAS-token) die moet worden gebruikt met de template-uri in het geval van gekoppelde sjablonen.

--result-format -r

De indeling van What-If resultaten.

geaccepteerde waarden: FullResourcePayloads, ResourceIdOnly
standaardwaarde: FullResourcePayloads
--subscription

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

--template-file -f

Het pad naar het sjabloonbestand of bicpe-bestand.

--template-spec -s

De resource-id van de sjabloonspecificatie.

--template-uri -u

De URI naar het sjabloonbestand.