Bagikan melalui

az deployment sub

  • Referensi

Mengelola penyebaran templat Azure Resource Manager di cakupan langganan.

Perintah

Nama Deskripsi Jenis Status
az deployment sub cancel

Batalkan penyebaran di cakupan langganan.

 Inti GA
az deployment sub create

Mulai penyebaran di cakupan langganan.

 Inti GA
az deployment sub delete

Menghapus penyebaran di cakupan langganan.

 Inti GA
az deployment sub export

Ekspor templat yang digunakan untuk penyebaran.

 Inti GA
az deployment sub list

Mencantumkan penyebaran di cakupan langganan.

 Inti GA
az deployment sub show

Tampilkan penyebaran di cakupan langganan.

 Inti GA
az deployment sub validate

Validasi apakah templat valid pada cakupan langganan.

 Inti GA
az deployment sub wait

Tempatkan CLI dalam status tunggu hingga kondisi penyebaran terpenuhi.

 Inti GA
az deployment sub what-if

Jalankan operasi What-If penyebaran pada cakupan langganan.

 Inti GA

az deployment sub cancel

Edit

Batalkan penyebaran di cakupan langganan.

az deployment sub cancel --name

Contoh

Batalkan penyebaran di cakupan langganan.

az deployment sub cancel -n deployment01

Parameter yang Diperlukan

--name -n

Nama penyebaran.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az deployment sub create

Edit

Mulai penyebaran di cakupan langganan.

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

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

Contoh

Buat penyebaran di cakupan langganan dari file templat jarak jauh, menggunakan parameter dari file JSON lokal.

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

Buat penyebaran di cakupan langganan dari file templat lokal, menggunakan parameter dari string JSON.

az deployment sub create --location WestUS --template-file azuredeploy.json  \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

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

az deployment sub create --location WestUS --template-file azuredeploy.json  \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Parameter yang Diperlukan

--location -l

Lokasi untuk menyimpan metadata penyebaran.

Parameter Opsional

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

--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 sintaks @{path}, 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.

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

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

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az deployment sub delete

Edit

Menghapus penyebaran di cakupan langganan.

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

Contoh

Menghapus penyebaran di cakupan langganan.

az deployment sub delete -n deployment01

Parameter yang Diperlukan

--name -n

Nama penyebaran.

Parameter Opsional

--no-wait

Jangan menunggu operasi jangka panjang selesai.

Nilai default: False
Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az deployment sub export

Edit

Ekspor templat yang digunakan untuk penyebaran.

az deployment sub export --name

Contoh

Ekspor templat yang digunakan untuk penyebaran pada cakupan langganan.

az deployment sub export --name MyDeployment

Parameter yang Diperlukan

--name -n

Nama penyebaran.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az deployment sub list

Edit

Mencantumkan penyebaran di cakupan langganan.

az deployment sub list [--filter]

Contoh

Mencantumkan penyebaran di cakupan langganan.

az deployment sub list

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://learn.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az deployment sub show

Edit

Tampilkan penyebaran di cakupan langganan.

az deployment sub show --name

Contoh

Tampilkan penyebaran di cakupan langganan.

az deployment sub show -n deployment01

Parameter yang Diperlukan

--name -n

Nama penyebaran.

Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az deployment sub validate

Edit

Validasi apakah templat valid pada cakupan langganan.

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

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

Contoh

Validasi apakah templat valid pada cakupan langganan.

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

Validasi apakah templat valid pada cakupan langganan. (dibuat otomatis)

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

Parameter yang Diperlukan

--location -l

Lokasi untuk menyimpan metadata penyebaran.

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.

--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 sintaks @{path}, 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.

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

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az deployment sub wait

Edit

Tempatkan CLI dalam status tunggu hingga kondisi penyebaran terpenuhi.

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

Contoh

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

az deployment sub wait --created --name MyDeployment

Parameter yang Diperlukan

--name -n

Nama penyebaran.

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

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.

az deployment sub what-if

Edit

Jalankan operasi What-If penyebaran pada cakupan langganan.

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

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]

Contoh

Jalankan operasi What-If penyebaran pada langganan.

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

Jalankan operasi What-If penyebaran pada langganan dengan format ResourceIdOnly.

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

Jalankan operasi What-If penyebaran pada langganan tanpa mencetak hasilnya dengan cantik.

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

Parameter yang Diperlukan

--location -l

Lokasi untuk menyimpan metadata operasi What-If penyebaran.

Parameter Opsional

--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
--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 sintaks @{path}, 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

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan 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 dan contoh selengkapnya.

--subscription

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

--verbose

Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.