az deployment group

  • Referensi

Mengelola penyebaran templat Azure Resource Manager di grup sumber daya.

Perintah

Nama Deskripsi Jenis Status
az deployment group cancel

Batalkan penyebaran di grup sumber daya.

 Inti GA
az deployment group create

Mulai penyebaran di grup sumber daya.

 Inti GA
az deployment group delete

Menghapus penyebaran di grup sumber daya.

 Inti GA
az deployment group export

Ekspor templat yang digunakan untuk penyebaran.

 Inti GA
az deployment group list

Mencantumkan penyebaran di grup sumber daya.

 Inti GA
az deployment group show

Tampilkan penyebaran di grup sumber daya.

 Inti GA
az deployment group validate

Validasi apakah templat valid di grup sumber daya.

 Inti GA
az deployment group wait

Tempatkan CLI dalam status tunggu hingga kondisi penyebaran terpenuhi.

 Inti GA
az deployment group what-if

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

 Inti GA

az deployment group cancel

Edit

Batalkan penyebaran di grup sumber daya.

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

Contoh

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

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az deployment group create

Edit

Mulai penyebaran di grup sumber daya.

Tentukan hanya salah satu 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"

Membuat penyebaran di cakupan grup sumber daya dari file parameter bicepparam

az deployment group create --resource-group testrg --parameters parameters.bicepparam

Membuat penyebaran di grup sumber daya di seluruh penyewa

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json --parameters @myparameters.json --aux-tenants auxiliary_tenant01 auxiliary_tenant02

Parameter yang Diperlukan

--resource-group -g

Grup sumber daya untuk membuat penyebaran di.

Parameter Opsional

--aux-subs
Tidak digunakan lagi

Opsi '--aux-subs' tidak digunakan lagi dan akan dihapus dalam rilis mendatang. Gunakan '--aux-tenants' sebagai gantinya.

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
Tidak digunakan lagi

Opsi '--handle-extended-json-format/-j' telah ditolak dan akan dihapus dalam rilis mendatang.

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, permintaan yang mengharuskan pengguna untuk memberikan parameter yang hilang akan diabaikan. Nilai defaultnya adalah false.

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

Jangan menunggu operasi jangka panjang selesai.

nilai default: False
--parameters -p

Berikan nilai parameter penyebaran.

Parameter dapat disediakan dari file menggunakan @{path} sintaks, string JSON, atau sebagai <pasangan KEY=VALUE> . Parameter dievaluasi secara berurutan, jadi ketika nilai ditetapkan dua kali, nilai terakhir akan digunakan. Disarankan agar Anda menyediakan file parameter terlebih dahulu, lalu mengambil alih secara selektif menggunakan sintaks KEY=VALUE. Perhatikan juga jika Anda menyediakan file bicepparam maka Anda hanya dapat menggunakan argumen ini sekali.

--proceed-if-no-change

Instruksikan perintah untuk menjalankan penyebaran jika hasil Bagaimana-Jika 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 untuk digulung balik menjadi kesalahan, atau gunakan sebagai bendera untuk mengembalikan 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 What-If.

--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
Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az deployment group delete

Edit

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.

nilai default: False
Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az deployment group export

Edit

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

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az deployment group list

Edit

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
Pratinjau

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.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az deployment group show

Edit

Tampilkan penyebaran di grup sumber daya.

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

Contoh

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

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az deployment group validate

Edit

Validasi apakah templat valid di grup sumber daya.

Tentukan hanya salah satu 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
Tidak digunakan lagi

Opsi '--handle-extended-json-format/-j' telah ditolak dan akan dihapus dalam rilis mendatang.

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, permintaan yang mengharuskan pengguna untuk memberikan parameter yang hilang akan diabaikan. Nilai defaultnya adalah false.

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

Berikan nilai parameter penyebaran.

Parameter dapat disediakan dari file menggunakan @{path} sintaks, string JSON, atau sebagai <pasangan KEY=VALUE> . Parameter dievaluasi secara berurutan, jadi ketika nilai ditetapkan dua kali, nilai terakhir akan digunakan. Disarankan agar Anda menyediakan file parameter terlebih dahulu, lalu mengambil alih secara selektif menggunakan sintaks KEY=VALUE.

--query-string -q

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

--rollback-on-error

Nama penyebaran untuk digulung balik menjadi kesalahan, atau gunakan sebagai bendera untuk mengembalikan 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.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az deployment group wait

Edit

Tempatkan CLI dalam status tunggu hingga kondisi penyebaran terpenuhi.

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

Contoh

Tempatkan CLI dalam status tunggu 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'.

nilai default: False
--custom

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

--deleted

Tunggu hingga dihapus.

nilai default: False
--exists

Tunggu hingga sumber daya ada.

nilai default: False
--interval

Interval polling dalam hitungan detik.

nilai default: 30
--timeout

Tunggu maksimum dalam detik.

nilai default: 3600
--updated

Tunggu hingga diperbarui dengan provisioningState di 'Berhasil'.

nilai default: False
Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az deployment group what-if

Edit

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

Tentukan hanya salah satu 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 operasi What-If penyebaran 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 operasi What-If penyebaran 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 operasi What-If penyebaran 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, permintaan yang mengharuskan pengguna untuk memberikan parameter yang hilang akan diabaikan. Nilai defaultnya adalah false.

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

Berikan nilai parameter penyebaran.

Parameter dapat disediakan dari file menggunakan @{path} sintaks, string JSON, atau sebagai <pasangan KEY=VALUE> . Parameter dievaluasi secara berurutan, jadi ketika nilai ditetapkan dua kali, nilai terakhir akan digunakan. Disarankan agar Anda menyediakan file parameter terlebih dahulu, lalu mengambil alih secara selektif menggunakan sintaks KEY=VALUE.

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

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.