Aracılığıyla paylaş

az deployment mg

  • Başvuru

Yönetim grubunda Azure Resource Manager şablon dağıtımlarını yönetin.

Komutlar

Name Description Tür Durum
az deployment mg cancel

Yönetim grubunda dağıtımı iptal etme.

 Göbek GA
az deployment mg create

Yönetim grubunda bir dağıtım başlatın.

 Göbek GA
az deployment mg delete

Yönetim grubundaki bir dağıtımı silin.

 Göbek GA
az deployment mg export

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

 Göbek GA
az deployment mg list

Dağıtımları yönetim grubunda listeleyin.

 Göbek GA
az deployment mg show

Yönetim grubunda bir dağıtım gösterin.

 Göbek GA
az deployment mg validate

Bir şablonun yönetim grubunda geçerli olup olmadığını doğrulayın.

 Göbek GA
az deployment mg wait

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

 Göbek GA
az deployment mg what-if

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

 Göbek GA

az deployment mg cancel

Düzenle

Yönetim grubunda dağıtımı iptal etme.

az deployment mg cancel --management-group-id
                        --name

Örnekler

Yönetim grubunda dağıtımı iptal etme.

az deployment mg cancel -m testmg -n deployment01

Gerekli Parametreler

--management-group-id -m

Yönetim grubu kimliği.

--name -n

Dağıtım adı.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az deployment mg create

Düzenle

Yönetim grubunda bir dağıtım başlatın.

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

az deployment mg create --location
                        --management-group-id
                        [--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]
                        [--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 yönetim grubunda dağıtım oluşturun.

az deployment mg create --management-group-id testrg --name rollout01 --location WestUS \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Bir JSON dizesinden parametreler kullanarak yerel şablon dosyasından yönetim grubunda bir dağıtım oluşturun.

az deployment mg create --management-group-id testmg --name rollout01 --location WestUS \
    --template-file azuredeploy.json \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

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

az deployment mg create --management-group-id testmg --name rollout01 --location WestUS \
    --template-file azuredeploy.json --parameters @params.json \
    --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Gerekli Parametreler

--location -l

Dağıtım meta verilerini depolama konumu.

--management-group-id -m

Dağıtımın oluşturulacağı yönetim grubu kimliği.

İsteğe Bağlı Parametreler

--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
Kullanım Dışı

'--handle-extended-json-format/-j' seçeneği kullanım dışı bırakıldı ve gelecekteki bir sürümde kaldırılacak.

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

--mode

Kaynakları dağıtmak için kullanılan mod. Bu değer Artımlı veya Tamamlandı olabilir. Artımlı modda, kaynaklar şablona dahil olmayan mevcut kaynaklar silinmeden dağıtılır. Tamamlandı modunda kaynaklar dağıtılır ve şablona dahil olmayan kaynak grubundaki mevcut kaynaklar silinir. İstenmeyen bir şekilde kaynakları silebileceği için Complete modunu kullanırken dikkatli olun.

Kabul edilen değerler: Complete, Incremental
Default value: 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
Default value: False
--no-wait

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

Default value: False
--parameters -p

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

Parametreler @{path} söz dizimi, JSON dizesi veya <KEY=VALUE> çiftleri kullanılarak bir dosyadan sağlanabilir. Parametreler sırayla değerlendirilir, bu nedenle bir değer iki kez atandığında ikinci değer kullanılır. Önce parametre dosyanızı sağlamanız ve ardından KEY=VALUE söz dizimini kullanarak seçmeli olarak geçersiz kılmanız önerilir.

--proceed-if-no-change

What-If sonucu hiçbir 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).

--template-file -f

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

--template-spec -s

Şablon belirtim kaynak kimliği.

--template-uri -u

Şablon dosyasının URI'sini.

--what-if -w

Komutunun dağıtım What-If komutunu ç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
Default value: FullResourcePayloads
Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az deployment mg delete

Düzenle

Yönetim grubundaki bir dağıtımı silin.

az deployment mg delete --management-group-id
                        --name
                        [--no-wait]

Örnekler

Yönetim grubundaki bir dağıtımı silin.

az deployment mg delete -m testmg -n deployment01

Gerekli Parametreler

--management-group-id -m

Yönetim grubu kimliği.

--name -n

Dağıtım adı.

İsteğe Bağlı Parametreler

--no-wait

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

Default value: False
Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az deployment mg export

Düzenle

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

az deployment mg export --management-group-id
                        --name

Örnekler

Yönetim grubunda dağıtım için kullanılan şablonu dışarı aktarın.

az deployment mg export --management-group-id testmg --name MyDeployment

Gerekli Parametreler

--management-group-id -m

Yönetim grubu kimliği.

--name -n

Dağıtım adı.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az deployment mg list

Düzenle

Dağıtımları yönetim grubunda listeleyin.

az deployment mg list --management-group-id
                      [--filter]

Örnekler

Dağıtımları yönetim grubunda listeleyin.

az deployment mg list -m testmg

Gerekli Parametreler

--management-group-id -m

Yönetim grubu kimliği.

İsteğe Bağlı Parametreler

--filter
Önizleme

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

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az deployment mg show

Düzenle

Yönetim grubunda bir dağıtım gösterin.

az deployment mg show --management-group-id
                      --name

Örnekler

Yönetim grubunda bir dağıtım gösterin.

az deployment mg show -m testmg -n deployment01

Gerekli Parametreler

--management-group-id -m

Yönetim grubu kimliği.

--name -n

Dağıtım adı.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az deployment mg validate

Düzenle

Bir şablonun yönetim grubunda geçerli olup olmadığını doğrulayın.

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

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

Örnekler

Bir şablonun yönetim grubunda geçerli olup olmadığını doğrulayın.

az deployment mg validate --management-group-id testmg --location WestUS --template-file {template-file}

Bir şablonun yönetim grubunda geçerli olup olmadığını doğrulayın. (otomatik olarak oluşturulmuş)

az deployment mg validate --location WestUS --management-group-id testmg --name mydeployment --parameters @myparameters.json --template-file azuredeploy.json

Gerekli Parametreler

--location -l

Dağıtım meta verilerini depolama konumu.

--management-group-id -m

Dağıtımın oluşturulacağı yönetim grubu kimliği.

İsteğe Bağlı Parametreler

--handle-extended-json-format -j
Kullanım Dışı

'--handle-extended-json-format/-j' seçeneği kullanım dışı bırakıldı ve gelecekteki bir sürümde kaldırılacak.

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

--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
Default value: False
--parameters -p

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

Parametreler @{path} söz dizimi, JSON dizesi veya <KEY=VALUE> çiftleri kullanılarak bir dosyadan sağlanabilir. Parametreler sırayla değerlendirilir, bu nedenle bir değer iki kez atandığında ikinci değer kullanılır. Önce parametre dosyanızı sağlamanız ve ardından KEY=VALUE söz dizimini kullanarak seçmeli olarak geçersiz kılmanız önerilir.

--query-string -q

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

--template-file -f

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

--template-spec -s

Şablon belirtim kaynak kimliği.

--template-uri -u

Şablon dosyasının URI'sini.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az deployment mg wait

Düzenle

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

az deployment mg wait --management-group-id
                      --name
                      [--created]
                      [--custom]
                      [--deleted]
                      [--exists]
                      [--interval]
                      [--timeout]
                      [--updated]

Gerekli Parametreler

--management-group-id -m

Yönetim grubu kimliği.

--name -n

Dağıtım adı.

İsteğe Bağlı Parametreler

--created

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

Default value: False
--custom

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

--deleted

Silinene kadar bekleyin.

Default value: False
--exists

Kaynak var olana kadar bekleyin.

Default value: False
--interval

Saniye cinsinden yoklama aralığı.

Default value: 30
--timeout

Saniye cinsinden en fazla bekleme.

Default value: 3600
--updated

'Başarılı' konumunda provisioningState ile güncelleştirilene kadar bekleyin.

Default value: False
Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az deployment mg what-if

Düzenle

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

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

az deployment mg what-if --location
                         --management-group-id
                         [--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]

Örnekler

Yönetim grubunda dağıtım What-If işlemi yürütür.

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Bir yönetim grubunda, sonucu düzgün yazdırmadan dağıtım What-If işlemi yürütür.

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Gerekli Parametreler

--location -l

Dağıtım meta verilerini depolama konumu.

--management-group-id -m

Dağıtımın oluşturulacağı yönetim grubu kimliği.

İsteğe Bağlı Parametreler

--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
--name -n

Dağıtım adı.

--no-pretty-print

What-If sonuçlar için pretty-print özelliğini 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
Default value: False
--parameters -p

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

Parametreler @{path} söz dizimi, JSON dizesi veya <KEY=VALUE> çiftleri kullanılarak bir dosyadan sağlanabilir. Parametreler sırayla değerlendirilir, bu nedenle bir değer iki kez atandığında ikinci değer kullanılır. Önce parametre dosyanızı sağlamanız ve ardından KEY=VALUE söz dizimini kullanarak seçmeli olarak geçersiz kılmanız önerilir.

--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
Default value: FullResourcePayloads
--template-file -f

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

--template-spec -s

Şablon belirtim kaynak kimliği.

--template-uri -u

Şablon dosyasının URI'sini.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.