az deployment mg

Azure Resource Manager-sjabloonimplementatie beheren bij beheergroep.

Opdracht

Name	Description	Type	Status
az deployment mg cancel	Annuleer een implementatie bij de beheergroep.	Core	GA
az deployment mg create	Start een implementatie bij de beheergroep.	Core	GA
az deployment mg delete	Een implementatie bij de beheergroep verwijderen.	Core	GA
az deployment mg export	Exporteer de sjabloon die wordt gebruikt voor een implementatie.	Core	GA
az deployment mg list	Implementaties weergeven bij beheergroep.	Core	GA
az deployment mg show	Een implementatie weergeven in de beheergroep.	Core	GA
az deployment mg validate	Controleer of een sjabloon geldig is in de beheergroep.	Core	GA
az deployment mg wait	Plaats de CLI in een wachtstatus totdat aan een implementatievoorwaarde is voldaan.	Core	GA
az deployment mg what-if	Voer een implementatie-What-If-bewerking uit op het bereik van de beheergroep.	Core	GA

az deployment mg cancel

Bewerken

Annuleer een implementatie bij de beheergroep.

az deployment mg cancel --management-group-id
                        --name

Voorbeelden

Annuleer een implementatie bij de beheergroep.

az deployment mg cancel -m testmg -n deployment01

Vereiste parameters

--management-group-id -m

De id van de beheergroep.

--name -n

De implementatienaam.

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Naam of id van 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.

Eigenschap	Waarde
Default value:	False

az deployment mg create

Bewerken

Start een implementatie bij de beheergroep.

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

az deployment mg create --location
                        --management-group-id
                        [--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]
                        [--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 een beheergroep vanuit een extern sjabloonbestand met behulp van parameters uit een lokaal JSON-bestand.

az deployment mg create --management-group-id testrg --name rollout01 --location WestUS \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Maak een implementatie in een beheergroep op basis van een lokaal sjabloonbestand met behulp van parameters uit een JSON-tekenreeks.

az deployment mg create --management-group-id testmg --name rollout01 --location WestUS \
    --template-file azuredeploy.json \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

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

az deployment mg create --management-group-id testmg --name rollout01 --location WestUS \
    --template-file azuredeploy.json --parameters @params.json \
    --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Vereiste parameters

--location -l

De locatie voor het opslaan van de metagegevens van de implementatie.

--management-group-id -m

De beheergroep-id voor het maken van implementatie op.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--confirm-with-what-if -c

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.

--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 modus die wordt gebruikt voor het implementeren van resources. Deze waarde kan incrementeel of voltooid zijn. In de incrementele modus worden resources geïmplementeerd zonder bestaande resources te verwijderen die niet zijn opgenomen in de sjabloon. In de volledige modus worden resources geïmplementeerd en worden bestaande resources in de resourcegroep verwijderd die niet zijn opgenomen in de sjabloon. Wees voorzichtig bij het gebruik van de volledige modus, omdat u resources onbedoeld kunt verwijderen.

Eigenschap	Waarde
Default value:	Incremental
Geaccepteerde waarden:	Complete, 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 onwaar.

Eigenschap	Waarde
Default value:	False
Geaccepteerde waarden:	false, true

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

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

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

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

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

Eigenschap	Waarde
Default value:	FullResourcePayloads
Geaccepteerde waarden:	FullResourcePayloads, ResourceIdOnly

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Naam of id van 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.

Eigenschap	Waarde
Default value:	False

az deployment mg delete

Bewerken

Een implementatie bij de beheergroep verwijderen.

az deployment mg delete --management-group-id
                        --name
                        [--no-wait]

Voorbeelden

Een implementatie bij de beheergroep verwijderen.

az deployment mg delete -m testmg -n deployment01

Vereiste parameters

--management-group-id -m

De id van de beheergroep.

--name -n

De implementatienaam.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Eigenschap	Waarde
Default value:	False

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Naam of id van 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.

Eigenschap	Waarde
Default value:	False

az deployment mg export

Bewerken

Exporteer de sjabloon die wordt gebruikt voor een implementatie.

az deployment mg export --management-group-id
                        --name

Voorbeelden

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

az deployment mg export --management-group-id testmg --name MyDeployment

Vereiste parameters

--management-group-id -m

De id van de beheergroep.

--name -n

De implementatienaam.

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Naam of id van 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.

Eigenschap	Waarde
Default value:	False

az deployment mg list

Bewerken

Implementaties weergeven bij beheergroep.

az deployment mg list --management-group-id
                      [--filter]

Voorbeelden

Implementaties weergeven bij beheergroep.

az deployment mg list -m testmg

Vereiste parameters

--management-group-id -m

De id van de beheergroep.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--filter

Preview

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

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Naam of id van 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.

Eigenschap	Waarde
Default value:	False

az deployment mg show

Bewerken

Een implementatie weergeven in de beheergroep.

az deployment mg show --management-group-id
                      --name

Voorbeelden

Een implementatie weergeven in de beheergroep.

az deployment mg show -m testmg -n deployment01

Vereiste parameters

--management-group-id -m

De id van de beheergroep.

--name -n

De implementatienaam.

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Naam of id van 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.

Eigenschap	Waarde
Default value:	False

az deployment mg validate

Bewerken

Controleer of een sjabloon geldig is in de beheergroep.

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

az deployment mg validate --location
                          --management-group-id
                          [--handle-extended-json-format]
                          [--name]
                          [--no-prompt {false, true}]
                          [--parameters]
                          [--query-string]
                          [--template-file]
                          [--template-spec]
                          [--template-uri]

Voorbeelden

Controleer of een sjabloon geldig is in de beheergroep.

az deployment mg validate --management-group-id testmg --location WestUS --template-file {template-file}

Controleer of een sjabloon geldig is in de beheergroep. (autogenerated)

az deployment mg validate --location WestUS --management-group-id testmg --name mydeployment --parameters @myparameters.json --template-file azuredeploy.json

Vereiste parameters

--location -l

De locatie voor het opslaan van de metagegevens van de implementatie.

--management-group-id -m

De beheergroep-id voor het maken van implementatie op.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

--name -n

De implementatienaam.

--no-prompt

Eigenschap	Waarde
Default value:	False
Geaccepteerde waarden:	false, true

--parameters -p

Geef waarden voor de implementatieparameter op.

--query-string -q

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

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Naam of id van 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.

Eigenschap	Waarde
Default value:	False

az deployment mg wait

Bewerken

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

az deployment mg wait --management-group-id
                      --name
                      [--created]
                      [--custom]
                      [--deleted]
                      [--exists]
                      [--interval]
                      [--timeout]
                      [--updated]

Vereiste parameters

--management-group-id -m

De id van de beheergroep.

--name -n

De implementatienaam.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

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

Eigenschap	Waarde
Parameter group:	Wait Condition Arguments
Default value:	False

--custom

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

Eigenschap	Waarde
Parameter group:	Wait Condition Arguments

--deleted

Wacht totdat deze is verwijderd.

Eigenschap	Waarde
Parameter group:	Wait Condition Arguments
Default value:	False

--exists

Wacht tot de resource bestaat.

Eigenschap	Waarde
Parameter group:	Wait Condition Arguments
Default value:	False

--interval

Polling-interval in seconden.

Eigenschap	Waarde
Parameter group:	Wait Condition Arguments
Default value:	30

--timeout

Maximale wachttijd in seconden.

Eigenschap	Waarde
Parameter group:	Wait Condition Arguments
Default value:	3600

--updated

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

Eigenschap	Waarde
Parameter group:	Wait Condition Arguments
Default value:	False

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Naam of id van 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.

Eigenschap	Waarde
Default value:	False

az deployment mg what-if

Bewerken

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

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

az deployment mg what-if --location
                         --management-group-id
                         [--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                         [--name]
                         [--no-pretty-print]
                         [--no-prompt {false, true}]
                         [--parameters]
                         [--query-string]
                         [--result-format {FullResourcePayloads, ResourceIdOnly}]
                         [--template-file]
                         [--template-spec]
                         [--template-uri]

Voorbeelden

Voer een implementatie What-If bewerking uit in een beheergroep.

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Voer een implementatie What-If bewerking uit in een beheergroep met de ResourceIdOnly-indeling.

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Voer een implementatie What-If bewerking uit in een beheergroep zonder het resultaat mooi af te drukken.

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Vereiste parameters

--location -l

De locatie voor het opslaan van de metagegevens van de implementatie.

--management-group-id -m

De beheergroep-id voor het maken van implementatie op.

Optionele parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--exclude-change-types -x

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

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

Eigenschap	Waarde
Default value:	False
Geaccepteerde waarden:	false, true

--parameters -p

Geef waarden voor de implementatieparameter op.

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

Eigenschap	Waarde
Default value:	FullResourcePayloads
Geaccepteerde waarden:	FullResourcePayloads, ResourceIdOnly

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Naam of id van 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.

Eigenschap	Waarde
Default value:	False

Delen via

az deployment mg

Opdracht

az deployment mg cancel

Voorbeelden

Vereiste parameters

az deployment mg create

Voorbeelden

Vereiste parameters

Optionele parameters

az deployment mg delete

Voorbeelden

Vereiste parameters

Optionele parameters

az deployment mg export

Voorbeelden

Vereiste parameters

az deployment mg list

Voorbeelden

Vereiste parameters

Optionele parameters

az deployment mg show

Voorbeelden

Vereiste parameters

az deployment mg validate

Voorbeelden

Vereiste parameters

Optionele parameters

az deployment mg wait

Vereiste parameters

Optionele parameters

az deployment mg what-if

Voorbeelden

Vereiste parameters

Optionele parameters

Feedback