Delen via

az deployment sub

  • Referentie

Azure Resource Manager-sjabloonimplementatie beheren binnen het abonnementsbereik.

Opdracht

Name Description Type Status
az deployment sub cancel

Annuleer een implementatie binnen het abonnementsbereik.

 Basis GA
az deployment sub create

Start een implementatie binnen het abonnementsbereik.

 Basis GA
az deployment sub delete

Verwijder een implementatie binnen het abonnementsbereik.

 Basis GA
az deployment sub export

Exporteer de sjabloon die wordt gebruikt voor een implementatie.

 Basis GA
az deployment sub list

Implementaties op abonnementsbereik weergeven.

 Basis GA
az deployment sub show

Een implementatie weergeven op abonnementsbereik.

 Basis GA
az deployment sub validate

Controleer of een sjabloon geldig is binnen het abonnementsbereik.

 Basis GA
az deployment sub wait

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

 Basis GA
az deployment sub what-if

Voer een what-if-implementatiebewerking uit op het abonnementsbereik.

 Basis GA

az deployment sub cancel

Bewerken

Annuleer een implementatie binnen het abonnementsbereik.

az deployment sub cancel --name

Voorbeelden

Annuleer een implementatie binnen het abonnementsbereik.

az deployment sub cancel -n deployment01

Vereiste parameters

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

Bewerken

Start een implementatie binnen het abonnementsbereik.

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

az deployment sub create --location
                         [--confirm-with-what-if]
                         [--handle-extended-json-format]
                         [--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 binnen het abonnementsbereik vanuit een extern sjabloonbestand met behulp van parameters uit een lokaal JSON-bestand.

az deployment sub create --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

az deployment sub create --location WestUS --template-file azuredeploy.json  \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

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

az deployment sub create --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.

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.

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

Bewerken

Verwijder een implementatie binnen het abonnementsbereik.

az deployment sub delete --name
                         [--no-wait]

Voorbeelden

Verwijder een implementatie binnen het abonnementsbereik.

az deployment sub delete -n deployment01

Vereiste parameters

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

Bewerken

Exporteer de sjabloon die wordt gebruikt voor een implementatie.

az deployment sub export --name

Voorbeelden

Exporteer de sjabloon die wordt gebruikt voor een implementatie binnen het abonnementsbereik.

az deployment sub export --name MyDeployment

Vereiste parameters

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

Bewerken

Implementaties op abonnementsbereik weergeven.

az deployment sub list [--filter]

Voorbeelden

Implementaties op abonnementsbereik weergeven.

az deployment sub list

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

Bewerken

Een implementatie weergeven op abonnementsbereik.

az deployment sub show --name

Voorbeelden

Een implementatie weergeven op abonnementsbereik.

az deployment sub show -n deployment01

Vereiste parameters

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

Bewerken

Controleer of een sjabloon geldig is binnen het abonnementsbereik.

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

az deployment sub validate --location
                           [--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 binnen het abonnementsbereik.

az deployment sub validate --location westus2 --template-file {template-file}

Controleer of een sjabloon geldig is binnen het abonnementsbereik. (automatisch gegenereerd)

az deployment sub validate --location westus2 --parameters MyValue=This MyArray=@array.json --template-file azuredeploy.json

Vereiste parameters

--location -l

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

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

Bewerken

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

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

Voorbeelden

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

az deployment sub wait --created --name MyDeployment

Vereiste parameters

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

Bewerken

Voer een what-if-implementatiebewerking uit op het abonnementsbereik.

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

az deployment sub what-if --location
                          [--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 voor een abonnement.

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Voer een what-if-implementatiebewerking uit in een abonnement met de ResourceIdOnly-indeling.

az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Voer een what-if-implementatiebewerking uit in een abonnement zonder het resultaat mooi af te drukken.

az deployment sub what-if --location WestUS --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 wat-als-bewerking van de implementatie.

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.