az deployment sub

  • Başvuru

Abonelik kapsamında Azure Resource Manager şablon dağıtımlarını yönetin.

Komutlar

Name Description Tür Durum
az deployment sub cancel

Abonelik kapsamında bir dağıtımı iptal etme.

 Temel GA
az deployment sub create

Abonelik kapsamında bir dağıtım başlatın.

 Temel GA
az deployment sub delete

Abonelik kapsamındaki bir dağıtımı silin.

 Temel GA
az deployment sub export

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

 Temel GA
az deployment sub list

Dağıtımları abonelik kapsamında listeleyin.

 Temel GA
az deployment sub show

Bir dağıtımı abonelik kapsamında gösterin.

 Temel GA
az deployment sub validate

Bir şablonun abonelik kapsamında geçerli olup olmadığını doğrulayın.

 Temel GA
az deployment sub wait

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

 Temel GA
az deployment sub what-if

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

 Temel GA

az deployment sub cancel

Düzenle

Abonelik kapsamında bir dağıtımı iptal etme.

az deployment sub cancel --name

Örnekler

Abonelik kapsamında bir dağıtımı iptal etme.

az deployment sub cancel -n deployment01

Gerekli Parametreler

--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
varsayılan değer: 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 sub create

Düzenle

Abonelik kapsamında 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 sub 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}]

Örnekler

Yerel bir JSON dosyasındaki parametreleri kullanarak uzak şablon dosyasından abonelik kapsamında bir dağıtım oluşturun.

az deployment sub create --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Bir JSON dizesinden parametreleri kullanarak yerel şablon dosyasından abonelik kapsamında bir dağıtım oluşturun.

az deployment sub create --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 şablondan abonelik kapsamında bir dağıtım oluşturun.

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

İ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.

--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
varsayılan değer: False
--no-wait

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

varsayılan değer: 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
varsayılan değer: 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
varsayılan değer: 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 sub delete

Düzenle

Abonelik kapsamındaki bir dağıtımı silin.

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

Örnekler

Abonelik kapsamındaki bir dağıtımı silin.

az deployment sub delete -n deployment01

Gerekli Parametreler

--name -n

Dağıtım adı.

İsteğe Bağlı Parametreler

--no-wait

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

varsayılan değer: 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
varsayılan değer: 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 sub export

Düzenle

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

az deployment sub export --name

Örnekler

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

az deployment sub export --name MyDeployment

Gerekli Parametreler

--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
varsayılan değer: 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 sub list

Düzenle

Dağıtımları abonelik kapsamında listeleyin.

az deployment sub list [--filter]

Örnekler

Dağıtımları abonelik kapsamında listeleyin.

az deployment sub list

İ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
varsayılan değer: 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 sub show

Düzenle

Bir dağıtımı abonelik kapsamında gösterin.

az deployment sub show --name

Örnekler

Bir dağıtımı abonelik kapsamında gösterin.

az deployment sub show -n deployment01

Gerekli Parametreler

--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
varsayılan değer: 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 sub validate

Düzenle

Bir şablonun abonelik kapsamında 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 sub validate --location
                           [--handle-extended-json-format]
                           [--name]
                           [--no-prompt {false, true}]
                           [--parameters]
                           [--query-string]
                           [--template-file]
                           [--template-spec]
                           [--template-uri]

Örnekler

Bir şablonun abonelik kapsamında geçerli olup olmadığını doğrulayın.

az deployment sub validate --location westus2 --template-file {template-file}

Bir şablonun abonelik kapsamında geçerli olup olmadığını doğrulayın. (otomatik olarak oluşturulmuş)

az deployment sub validate --location westus2 --parameters MyValue=This MyArray=@array.json --template-file azuredeploy.json

Gerekli Parametreler

--location -l

Dağıtım meta verilerini depolama konumu.

İ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
varsayılan değer: 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
varsayılan değer: 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 sub wait

Düzenle

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

az deployment sub wait --name
                       [--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şturulmuş)

az deployment sub wait --created --name MyDeployment

Gerekli Parametreler

--name -n

Dağıtım adı.

İsteğe Bağlı Parametreler

--created

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

varsayılan değer: 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.

varsayılan değer: False
--exists

Kaynak var olana kadar bekleyin.

varsayılan değer: False
--interval

Saniye cinsinden yoklama aralığı.

varsayılan değer: 30
--timeout

Saniye cinsinden en fazla bekleme.

varsayılan değer: 3600
--updated

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

varsayılan değer: 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
varsayılan değer: 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 sub what-if

Düzenle

Abonelik 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 sub 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]

Örnekler

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

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

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

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

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

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

Gerekli Parametreler

--location -l

Dağıtım What-If işlemi meta verilerini depolama konumu.

İ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
varsayılan değer: 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
varsayılan değer: 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
varsayılan değer: 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.