az deployment mg

  • Referensi

Mengelola penyebaran templat Azure Resource Manager di grup manajemen.

Perintah

Nama Deskripsi Jenis Status
az deployment mg cancel

Batalkan penyebaran di grup manajemen.

 Inti GA
az deployment mg create

Mulai penyebaran di grup manajemen.

 Inti GA
az deployment mg delete

Menghapus penyebaran di grup manajemen.

 Inti GA
az deployment mg export

Ekspor templat yang digunakan untuk penyebaran.

 Inti GA
az deployment mg list

Mencantumkan penyebaran di grup manajemen.

 Inti GA
az deployment mg show

Tampilkan penyebaran di grup manajemen.

 Inti GA
az deployment mg validate

Validasi apakah templat valid di grup manajemen.

 Inti GA
az deployment mg wait

Tempatkan CLI dalam status tunggu hingga kondisi penyebaran terpenuhi.

 Inti GA
az deployment mg what-if

Jalankan operasi What-If penyebaran di cakupan grup manajemen.

 Inti GA

az deployment mg cancel

Edit

Batalkan penyebaran di grup manajemen.

az deployment mg cancel --management-group-id
                        --name

Contoh

Batalkan penyebaran di grup manajemen.

az deployment mg cancel -m testmg -n deployment01

Parameter yang Diperlukan

--management-group-id -m

Id grup manajemen.

--name -n

Nama penyebaran.

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

Edit

Mulai penyebaran di grup manajemen.

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

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

Contoh

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

az deployment mg create --management-group-id testrg --name rollout01 --location WestUS \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

az deployment mg create --management-group-id testmg --name rollout01 --location WestUS \
    --template-file azuredeploy.json \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

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

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

Parameter yang Diperlukan

--location -l

Lokasi untuk menyimpan metadata penyebaran.

--management-group-id -m

Id grup manajemen untuk membuat penyebaran di.

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.

--mode

Mode yang digunakan untuk menyebarkan sumber daya. Nilai ini dapat bertahas atau Lengkap. Dalam mode Bertahap, sumber daya disebarkan tanpa menghapus sumber daya yang ada yang tidak disertakan dalam templat. Dalam mode Selesai, sumber daya disebarkan dan sumber daya yang ada dalam grup sumber daya yang tidak disertakan dalam templat dihapus. Berhati-hatilah saat menggunakan mode Lengkap karena Anda mungkin secara tidak sengaja menghapus sumber daya.

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.

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

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

Edit

Menghapus penyebaran di grup manajemen.

az deployment mg delete --management-group-id
                        --name
                        [--no-wait]

Contoh

Menghapus penyebaran di grup manajemen.

az deployment mg delete -m testmg -n deployment01

Parameter yang Diperlukan

--management-group-id -m

Id grup manajemen.

--name -n

Nama penyebaran.

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

Edit

Ekspor templat yang digunakan untuk penyebaran.

az deployment mg export --management-group-id
                        --name

Contoh

Ekspor templat yang digunakan untuk penyebaran di grup manajemen.

az deployment mg export --management-group-id testmg --name MyDeployment

Parameter yang Diperlukan

--management-group-id -m

Id grup manajemen.

--name -n

Nama penyebaran.

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

Edit

Mencantumkan penyebaran di grup manajemen.

az deployment mg list --management-group-id
                      [--filter]

Contoh

Mencantumkan penyebaran di grup manajemen.

az deployment mg list -m testmg

Parameter yang Diperlukan

--management-group-id -m

Id grup manajemen.

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

Edit

Tampilkan penyebaran di grup manajemen.

az deployment mg show --management-group-id
                      --name

Contoh

Tampilkan penyebaran di grup manajemen.

az deployment mg show -m testmg -n deployment01

Parameter yang Diperlukan

--management-group-id -m

Id grup manajemen.

--name -n

Nama penyebaran.

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

Edit

Validasi apakah templat valid di grup manajemen.

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

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]

Contoh

Validasi apakah templat valid di grup manajemen.

az deployment mg validate --management-group-id testmg --location WestUS --template-file {template-file}

Validasi apakah templat valid di grup manajemen. (dibuat otomatis)

az deployment mg validate --location WestUS --management-group-id testmg --name mydeployment --parameters @myparameters.json --template-file azuredeploy.json

Parameter yang Diperlukan

--location -l

Lokasi untuk menyimpan metadata penyebaran.

--management-group-id -m

Id grup manajemen 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.

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

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

Edit

Tempatkan CLI dalam status tunggu hingga kondisi penyebaran terpenuhi.

az deployment mg wait --management-group-id
                      --name
                      [--created]
                      [--custom]
                      [--deleted]
                      [--exists]
                      [--interval]
                      [--timeout]
                      [--updated]

Parameter yang Diperlukan

--management-group-id -m

Id grup manajemen.

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

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 mg what-if

Edit

Jalankan operasi What-If penyebaran di cakupan grup manajemen.

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

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]

Contoh

Jalankan operasi What-If penyebaran di grup manajemen.

az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

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

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

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

Parameter yang Diperlukan

--location -l

Lokasi untuk menyimpan metadata penyebaran.

--management-group-id -m

Id grup manajemen untuk membuat penyebaran di.

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