az group deployment

Azure Resource Manager-implementaties beheren.

Opdracht

az group deployment cancel

Hiermee annuleert u een sjabloonimplementatie die momenteel wordt uitgevoerd.

az group deployment create

Een implementatie starten.

az group deployment delete

Hiermee verwijdert u een implementatie uit de implementatiegeschiedenis.

az group deployment export

De sjabloon exporteren die is gebruikt voor een implementatie.

az group deployment list

Alle implementaties voor een resourcegroep ophalen.

az group deployment operation

Implementatiebewerkingen beheren.

az group deployment operation list

Hiermee haalt u alle implementatiebewerkingen voor een implementatie op.

az group deployment operation show

De bewerking van een implementatie ophalen.

az group deployment show

Hiermee haalt u een implementatie op.

az group deployment validate

Controleer of een sjabloon syntactisch juist is.

az group deployment wait

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

az group deployment cancel

Hiermee annuleert u een sjabloonimplementatie die momenteel wordt uitgevoerd.

U kunt een implementatie alleen annuleren als de provisioningState wordt geaccepteerd of wordt uitgevoerd. Nadat de implementatie is geannuleerd, is de provisioningState ingesteld op Geannuleerd. Als u een sjabloonimplementatie annuleert, wordt de momenteel uitgevoerde sjabloonimplementatie gestopt en blijft de resourcegroep gedeeltelijk geïmplementeerd.

az group deployment cancel --name
                           --resource-group

Vereiste parameters

--name -n

De naam van de implementatie.

--resource-group -g

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

az group deployment create

Een implementatie starten.

az group deployment create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--rollback-on-error]
                           [--template-file]
                           [--template-uri]

Voorbeelden

Maak een implementatie op basis van een extern sjabloonbestand met behulp van parameters uit een lokaal JSON-bestand.

az group deployment create -g MyResourceGroup --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters "{ \"location\": { \"value\": \"westus\" } }"

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

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Vereiste parameters

--resource-group -g

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

Optionele parameters

--aux-subs

Hulpabonnementen die worden gebruikt tijdens de implementatie in tenants.

--aux-tenants

Hulptenants die worden gebruikt tijdens de implementatie tussen tenants.

--handle-extended-json-format -j

Ondersteuning voor het afhandelen van uitgebreide sjablooninhoud, inclusief meerdere regels en opmerkingen in de implementatie.

--mode

Incrementeel (alleen resources toevoegen aan resourcegroep) of Voltooien (extra resources uit de resourcegroep verwijderen).

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

De naam van de implementatie. Standaardnaam van sjabloonbestandsbestand.

--no-prompt

De optie om de prompt met ontbrekende parameters voor een ARM-sjabloon uit te schakelen. Wanneer de waarde waar is, wordt de prompt die gebruikers nodig hebben om ontbrekende parameter op te geven genegeerd. De standaardwaarde is false.

geaccepteerde waarden: false, true
--no-wait

Wacht niet tot de langdurige bewerking is voltooid.

--parameters -p

Geef parameterwaarden voor de implementatie op.

--rollback-on-error

De naam van een implementatie om terug te keren naar een fout, of als vlag gebruiken om terug te keren naar de laatste geslaagde implementatie.

--template-file -f

Een pad naar een sjabloonbestand of Bicep-bestand in het bestandssysteem.

--template-uri -u

Een URI naar een extern sjabloonbestand.

az group deployment delete

Hiermee verwijdert u een implementatie uit de implementatiegeschiedenis.

Een sjabloonimplementatie die momenteel wordt uitgevoerd, kan niet worden verwijderd. Als u een sjabloonimplementatie verwijdert, worden de bijbehorende implementatiebewerkingen verwijderd. Het verwijderen van een sjabloonimplementatie heeft geen invloed op de status van de resourcegroep. Dit is een asynchrone bewerking die de status 202 retourneert totdat de sjabloonimplementatie is verwijderd. De antwoordheader Locatie bevat de URI die wordt gebruikt om de status van het proces te verkrijgen. Terwijl het proces wordt uitgevoerd, retourneert een aanroep naar de URI in de locatieheader de status 202. Wanneer het proces is voltooid, retourneert de URI in de locatieheader een status van 204 bij succes. Als de asynchrone aanvraag is mislukt, retourneert de URI in de locatieheader een statuscode op foutniveau.

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

Vereiste parameters

--name -n

De naam van de implementatie.

--resource-group -g

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

Optionele parameters

--no-wait

Wacht niet tot de langdurige bewerking is voltooid.

az group deployment export

De sjabloon exporteren die is gebruikt voor een implementatie.

az group deployment export --name
                           --resource-group

Voorbeelden

De sjabloon exporteren die is gebruikt voor een implementatie. (automatisch gegenereerd)

az group deployment export --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 behulp van az configure --defaults group=<name>.

az group deployment list

Alle implementaties voor een resourcegroep ophalen.

az group deployment list --resource-group
                         [--filter]
                         [--top]

Vereiste parameters

--resource-group -g

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

Optionele parameters

--filter

Het filter dat moet worden toegepast op de bewerking. U kunt bijvoorbeeld $filter=provisioningState eq {state} gebruiken. De standaardwaarde is Geen.

--top

Het aantal resultaten dat moet worden opgehaald. Als null wordt doorgegeven, worden alle implementaties geretourneerd. De standaardwaarde is Geen.

az group deployment show

Hiermee haalt u een implementatie op.

az group deployment show --name
                         --resource-group

Vereiste parameters

--name -n

De naam van de implementatie.

--resource-group -g

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

az group deployment validate

Controleer of een sjabloon syntactisch juist is.

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

Voorbeelden

Controleer of een sjabloon syntactisch juist is. (automatisch gegenereerd)

az group deployment validate --parameters "{ \"location\": { \"value\": \"westus\" } }" \
    --resource-group MyResourceGroup --template-file storage.json

Vereiste parameters

--resource-group -g

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

Optionele parameters

--handle-extended-json-format -j

Ondersteuning voor het afhandelen van uitgebreide sjablooninhoud, inclusief meerdere regels en opmerkingen in de implementatie.

--mode

Incrementeel (alleen resources toevoegen aan resourcegroep) of Voltooien (extra resources uit de resourcegroep verwijderen).

geaccepteerde waarden: Complete, Incremental
standaardwaarde: Incremental
--no-prompt

De optie om de prompt met ontbrekende parameters voor een ARM-sjabloon uit te schakelen. Wanneer de waarde waar is, wordt de prompt die gebruikers nodig hebben om ontbrekende parameter op te geven genegeerd. De standaardwaarde is false.

geaccepteerde waarden: false, true
--parameters -p

Geef parameterwaarden voor de implementatie op.

--rollback-on-error

De naam van een implementatie om terug te keren naar een fout, of als vlag gebruiken om terug te keren naar de laatste geslaagde implementatie.

--template-file -f

Een pad naar een sjabloonbestand of Bicep-bestand in het bestandssysteem.

--template-uri -u

Een URI naar een extern sjabloonbestand.

az group deployment wait

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

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

Voorbeelden

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

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

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

az group deployment 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 behulp van az configure --defaults group=<name>.

Optionele parameters

--created

Wacht totdat u 'provisioningState' hebt gemaakt op Geslaagd.

--custom

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

--deleted

Wacht totdat deze is verwijderd.

--exists

Wacht tot de resource bestaat.

--interval

Polling-interval in seconden.

standaardwaarde: 30
--timeout

Maximale wachttijd in seconden.

standaardwaarde: 3600
--updated

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