az deployment group

  • Başvuru

Kaynak grubunda Azure Resource Manager şablonu dağıtımlarını yönetin.

Komutlar

az deployment group cancel

Kaynak grubundaki dağıtımı iptal etme.
az deployment group create

Kaynak grubunda bir dağıtım başlatın.
az deployment group delete

Kaynak grubundaki bir dağıtımı silin.
az deployment group export

Bir dağıtım için kullanılan şablonu dışarı aktarın.
az deployment group list

Dağıtımları kaynak grubunda listeleyin.
az deployment group show

Kaynak grubunda bir dağıtım gösterin.
az deployment group validate

Bir şablonun kaynak grubunda geçerli olup olmadığını doğrulayın.
az deployment group wait

Bir dağıtım koşulu karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin.
az deployment group what-if

Kaynak grubu kapsamında bir dağıtım What-If işlemi yürütür.

az deployment group cancel

Düzenle

Kaynak grubundaki dağıtımı iptal etme.

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

Örnekler

Kaynak grubundaki dağıtımı iptal etme.

az deployment group cancel -g testrg -n deployment01

Gerekli Parametreler

--name -n

Dağıtım adı.

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

az deployment group create

Düzenle

Kaynak grubunda bir dağıtım başlatın.

Lütfen --template-file FILE | yalnızca birini belirtin --template-uri URI | --template-spec ile ARM şablonunu girdi.

az deployment group create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--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]
                           [--rollback-on-error]
                           [--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}]

Örnekler

Yerel bir JSON dosyasındaki parametreleri kullanarak uzak şablon dosyasından kaynak grubunda dağıtım oluşturun.

az deployment group create --resource-group testrg --name rollout01 \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Bir JSON dizesinden parametreleri kullanarak yerel şablon dosyasından kaynak grubunda dağıtım oluşturun.

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json  \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

Bir dizi dizesinden parametreleri kullanarak yerel şablon dosyasından kaynak grubunda bir dağıtım oluşturun.

az deployment group create --resource-group testgroup --template-file demotemplate.json --parameters exampleString='inline string' exampleArray='("value1", "value2")'

Bir parametre dosyası, uzak parametre dosyası kullanarak ve anahtar/değer çiftlerini seçmeli olarak geçersiz kılarak yerel bir şablondan kaynak grubunda dağıtım oluşturun.

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json  --parameters @params.json \
    --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Şablon belirtiminden kaynak grubu kapsamında dağıtım oluşturma

az deployment group create --resource-group testrg --template-spec "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Resources/templateSpecs/myTemplateSpec/versions/1.0"

Gerekli Parametreler

--resource-group -g

Dağıtımın oluşturulacağı kaynak grubu.

İsteğe Bağlı Parametreler

--aux-subs

Kiracılar arasında dağıtım sırasında kullanılacak yardımcı abonelikler.

--aux-tenants

Kiracılar arasında dağıtım sırasında kullanılacak yardımcı kiracılar.

--confirm-with-what-if -c

Komutunun dağıtımı yürütmeden önce dağıtım What-If çalıştırmasını sağlayın. Ardından devam etmeden önce kaynak değişikliklerini onaylamanızı ister.

--handle-extended-json-format -j

Dağıtımda çok satırlı ve açıklamalar da dahil olmak üzere genişletilmiş şablon içeriğini işleme desteği.

--mode

Dağıtım modu.

kabul edilen değerler: Complete, Incremental
varsayılan değer: Incremental
--name -n

Dağıtım adı.

--no-prompt

ARM şablonu için eksik parametreler istemini devre dışı bırakma seçeneği. Değer true olduğunda, kullanıcıların eksik parametre sağlamasını gerektiren istem yoksayılır. Varsayılan değer false'tur.

kabul edilen değerler: false, true
--no-wait

Uzun süre çalışan işlemin bitmesini beklemeyin.

--parameters -p

Dağıtım parametresi değerlerini sağlayın.

--proceed-if-no-change

What-If sonucu kaynak değişikliği içermiyorsa komutunun dağıtımı yürütmesini sağlayın. --confirm-with-what-if ayarlandığında geçerlidir.

--query-string -q

Bağlantılı şablonlar söz konusu olduğunda template-uri ile kullanılacak sorgu dizesi (SAS belirteci).

--rollback-on-error

Hatada geri döndürülecek dağıtımın adı veya son başarılı dağıtıma geri dönmek için bayrak olarak kullanın.

--template-file -f

Şablon dosyasının veya Bicep dosyasının yolu.

--template-spec -s

Şablon belirtimi kaynak kimliği.

--template-uri -u

Şablon dosyasının URI'sini seçin.

--what-if -w

Komutunun What-If dağıtımını çalıştırmasını sağlayın.

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

What-If sonuçların dışında tutulacak kaynak değişikliği türlerinin boşlukla ayrılmış listesi. --confirm-with-what-if ayarlandığında geçerlidir.

kabul edilen değerler: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--what-if-result-format -r

What-If sonuçlarının biçimi. --confirm-with-what-if Ayarlandığında geçerlidir.

kabul edilen değerler: FullResourcePayloads, ResourceIdOnly
varsayılan değer: FullResourcePayloads

az deployment group delete

Düzenle

Kaynak grubundaki bir dağıtımı silin.

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

Örnekler

Kaynak grubundaki bir dağıtımı silin.

az deployment group delete -g testrg -n deployment01

Gerekli Parametreler

--name -n

Dağıtım adı.

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

--no-wait

Uzun süre çalışan işlemin bitmesini beklemeyin.

az deployment group export

Düzenle

Bir dağıtım için kullanılan şablonu dışarı aktarın.

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

Örnekler

Kaynak grubundaki bir dağıtım için kullanılan şablonu dışarı aktarın.

az deployment group export --resource-group testrg --name MyDeployment

Gerekli Parametreler

--name -n

Dağıtım adı.

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

az deployment group list

Düzenle

Dağıtımları kaynak grubunda listeleyin.

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

Örnekler

Dağıtımları kaynak grubunda listeleyin.

az deployment group list -g testrg

Gerekli Parametreler

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

--filter

OData gösterimini kullanarak ifadeyi filtreleyin. provisioningState'i filtrelemek için --filter "provisioningState eq '{state}'" kullanabilirsiniz. Daha fazla bilgi edinmek için adresini ziyaret edin https://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

az deployment group show

Düzenle

Kaynak grubunda bir dağıtım gösterin.

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

Örnekler

Kaynak grubunda bir dağıtım gösterin.

az deployment group show -g testrg -n deployment01

Gerekli Parametreler

--name -n

Dağıtım adı.

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

az deployment group validate

Düzenle

Bir şablonun kaynak grubunda geçerli olup olmadığını doğrulayın.

Lütfen --template-file FILE | yalnızca birini belirtin --template-uri URI | --template-spec ile ARM şablonunu girdi.

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

Örnekler

Bir şablonun kaynak grubunda geçerli olup olmadığını doğrulayın.

az deployment group validate --resource-group testrg --template-file {template-file}

Bir şablonun kaynak grubunda geçerli olup olmadığını doğrulayın. (otomatik olarak oluşturulur)

az deployment group validate --parameters MyValue=This MyArray=@array.json --resource-group testrg --template-file azuredeploy.json

Gerekli Parametreler

--resource-group -g

Dağıtımın oluşturulacağı kaynak grubu.

İsteğe Bağlı Parametreler

--handle-extended-json-format -j

Dağıtımda çok satırlı ve açıklamalar da dahil olmak üzere genişletilmiş şablon içeriğini işleme desteği.

--mode

Dağıtım modu.

kabul edilen değerler: Complete, Incremental
varsayılan değer: Incremental
--name -n

Dağıtım adı.

--no-prompt

ARM şablonu için eksik parametreler istemini devre dışı bırakma seçeneği. Değer true olduğunda, kullanıcıların eksik parametre sağlamasını gerektiren istem yoksayılır. Varsayılan değer false'tur.

kabul edilen değerler: false, true
--parameters -p

Dağıtım parametresi değerlerini sağlayın.

--query-string -q

Bağlantılı şablonlar söz konusu olduğunda template-uri ile kullanılacak sorgu dizesi (SAS belirteci).

--rollback-on-error

Hatada geri döndürülecek dağıtımın adı veya son başarılı dağıtıma geri dönmek için bayrak olarak kullanın.

--template-file -f

Şablon dosyasının veya Bicep dosyasının yolu.

--template-spec -s

Şablon belirtimi kaynak kimliği.

--template-uri -u

Şablon dosyasının URI'sini seçin.

az deployment group wait

Düzenle

Bir dağıtım koşulu karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin.

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

Örnekler

Bir dağıtım koşulu karşılanıncaya kadar CLI'yi bekleme durumuna yerleştirin. (otomatik olarak oluşturulur)

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

Gerekli Parametreler

--name -n

Dağıtım adı.

--resource-group -g

Kaynak grubunun adı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

--created

'provisioningState' ile 'Succeeded' konumunda oluşturulana kadar bekleyin.

--custom

Koşul özel bir JMESPath sorgusunu karşılayana kadar bekleyin. Örneğin provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Silinene kadar bekleyin.

--exists

Kaynak var olana kadar bekleyin.

--interval

Saniye cinsinden yoklama aralığı.

varsayılan değer: 30
--timeout

Saniye cinsinden en fazla bekleme.

varsayılan değer: 3600
--updated

ProvisioningState değeri 'Başarılı' olarak güncelleştirilene kadar bekleyin.

az deployment group what-if

Düzenle

Kaynak grubu kapsamında bir dağıtım What-If işlemi yürütür.

Lütfen --template-file FILE | yalnızca birini belirtin --template-uri URI | --template-spec ile ARM şablonunu girdi.

az deployment group what-if --resource-group
                            [--aux-tenants]
                            [--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                            [--mode {Complete, Incremental}]
                            [--name]
                            [--no-pretty-print]
                            [--no-prompt {false, true}]
                            [--parameters]
                            [--query-string]
                            [--result-format {FullResourcePayloads, ResourceIdOnly}]
                            [--template-file]
                            [--template-spec]
                            [--template-uri]

Örnekler

Bir kaynak grubunda dağıtım What-If işlemi yürütür.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

ResourceIdOnly biçiminde bir kaynak grubunda dağıtım What-If işlemi yürütür.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Sonucu düzgün yazdırmadan bir kaynak grubunda dağıtım What-If işlemi yürütebilirsiniz.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Gerekli Parametreler

--resource-group -g

Dağıtım What-If işleminin yürütülecek kaynak grubu.

İsteğe Bağlı Parametreler

--aux-tenants

Kiracılar arasında dağıtım sırasında kullanılacak yardımcı kiracılar.

--exclude-change-types -x

What-If sonuçların dışında tutulacak kaynak değişikliği türlerinin boşlukla ayrılmış listesi.

kabul edilen değerler: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--mode

Dağıtım modu.

kabul edilen değerler: Complete, Incremental
varsayılan değer: Incremental
--name -n

Dağıtım adı.

--no-pretty-print

What-If sonuçlar için oldukça yazdırmayı devre dışı bırakın. Ayarlandığında, çıkış biçimi türü kullanılır.

--no-prompt

ARM şablonu için eksik parametreler istemini devre dışı bırakma seçeneği. Değer true olduğunda, kullanıcıların eksik parametre sağlamasını gerektiren istem yoksayılır. Varsayılan değer false'tur.

kabul edilen değerler: false, true
--parameters -p

Dağıtım parametresi değerlerini sağlayın.

--query-string -q

Bağlantılı şablonlar söz konusu olduğunda template-uri ile kullanılacak sorgu dizesi (SAS belirteci).

--result-format -r

What-If sonuçlarının biçimi.

kabul edilen değerler: FullResourcePayloads, ResourceIdOnly
varsayılan değer: FullResourcePayloads
--template-file -f

Şablon dosyasının veya Bicep dosyasının yolu.

--template-spec -s

Şablon belirtimi kaynak kimliği.

--template-uri -u

Şablon dosyasının URI'sini.