az image

Catatan

Grup perintah ini memiliki perintah yang ditentukan di Azure CLI dan setidaknya satu ekstensi. Instal setiap ekstensi untuk mendapatkan manfaat dari kemampuannya yang diperluas. Pelajari lebih lanjut tentang ekstensi.

Mengelola citra mesin virtual kustom.

Perintah

Nama	Deskripsi	Jenis	Status
az image builder	Mengelola dan membangun templat penyusun gambar.	Inti	GA
az image builder cancel	Batalkan build gambar yang berjalan lama berdasarkan templat gambar.	Inti	GA
az image builder create	Membuat templat penyusun gambar.	Inti	GA
az image builder customizer	Mengelola penyesuai templat penyusun citra.	Inti	GA
az image builder customizer add	Tambahkan penyesuai penyusun gambar ke templat penyusun gambar.	Inti	GA
az image builder customizer clear	Hapus semua penyesuai penyusun gambar dari templat penyusun gambar.	Inti	GA
az image builder customizer remove	Menghapus penyesuai penyusun gambar dari templat penyusun gambar.	Inti	GA
az image builder delete	Menghapus templat penyusun gambar.	Inti	GA
az image builder error-handler	Mengelola penanganan kesalahan templat penyusun gambar.	Inti	GA
az image builder error-handler add	Tambahkan penanganan kesalahan ke templat penyusun gambar yang sudah ada.	Inti	GA
az image builder error-handler remove	Hapus handler kesalahan dari templat penyusun gambar yang ada.	Inti	GA
az image builder error-handler show	Perlihatkan penanganan kesalahan templat penyusun gambar yang ada.	Inti	GA
az image builder identity	Mengelola identitas templat penyusun gambar.	Inti	GA
az image builder identity assign	Tambahkan identitas terkelola ke templat penyusun gambar yang sudah ada. Saat ini, hanya satu identitas pengguna yang didukung.	Inti	GA
az image builder identity remove	Hapus identitas terkelola dari templat penyusun gambar yang ada.	Inti	GA
az image builder identity show	Menampilkan identitas terkelola templat penyusun gambar.	Inti	GA
az image builder list	Mencantumkan templat penyusun gambar.	Inti	GA
az image builder optimizer	Mengelola pengoptimal templat penyusun gambar.	Inti	GA
az image builder optimizer add	Tambahkan pengoptimal ke templat penyusun gambar yang ada.	Inti	GA
az image builder optimizer remove	Hapus pengoptimal dari templat penyusun gambar yang ada.	Inti	GA
az image builder optimizer show	Tampilkan pengoptimal templat penyusun gambar yang ada.	Inti	GA
az image builder optimizer update	Perbarui pengoptimal dari templat penyusun gambar yang ada.	Inti	GA
az image builder output	Mengelola distributor output templat penyusun citra.	Inti	GA
az image builder output add	Tambahkan distributor output penyusun gambar ke templat penyusun gambar.	Inti	GA
az image builder output clear	Hapus semua distributor output penyusun gambar dari templat penyusun gambar.	Inti	GA
az image builder output remove	Menghapus distributor output penyusun gambar dari templat penyusun gambar.	Inti	GA
az image builder output versioning	Mengelola versi output templat penyusun gambar.	Inti	GA
az image builder output versioning remove	Hapus semua opsi penerapan versi pada output tertentu.	Inti	GA
az image builder output versioning set	Atur versi output penyusun gambar dari templat penyusun gambar.	Inti	GA
az image builder output versioning show	Tampilkan opsi penerapan versi pada output yang ditentukan.	Inti	GA
az image builder run	Buat templat penyusun gambar.	Inti	GA
az image builder show	Perlihatkan templat penyusun gambar.	Inti	GA
az image builder show-runs	Menampilkan output eksekusi templat pembangun gambar.	Inti	GA
az image builder trigger	Mengelola pemicu templat penyusun gambar.	Inti	GA
az image builder trigger create	Buat pemicu untuk templat gambar komputer virtual yang ditentukan.	Inti	GA
az image builder trigger delete	Hapus pemicu untuk templat gambar komputer virtual yang ditentukan.	Inti	GA
az image builder trigger list	Cantumkan semua pemicu untuk sumber daya Templat Gambar yang ditentukan.	Inti	GA
az image builder trigger show	Dapatkan pemicu yang ditentukan untuk sumber daya templat gambar yang ditentukan.	Inti	GA
az image builder trigger wait	Tempatkan CLI dalam status tunggu hingga kondisi terpenuhi.	Inti	GA
az image builder update	Perbarui templat penyusun gambar.	Inti	GA
az image builder validator	Kelola templat penyusun gambar memvalidasi.	Inti	GA
az image builder validator add	Tambahkan validasi ke templat penyusun gambar yang sudah ada.	Inti	GA
az image builder validator remove	Hapus validasi dari templat penyusun gambar yang ada.	Inti	GA
az image builder validator show	Perlihatkan validasi templat penyusun gambar yang ada.	Inti	GA
az image builder wait	Tempatkan CLI dalam status menunggu hingga kondisi templat terpenuhi.	Inti	GA
az image copy	Salin gambar terkelola (atau vm) ke wilayah lain. Ini mengharuskan disk sumber tersedia.	Ekstensi	GA
az image create	Buat Gambar Komputer Virtual kustom dari disk atau rekam jepret terkelola.	Inti	GA
az image delete	Menghapus Gambar.	Inti	GA
az image list	Cantumkan daftar gambar di bawah grup sumber daya.	Inti	GA
az image show	Dapatkan gambar.	Inti	GA
az image update	Perbarui gambar VM kustom.	Inti	GA
az image wait	Tempatkan CLI dalam status tunggu hingga kondisi terpenuhi.	Inti	GA

az image copy

Salin gambar terkelola (atau vm) ke wilayah lain. Ini mengharuskan disk sumber tersedia.

az image copy --source-object-name
              --source-resource-group
              --target-location
              --target-resource-group
              [--cleanup]
              [--export-as-snapshot]
              [--parallel-degree]
              [--source-type {image, vm}]
              [--tags]
              [--target-name]
              [--target-subscription]
              [--temporary-resource-group-name]
              [--timeout]

Contoh

Salin gambar ke beberapa wilayah dan bersihkan di akhir.

az image copy --source-resource-group mySources-rg --source-object-name myImage \
    --target-location uksouth northeurope --target-resource-group "images-repo-rg" --cleanup

Gunakan vm yang sudah digeneralisasi untuk membuat gambar di wilayah lain.

az image copy --source-resource-group mySources-rg --source-object-name myVm \
    --source-type vm --target-location uksouth northeurope --target-resource-group "images-repo-rg"

Parameter yang Diperlukan

--source-object-name

Nama gambar atau sumber daya vm.

--source-resource-group

Nama grup sumber daya sumber daya sumber daya.

--target-location

Daftar lokasi yang dipisahkan spasi untuk membuat gambar di (misalnya westeurope dll.).

--target-resource-group

Nama grup sumber daya untuk membuat gambar.

Parameter Opsional

--cleanup

Sertakan sakelar ini untuk menghapus sumber daya sementara setelah selesai.

nilai default: False

--export-as-snapshot

Sertakan sakelar ini untuk mengekspor salinan sebagai rekam jepret alih-alih gambar.

nilai default: False

--parallel-degree

Jumlah operasi penyalinan paralel.

nilai default: -1

--source-type

Gambar atau vm.

nilai yang diterima: image, vm

nilai default: image

--tags

Tag yang dipisahkan spasi: key[=value] [key[=value] ...]. Gunakan "" untuk menghapus tag yang ada.

--target-name

Nama gambar akhir yang akan dibuat.

--target-subscription

Nama atau ID langganan tempat gambar akhir harus dibuat.

--temporary-resource-group-name

Nama Grup Sumber Daya tempat akun penyimpanan sementara akan dibuat.

nilai default: image-copy-rg

--timeout

Waktu dalam detik agar operasi penyalinan selesai. Tingkatkan kali ini jika Anda akan menyalin gambar besar (disk) seperti 512GB atau lebih.

nilai default: 3600

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

Buat Gambar Komputer Virtual kustom dari disk atau rekam jepret terkelola.

az image create --name
                --resource-group
                --source
                [--data-disk-caching {None, ReadOnly, ReadWrite}]
                [--data-disk-sources]
                [--edge-zone]
                [--hyper-v-generation {V1, V2}]
                [--location]
                [--os-disk-caching {None, ReadOnly, ReadWrite}]
                [--os-type {Linux, Windows}]
                [--storage-sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
                [--tags]
                [--zone-resilient {false, true}]

Contoh

Buat gambar dari disk yang ada.

az image create -g MyResourceGroup -n image1 --os-type Linux \
    --source /subscriptions/db5eb68e-73e2-4fa8-b18a-0123456789999/resourceGroups/rg1/providers/Microsoft.Compute/snapshots/s1

Buat gambar dengan menangkap komputer virtual umum yang ada dalam grup sumber daya yang sama.

az image create -g MyResourceGroup -n image1 --source MyVm1

Parameter yang Diperlukan

--name -n

Nama gambar baru.

--resource-group -g

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

--source

Sumber disk OS dari wilayah yang sama, termasuk ID atau nama komputer virtual, URI blob disk OS, ID atau nama disk OS terkelola, atau ID atau nama rekam jepret OS.

Parameter Opsional

--data-disk-caching

Jenis penembolokan penyimpanan untuk disk data gambar.

nilai yang diterima: None, ReadOnly, ReadWrite

--data-disk-sources

Daftar sumber disk data yang dipisahkan spasi, termasuk URI blob yang tidak dikelola, ID atau nama disk terkelola, atau ID atau nama rekam jepret.

--edge-zone

Nama zona tepi.

--hyper-v-generation

Generasi hypervisor komputer virtual yang dibuat dari gambar.

nilai yang diterima: V1, V2

nilai default: V1

--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--os-disk-caching

Jenis penembolokan penyimpanan untuk disk OS gambar.

nilai yang diterima: None, ReadOnly, ReadWrite

--os-type

nilai yang diterima: Linux, Windows

--storage-sku

SKU akun penyimpanan untuk membuat gambar VM. Tidak digunakan jika VM sumber ditentukan.

nilai yang diterima: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS

--tags

Tag yang dipisahkan spasi: key[=value] [key[=value] ...]. Gunakan "" untuk menghapus tag yang ada.

--zone-resilient

Menentukan apakah gambar tangguh zona atau tidak. Defaultnya adalah false. Gambar tangguh zona hanya dapat dibuat di wilayah yang menyediakan Penyimpanan Redundan Zona.

nilai yang diterima: false, true

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

Menghapus Gambar.

az image delete [--ids]
                [--image-name]
                [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                [--resource-group]
                [--subscription]

Parameter Opsional

--ids

Satu atau beberapa ID sumber daya (dibatasi ruang). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

--image-name --name -n

Nama gambar.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

nilai yang diterima: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

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

--subscription

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

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

Cantumkan daftar gambar di bawah grup sumber daya.

az image list [--max-items]
              [--next-token]
              [--resource-group]

Parameter Opsional

--max-items

Jumlah total item yang akan dikembalikan dalam output perintah. Jika jumlah total item yang tersedia lebih dari nilai yang ditentukan, token disediakan dalam output perintah. Untuk melanjutkan penomoran halaman, berikan nilai token dalam --next-token argumen perintah berikutnya.

--next-token

Token untuk menentukan tempat untuk memulai paginating. Ini adalah nilai token dari respons yang dipotong sebelumnya.

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

Dapatkan gambar.

az image show [--expand]
              [--ids]
              [--image-name]
              [--resource-group]
              [--subscription]

Parameter Opsional

--expand

Ekspresi perluas untuk diterapkan pada operasi.

--ids

Satu atau beberapa ID sumber daya (dibatasi ruang). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

--image-name --name -n

Nama gambar.

--resource-group -g

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

--subscription

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

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

Perbarui gambar VM kustom.

az image update [--add]
                [--force-string]
                [--ids]
                [--name]
                [--remove]
                [--resource-group]
                [--set]
                [--subscription]
                [--tags]

Contoh

Menambahkan atau memperbarui tag.

az image update -n ImageName -g ResourceGroup --tags tag1=val1 tag2=val2

Hapus semua tag.

az image update -n ImageName -g resourceGroup --tags

Parameter Opsional

--add

Tambahkan objek ke daftar objek dengan menentukan jalur dan pasangan nilai kunci. Contoh: --add property.listProperty <key=value, string or JSON string>.

nilai default: []

--force-string

Saat menggunakan 'set' atau 'add', pertahankan literal string alih-alih mencoba mengonversi ke JSON.

nilai default: False

--ids

Satu atau beberapa ID sumber daya (dibatasi ruang). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

--name -n

Nama gambar. Harus diisi.

--remove

Menghapus properti atau elemen dari daftar. Contoh: --remove property.list <indexToRemove> ATAU --remove propertyToRemove.

nilai default: []

--resource-group -g

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

--set

Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=<value>.

nilai default: []

--subscription

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

--tags

Tag yang dipisahkan spasi: key[=value] [key[=value] ...]. Gunakan "" untuk menghapus tag yang ada.

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

Tempatkan CLI dalam status tunggu hingga kondisi terpenuhi.

az image wait [--created]
              [--custom]
              [--deleted]
              [--exists]
              [--expand]
              [--ids]
              [--image-name]
              [--interval]
              [--resource-group]
              [--subscription]
              [--timeout]
              [--updated]

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

--expand

Ekspresi perluas untuk diterapkan pada operasi.

--ids

Satu atau beberapa ID sumber daya (dibatasi ruang). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

--image-name --name -n

Nama gambar.

--interval

Interval polling dalam hitungan detik.

nilai default: 30

--resource-group -g

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

--subscription

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

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