Delen via


az deployment tenant

Azure Resource Manager-sjabloonimplementatie beheren op tenantbereik.

Opdracht

Name Description Type Status
az deployment tenant cancel

Een implementatie op tenantbereik annuleren.

Basis GA
az deployment tenant create

Start een implementatie op tenantbereik.

Basis GA
az deployment tenant delete

Een implementatie op tenantbereik verwijderen.

Basis GA
az deployment tenant export

Exporteer de sjabloon die wordt gebruikt voor een implementatie.

Basis GA
az deployment tenant list

Implementaties weergeven op tenantbereik.

Basis GA
az deployment tenant show

Een implementatie weergeven op tenantbereik.

Basis GA
az deployment tenant validate

Controleer of een sjabloon geldig is op tenantbereik.

Basis GA
az deployment tenant wait

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

Basis GA
az deployment tenant what-if

Voer een what-if-implementatiebewerking uit op tenantbereik.

Basis GA

az deployment tenant cancel

Een implementatie op tenantbereik annuleren.

az deployment tenant cancel --name

Voorbeelden

Een implementatie op tenantbereik annuleren.

az deployment tenant 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 tenant create

Start een implementatie op tenantbereik.

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

az deployment tenant 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 op tenantbereik vanuit een extern sjabloonbestand met behulp van parameters uit een lokaal JSON-bestand.

az deployment tenant create --name rollout01 --location WestUS \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

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

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

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

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

Een implementatie op tenantbereik verwijderen.

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

Voorbeelden

Een implementatie op tenantbereik verwijderen.

az deployment tenant 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 tenant export

Exporteer de sjabloon die wordt gebruikt voor een implementatie.

az deployment tenant export --name

Voorbeelden

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

az deployment tenant 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 tenant list

Implementaties weergeven op tenantbereik.

az deployment tenant list [--filter]

Voorbeelden

Implementaties weergeven op tenantbereik.

az deployment tenant 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 tenant show

Een implementatie weergeven op tenantbereik.

az deployment tenant show --name

Voorbeelden

Een implementatie weergeven op tenantbereik.

az deployment tenant 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 tenant validate

Controleer of een sjabloon geldig is op tenantbereik.

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

az deployment tenant 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 op tenantbereik.

az deployment tenant validate --location WestUS --template-file {template-file}

Controleer of een sjabloon geldig is op tenantbereik. (automatisch gegenereerd)

az deployment tenant validate --location WestUS --name mydeployment --parameters @myparameters.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 tenant wait

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

az deployment tenant 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 tenant wait --deleted --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 tenant what-if

Voer een what-if-implementatiebewerking uit op tenantbereik.

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

az deployment tenant 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 op tenantbereik.

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

Voer een what-if-implementatiebewerking uit op tenantbereik met de ResourceIdOnly-indeling.

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

Voer een what-if-implementatiebewerking uit op tenantbereik zonder het resultaat mooi af te drukken.

az deployment tenant 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.