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.

 Temel GA
az deployment mg create

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

 Temel GA
az deployment mg delete

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

 Temel GA
az deployment mg export

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

 Temel GA
az deployment mg list

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

 Temel GA
az deployment mg show

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

 Temel GA
az deployment mg validate

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

 Temel GA
az deployment mg wait

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

 Temel GA
az deployment mg what-if

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

 Temel 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. kullanarak az account set -s NAME_OR_IDvarsayı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 What-If komutunu ç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 olarak yanlış kullanılır.

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 söz dizimi, JSON dizesi veya KEY=VALUE> çiftleri kullanılarak <bir dosyadan @{path} 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 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ından dışlanacak 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. kullanarak az account set -s NAME_OR_IDvarsayı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. kullanarak az account set -s NAME_OR_IDvarsayı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. kullanarak az account set -s NAME_OR_IDvarsayı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 adresini ziyaret edin https://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

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. kullanarak az account set -s NAME_OR_IDvarsayı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. kullanarak az account set -s NAME_OR_IDvarsayı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 olarak yanlış kullanılır.

Kabul edilen değerler: false, true
Default value: False
--parameters -p

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

Parametreler söz dizimi, JSON dizesi veya KEY=VALUE> çiftleri kullanılarak <bir dosyadan @{path} 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. kullanarak az account set -s NAME_OR_IDvarsayı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. kullanarak az account set -s NAME_OR_IDvarsayı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 bir 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 oldukça yazdırmadan bir 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ından dışlanacak 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 olarak yanlış kullanılır.

Kabul edilen değerler: false, true
Default value: False
--parameters -p

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

Parametreler söz dizimi, JSON dizesi veya KEY=VALUE> çiftleri kullanılarak <bir dosyadan @{path} 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. kullanarak az account set -s NAME_OR_IDvarsayı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.