az deployment group

Mengelola penyebaran templat Azure Resource Manager di grup sumber daya.

Perintah

az deployment group cancel

Membatalkan penyebaran di grup sumber daya.

az deployment group create

Mulai penyebaran di grup sumber daya.

az deployment group delete

Menghapus penyebaran di grup sumber daya.

az deployment group export

Ekspor templat yang digunakan untuk penyebaran.

az deployment group list

Mencantumkan penyebaran di grup sumber daya.

az deployment group show

Menampilkan penyebaran di grup sumber daya.

az deployment group validate

Validasi apakah templat valid di grup sumber daya.

az deployment group wait

Tempatkan CLI dalam status menunggu hingga kondisi penyebaran terpenuhi.

az deployment group what-if

Jalankan penyebaran What-If operasi pada cakupan grup sumber daya.

az deployment group cancel

Membatalkan penyebaran di grup sumber daya.

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

Contoh

Membatalkan penyebaran di grup sumber daya.

az deployment group cancel -g testrg -n deployment01

Parameter yang Diperlukan

--name -n

Nama penyebaran.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

az deployment group create

Mulai penyebaran di grup sumber daya.

Tentukan hanya satu dari file --template-file | --template-uri URI | --template-spec untuk memasukkan templat ARM.

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

Contoh

Buat penyebaran di grup sumber daya dari file templat jarak jauh, menggunakan parameter dari file JSON lokal.

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

Buat penyebaran di grup sumber daya dari file templat lokal, menggunakan parameter dari string JSON.

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

Buat penyebaran di grup sumber daya dari file templat lokal, menggunakan parameter dari string array.

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

Buat penyebaran di grup sumber daya dari templat lokal, menggunakan file parameter, file parameter jarak jauh, dan secara selektif menimpa pasangan kunci/nilai.

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

Membuat penyebaran di cakupan grup sumber daya dari spesifikasi templat

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"

Parameter yang Diperlukan

--resource-group -g

Grup sumber daya untuk membuat penyebaran di.

Parameter Opsional

--aux-subs

Langganan tambahan yang akan digunakan selama penyebaran di seluruh penyewa.

--aux-tenants

Penyewa tambahan yang akan digunakan selama penyebaran di seluruh penyewa.

--confirm-with-what-if -c

Instruksikan perintah untuk menjalankan penyebaran What-If sebelum menjalankan penyebaran. Kemudian meminta Anda untuk mengakui perubahan sumber daya sebelum berlanjut.

--handle-extended-json-format -j

Dukungan untuk menangani konten templat yang diperluas termasuk multibaris dan komentar dalam penyebaran.

--mode

Mode penyebaran.

nilai yang diterima: Complete, Incremental
nilai default: Incremental
--name -n

Nama penyebaran.

--no-prompt

Opsi untuk menonaktifkan permintaan parameter yang hilang untuk templat ARM. Ketika nilainya benar, perintah yang mengharuskan pengguna untuk memberikan parameter yang hilang akan diabaikan. Nilai defaultnya adalah false.

nilai yang diterima: false, true
--no-wait

Jangan menunggu operasi jangka panjang selesai.

--parameters -p

Berikan nilai parameter penyebaran.

--proceed-if-no-change

Instruksikan perintah untuk menjalankan penyebaran jika hasil What-If tidak berisi perubahan sumber daya. Berlaku ketika --confirm-with-what-if diatur.

--query-string -q

String kueri (token SAS) yang akan digunakan dengan template-uri dalam kasus templat yang ditautkan.

--rollback-on-error

Nama penyebaran yang akan digulirkan kembali ke kesalahan, atau gunakan sebagai bendera untuk kembali ke penyebaran terakhir yang berhasil.

--template-file -f

Jalur ke file templat atau file Bicep.

--template-spec -s

Id sumber daya spesifikasi templat.

--template-uri -u

URI ke file templat.

--what-if -w

Instruksikan perintah untuk menjalankan penyebaran Bagaimana-Jika.

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

Daftar jenis perubahan sumber daya yang dipisahkan spasi yang akan dikecualikan dari hasil What-If. Berlaku ketika --confirm-with-what-if diatur.

nilai yang diterima: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--what-if-result-format -r

Format hasil What-If. Berlaku saat --confirm-with-what-if diatur.

nilai yang diterima: FullResourcePayloads, ResourceIdOnly
nilai default: FullResourcePayloads

az deployment group delete

Menghapus penyebaran di grup sumber daya.

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

Contoh

Menghapus penyebaran di grup sumber daya.

az deployment group delete -g testrg -n deployment01

Parameter yang Diperlukan

--name -n

Nama penyebaran.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Opsional

--no-wait

Jangan menunggu operasi jangka panjang selesai.

az deployment group export

Ekspor templat yang digunakan untuk penyebaran.

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

Contoh

Ekspor templat yang digunakan untuk penyebaran di grup sumber daya.

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

Parameter yang Diperlukan

--name -n

Nama penyebaran.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

az deployment group list

Mencantumkan penyebaran di grup sumber daya.

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

Contoh

Mencantumkan penyebaran di grup sumber daya.

az deployment group list -g testrg

Parameter yang Diperlukan

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Opsional

--filter

Filter ekspresi menggunakan notasi OData. Anda dapat menggunakan --filter "provisioningState eq '{state}'" untuk memfilter provisioningState. Untuk mendapatkan informasi lebih lanjut, silakan kunjungi https://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

az deployment group show

Menampilkan penyebaran di grup sumber daya.

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

Contoh

Menampilkan penyebaran di grup sumber daya.

az deployment group show -g testrg -n deployment01

Parameter yang Diperlukan

--name -n

Nama penyebaran.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

az deployment group validate

Validasi apakah templat valid di grup sumber daya.

Tentukan hanya satu dari file --template-file | --template-uri URI | --template-spec untuk memasukkan templat ARM.

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]

Contoh

Validasi apakah templat valid di grup sumber daya.

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

Validasi apakah templat valid di grup sumber daya. (dibuat otomatis)

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

Parameter yang Diperlukan

--resource-group -g

Grup sumber daya untuk membuat penyebaran di.

Parameter Opsional

--handle-extended-json-format -j

Dukungan untuk menangani konten templat yang diperluas termasuk multibaris dan komentar dalam penyebaran.

--mode

Mode penyebaran.

nilai yang diterima: Complete, Incremental
nilai default: Incremental
--name -n

Nama penyebaran.

--no-prompt

Opsi untuk menonaktifkan permintaan parameter yang hilang untuk templat ARM. Ketika nilainya benar, perintah yang mengharuskan pengguna untuk memberikan parameter yang hilang akan diabaikan. Nilai defaultnya adalah false.

nilai yang diterima: false, true
--parameters -p

Berikan nilai parameter penyebaran.

--query-string -q

String kueri (token SAS) yang akan digunakan dengan template-uri dalam kasus templat yang ditautkan.

--rollback-on-error

Nama penyebaran yang akan digulirkan kembali ke kesalahan, atau gunakan sebagai bendera untuk kembali ke penyebaran terakhir yang berhasil.

--template-file -f

Jalur ke file templat atau file Bicep.

--template-spec -s

Id sumber daya spesifikasi templat.

--template-uri -u

URI ke file templat.

az deployment group wait

Tempatkan CLI dalam status menunggu hingga kondisi penyebaran terpenuhi.

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

Contoh

Tempatkan CLI dalam status menunggu hingga kondisi penyebaran terpenuhi. (dibuat otomatis)

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

Parameter yang Diperlukan

--name -n

Nama penyebaran.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Opsional

--created

Tunggu hingga dibuat dengan 'provisioningState' di 'Berhasil'.

--custom

Tunggu hingga kondisi memenuhi kueri JMESPath kustom. Mis. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Tunggu hingga dihapus.

--exists

Tunggu hingga sumber daya ada.

--interval

Interval polling dalam hitungan detik.

nilai default: 30
--timeout

Waktu tunggu maksimum dalam detik.

nilai default: 3600
--updated

Tunggu hingga diperbarui dengan provisioningState di 'Berhasil'.

az deployment group what-if

Jalankan penyebaran What-If operasi pada cakupan grup sumber daya.

Tentukan hanya satu dari file --template-file | --template-uri URI | --template-spec untuk memasukkan templat ARM.

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]

Contoh

Jalankan penyebaran What-If operasi di grup sumber daya.

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

Jalankan operasi What-If penyebaran di grup sumber daya dengan format ResourceIdOnly.

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

Jalankan penyebaran What-If operasi di grup sumber daya tanpa mencetak hasilnya dengan cantik.

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

Parameter yang Diperlukan

--resource-group -g

Grup sumber daya untuk menjalankan penyebaran What-If operasi di.

Parameter Opsional

--aux-tenants

Penyewa tambahan yang akan digunakan selama penyebaran di seluruh penyewa.

--exclude-change-types -x

Daftar jenis perubahan sumber daya yang dipisahkan spasi yang akan dikecualikan dari hasil What-If.

nilai yang diterima: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--mode

Mode penyebaran.

nilai yang diterima: Complete, Incremental
nilai default: Incremental
--name -n

Nama penyebaran.

--no-pretty-print

Nonaktifkan pretty-print untuk hasil What-If. Ketika diatur, jenis format output akan digunakan.

--no-prompt

Opsi untuk menonaktifkan permintaan parameter yang hilang untuk templat ARM. Ketika nilainya benar, perintah yang mengharuskan pengguna untuk memberikan parameter yang hilang akan diabaikan. Nilai defaultnya adalah false.

nilai yang diterima: false, true
--parameters -p

Berikan nilai parameter penyebaran.

--query-string -q

String kueri (token SAS) yang akan digunakan dengan template-uri dalam kasus templat yang ditautkan.

--result-format -r

Format hasil What-If.

nilai yang diterima: FullResourcePayloads, ResourceIdOnly
nilai default: FullResourcePayloads
--template-file -f

Jalur ke file templat atau file Bicep.

--template-spec -s

Id sumber daya spesifikasi templat.

--template-uri -u

URI ke file templat.