Dela via


az deployment tenant

Hantera distribution av Azure Resource Manager-mallar i klientomfånget.

Kommandon

Name Description Typ Status
az deployment tenant cancel

Avbryt en distribution i klientomfånget.

Kärna Allmän tillgänglighet
az deployment tenant create

Starta en distribution i klientomfånget.

Kärna Allmän tillgänglighet
az deployment tenant delete

Ta bort en distribution i klientomfånget.

Kärna Allmän tillgänglighet
az deployment tenant export

Exportera mallen som används för en distribution.

Kärna Allmän tillgänglighet
az deployment tenant list

Visa en lista över distributioner i klientomfånget.

Kärna Allmän tillgänglighet
az deployment tenant show

Visa en distribution i klientomfånget.

Kärna Allmän tillgänglighet
az deployment tenant validate

Kontrollera om en mall är giltig i klientomfånget.

Kärna Allmän tillgänglighet
az deployment tenant wait

Placera CLI i vänteläge tills ett distributionsvillkor uppfylls.

Kärna Allmän tillgänglighet
az deployment tenant what-if

Kör en distributionsåtgärd för konsekvensomfattning i klientomfånget.

Kärna Allmän tillgänglighet

az deployment tenant cancel

Avbryt en distribution i klientomfånget.

az deployment tenant cancel --name

Exempel

Avbryt en distribution i klientomfånget.

az deployment tenant cancel -n deployment01

Obligatoriska parametrar

--name -n

Distributionsnamnet.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az deployment tenant create

Starta en distribution i klientomfånget.

Ange endast en av --template-file FILE | --template-uri URI | --template-spec för att mata in ARM-mallen.

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

Exempel

Skapa en distribution i klientomfånget från en fjärrmallfil med parametrar från en lokal JSON-fil.

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

Skapa en distribution i klientomfånget från en lokal mallfil med hjälp av parametrar från en JSON-sträng.

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

Skapa en distribution i klientomfånget från en lokal mall med hjälp av en parameterfil, en fjärrparparfil och selektivt åsidosätta nyckel-/värdepar.

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

Obligatoriska parametrar

--location -l

Platsen där distributionsmetadata ska lagras.

Valfria parametrar

--confirm-with-what-if -c

Instruera kommandot att köra distributionen What-If innan du kör distributionen. Sedan uppmanas du att bekräfta resursändringar innan den fortsätter.

--handle-extended-json-format -j
Inaktuell

Alternativet "--handle-extended-json-format/-j" har blivit inaktuellt och tas bort i en framtida version.

Stöd för att hantera utökat mallinnehåll, inklusive flera ledningar och kommentarer i distributionen.

--name -n

Distributionsnamnet.

--no-prompt

Alternativet för att inaktivera frågan om saknade parametrar för ARM-mallen. När värdet är sant ignoreras uppmaningen som kräver att användarna anger en parameter som saknas. Standardvärdet är "false".

accepterade värden: false, true
standardvärde: False
--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
--parameters -p

Ange parametervärden för distribution.

Parametrar kan anges från en fil med hjälp av syntaxen @{path} , en JSON-sträng eller som <KEY=VALUE-par> . Parametrar utvärderas i ordning, så när ett värde tilldelas två gånger används det senare värdet. Vi rekommenderar att du anger parameterfilen först och sedan åsidosätter selektivt med hjälp av KEY=VALUE-syntax.

--proceed-if-no-change

Instruera kommandot att köra distributionen om konsekvensresultatet inte innehåller några resursändringar. Gäller när --confirm-with-what-if har angetts.

--query-string -q

Frågesträngen (en SAS-token) som ska användas med mall-uri när det gäller länkade mallar.

--template-file -f

Sökvägen till mallfilen eller Bicep-filen.

--template-spec -s

Resurs-ID:t för mallspecifikationen.

--template-uri -u

URI:n till mallfilen.

--what-if -w

Instruera kommandot att köra distributionen What-If.

--what-if-exclude-change-types -x

Blankstegsavgränsad lista över resursändringstyper som ska undantas från konsekvensresultat. Gäller när --confirm-with-what-if har angetts.

accepterade värden: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--what-if-result-format -r

Formatet för Konsekvensresultat. Gäller när --confirm-with-what-if har angetts.

accepterade värden: FullResourcePayloads, ResourceIdOnly
standardvärde: FullResourcePayloads
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az deployment tenant delete

Ta bort en distribution i klientomfånget.

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

Exempel

Ta bort en distribution i klientomfånget.

az deployment tenant delete -n deployment01

Obligatoriska parametrar

--name -n

Distributionsnamnet.

Valfria parametrar

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az deployment tenant export

Exportera mallen som används för en distribution.

az deployment tenant export --name

Exempel

Exportera mallen som används för en distribution i klientomfånget.

az deployment tenant export --name MyDeployment

Obligatoriska parametrar

--name -n

Distributionsnamnet.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az deployment tenant list

Visa en lista över distributioner i klientomfånget.

az deployment tenant list [--filter]

Exempel

Visa en lista över distributioner i klientomfånget.

az deployment tenant list

Valfria parametrar

--filter
Förhandsgranskning

Filtrera uttryck med OData-notation. Du kan använda --filter "provisioningState eq {state}" för att filtrera provisioningState. Mer information finns i https://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az deployment tenant show

Visa en distribution i klientomfånget.

az deployment tenant show --name

Exempel

Visa en distribution i klientomfånget.

az deployment tenant show -n deployment01

Obligatoriska parametrar

--name -n

Distributionsnamnet.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az deployment tenant validate

Kontrollera om en mall är giltig i klientomfånget.

Ange endast en av --template-file FILE | --template-uri URI | --template-spec för att mata in ARM-mallen.

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

Exempel

Kontrollera om en mall är giltig i klientomfånget.

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

Kontrollera om en mall är giltig i klientomfånget. (automatiskt genererad)

az deployment tenant validate --location WestUS --name mydeployment --parameters @myparameters.json --template-file azuredeploy.json

Obligatoriska parametrar

--location -l

Platsen där distributionsmetadata ska lagras.

Valfria parametrar

--handle-extended-json-format -j
Inaktuell

Alternativet "--handle-extended-json-format/-j" har blivit inaktuellt och tas bort i en framtida version.

Stöd för att hantera utökat mallinnehåll, inklusive flera ledningar och kommentarer i distributionen.

--name -n

Distributionsnamnet.

--no-prompt

Alternativet för att inaktivera frågan om saknade parametrar för ARM-mallen. När värdet är sant ignoreras uppmaningen som kräver att användarna anger en parameter som saknas. Standardvärdet är "false".

accepterade värden: false, true
standardvärde: False
--parameters -p

Ange parametervärden för distribution.

Parametrar kan anges från en fil med hjälp av syntaxen @{path} , en JSON-sträng eller som <KEY=VALUE-par> . Parametrar utvärderas i ordning, så när ett värde tilldelas två gånger används det senare värdet. Vi rekommenderar att du anger parameterfilen först och sedan åsidosätter selektivt med hjälp av KEY=VALUE-syntax.

--query-string -q

Frågesträngen (en SAS-token) som ska användas med mall-uri när det gäller länkade mallar.

--template-file -f

Sökvägen till mallfilen eller Bicep-filen.

--template-spec -s

Resurs-ID:t för mallspecifikationen.

--template-uri -u

URI:n till mallfilen.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az deployment tenant wait

Placera CLI i vänteläge tills ett distributionsvillkor uppfylls.

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

Exempel

Placera CLI i vänteläge tills ett distributionsvillkor uppfylls. (automatiskt genererad)

az deployment tenant wait --deleted --name MyDeployment

Obligatoriska parametrar

--name -n

Distributionsnamnet.

Valfria parametrar

--created

Vänta tills du har skapat med "provisioningState" på "Lyckades".

standardvärde: False
--custom

Vänta tills villkoret uppfyller en anpassad JMESPath-fråga. T.ex. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Vänta tills den har tagits bort.

standardvärde: False
--exists

Vänta tills resursen finns.

standardvärde: False
--interval

Avsökningsintervall i sekunder.

standardvärde: 30
--timeout

Maximal väntetid i sekunder.

standardvärde: 3600
--updated

Vänta tills det har uppdaterats med provisioningState på Lyckades.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az deployment tenant what-if

Kör en distributionsåtgärd för konsekvensomfattning i klientomfånget.

Ange endast en av --template-file FILE | --template-uri URI | --template-spec för att mata in ARM-mallen.

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]

Exempel

Kör en distributionsåtgärd för konsekvensomfattning i klientomfånget.

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

Kör en distributions what-if-åtgärd i klientomfånget med ResourceIdOnly-format.

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

Kör en distributionsåtgärd för Konsekvens i klientomfånget utan att skriva ut resultatet på ett snyggt sätt.

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

Obligatoriska parametrar

--location -l

Platsen där distributionens metadata för konsekvensåtgärder ska lagras.

Valfria parametrar

--exclude-change-types -x

Blankstegsavgränsad lista över resursändringstyper som ska undantas från konsekvensresultat.

accepterade värden: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--name -n

Distributionsnamnet.

--no-pretty-print

Inaktivera ganska skrivskyddade resultat för konsekvensanalys. När den anges används formattypen för utdata.

--no-prompt

Alternativet för att inaktivera frågan om saknade parametrar för ARM-mallen. När värdet är sant ignoreras uppmaningen som kräver att användarna anger en parameter som saknas. Standardvärdet är "false".

accepterade värden: false, true
standardvärde: False
--parameters -p

Ange parametervärden för distribution.

Parametrar kan anges från en fil med hjälp av syntaxen @{path} , en JSON-sträng eller som <KEY=VALUE-par> . Parametrar utvärderas i ordning, så när ett värde tilldelas två gånger används det senare värdet. Vi rekommenderar att du anger parameterfilen först och sedan åsidosätter selektivt med hjälp av KEY=VALUE-syntax.

--query-string -q

Frågesträngen (en SAS-token) som ska användas med mall-uri när det gäller länkade mallar.

--result-format -r

Formatet för Konsekvensresultat.

accepterade värden: FullResourcePayloads, ResourceIdOnly
standardvärde: FullResourcePayloads
--template-file -f

Sökvägen till mallfilen eller Bicep-filen.

--template-spec -s

Resurs-ID:t för mallspecifikationen.

--template-uri -u

URI:n till mallfilen.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.