Delen via

az deployment mg

  • Referentie

Azure Resource Manager-sjabloonimplementatie beheren bij beheergroep.

Opdracht

Name Description Type Status
az deployment mg cancel

Annuleer een implementatie bij de beheergroep.

 Basis GA
az deployment mg create

Start een implementatie bij de beheergroep.

 Basis GA
az deployment mg delete

Een implementatie bij de beheergroep verwijderen.

 Basis GA
az deployment mg export

Exporteer de sjabloon die wordt gebruikt voor een implementatie.

 Basis GA
az deployment mg list

Implementaties weergeven bij beheergroep.

 Basis GA
az deployment mg show

Een implementatie weergeven in de beheergroep.

 Basis GA
az deployment mg validate

Controleer of een sjabloon geldig is in de beheergroep.

 Basis GA
az deployment mg wait

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

 Basis GA
az deployment mg what-if

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

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

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

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

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.

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

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

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

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

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

--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 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. (automatisch gegenereerd)

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

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

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.

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

--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 mg what-if

Bewerken

Voer een what-if-implementatiebewerking 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 what-if-implementatiebewerking 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 what-if-implementatiebewerking 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 what-if-implementatiebewerking 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

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