Bagikan melalui

az vm extension

  • Referensi

Mengelola ekstensi pada VM.

Ekstensi adalah aplikasi kecil yang menyediakan konfigurasi pasca-penyebaran dan tugas otomatisasi pada komputer virtual Azure. Misalnya, jika komputer virtual memerlukan penginstalan perangkat lunak, perlindungan anti-virus, atau konfigurasi Docker, ekstensi VM dapat digunakan untuk menyelesaikan tugas-tugas ini. Ekstensi dapat dibundel dengan penyebaran komputer virtual baru atau dijalankan terhadap sistem yang ada.

Perintah

Nama Deskripsi Jenis Status
az vm extension delete

Hapus operasi untuk menghapus ekstensi.

 Inti GA
az vm extension image

Temukan ekstensi VM yang tersedia untuk langganan dan wilayah.

 Inti GA
az vm extension image list

Cantumkan informasi tentang ekstensi yang tersedia.

 Inti GA
az vm extension image list-names

Cantumkan nama ekstensi yang tersedia.

 Inti GA
az vm extension image list-versions

Mencantumkan versi untuk ekstensi yang tersedia.

 Inti GA
az vm extension image show

Tampilkan informasi untuk ekstensi.

 Inti GA
az vm extension list

Mencantumkan ekstensi yang dilampirkan ke VM.

 Inti GA
az vm extension set

Atur ekstensi untuk VM.

 Inti GA
az vm extension show

Tampilkan informasi tentang ekstensi yang dilampirkan ke VM.

 Inti GA
az vm extension wait

Tempatkan CLI dalam status tunggu hingga kondisi ekstensi komputer virtual terpenuhi.

 Inti GA

az vm extension delete

Edit

Hapus operasi untuk menghapus ekstensi.

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

Contoh

Gunakan nama dan ekstensi VM untuk menghapus ekstensi dari VM.

az vm extension delete -g MyResourceGroup --vm-name MyVm -n MyExtensionName

Hapus ekstensi dengan ID yang berisi string "MyExtension" dari VM.

az vm extension delete --ids $(az resource list --query "[?contains(name, 'MyExtension')].id" -o tsv)

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.

--name --vm-extension-name -n

Nama ekstensi komputer virtual.

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

--vm-name

Nama Komputer Virtual. Anda dapat mengonfigurasi default menggunakan az configure --defaults vm=<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 vm extension list

Edit

Mencantumkan ekstensi yang dilampirkan ke VM.

az vm extension list [--ids]
                     [--resource-group]
                     [--subscription]
                     [--vm-name]

Contoh

Mencantumkan ekstensi terlampir ke VM bernama.

az vm extension list -g MyResourceGroup --vm-name MyVm

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.

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

--vm-name

Nama Komputer Virtual. Anda dapat mengonfigurasi default menggunakan az configure --defaults vm=<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 vm extension set

Edit

Atur ekstensi untuk VM.

Dapatkan detail ekstensi dari az vm extension image list.

az vm extension set --name
                    --publisher
                    [--enable-auto-upgrade {false, true}]
                    [--extension-instance-name]
                    [--force-update]
                    [--ids]
                    [--no-auto-upgrade {false, true}]
                    [--no-auto-upgrade-minor-version {false, true}]
                    [--no-wait]
                    [--protected-settings]
                    [--resource-group]
                    [--settings]
                    [--subscription]
                    [--version]
                    [--vm-name]

Contoh

Tambahkan akun pengguna ke VM Linux.

az vm extension set -n VMAccessForLinux --publisher Microsoft.OSTCExtensions --version 1.4 \
    --vm-name MyVm --resource-group MyResourceGroup \
    --protected-settings '{"username":"user1", "ssh_key":"ssh_rsa ..."}'

Tambahkan ekstensi customScript ke VM yang ditentukan oleh --ids.

az vm extension set -n customScript --publisher Microsoft.Azure.Extensions --ids {vm_id}

Tambahkan ekstensi dan aktifkan peningkatan otomatis oleh platform jika ada versi ekstensi yang lebih baru yang tersedia.

az vm extension set -n extName --publisher publisher --vm-name MyVM -g MyResourceGroup \
--enable-auto-upgrade true

Parameter yang Diperlukan

--name -n

Nama ekstensi.

Nilai dari: az vm extension image list
--publisher

Nama penerbit ekstensi.

Parameter Opsional

--enable-auto-upgrade

Tunjukkan ekstensi harus ditingkatkan secara otomatis oleh platform jika ada versi ekstensi yang lebih baru yang tersedia.

Nilai yang diterima: false, true
--extension-instance-name

Nama instans ekstensi, yang dapat disesuaikan. Default: nama ekstensi.

--force-update

Paksa untuk memperbarui meskipun konfigurasi ekstensi belum berubah.

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.

--no-auto-upgrade
Tidak digunakan lagi

Opsi '--no-auto-upgrade' telah ditolak dan akan dihapus dalam rilis mendatang. Gunakan '--no-auto-upgrade-minor-version' sebagai gantinya.

Jika diatur, layanan ekstensi tidak akan secara otomatis memilih atau meningkatkan ke versi minor terbaru, bahkan jika ekstensi disebarkan ulang.

Nilai yang diterima: false, true
Nilai default: False
--no-auto-upgrade-minor-version

Jika diatur, layanan ekstensi tidak akan secara otomatis memilih atau meningkatkan ke versi minor terbaru, bahkan jika ekstensi disebarkan ulang.

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

Jangan menunggu operasi jangka panjang selesai.

Nilai default: False
--protected-settings

Pengaturan yang dilindungi dalam format JSON untuk informasi sensitif seperti kredensial. Jalur file JSON juga diterima.

--resource-group -g

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

--settings

Pengaturan ekstensi dalam format JSON. Jalur file JSON juga diterima.

--subscription

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

--version

Versi ekstensi. Untuk menyematkan versi ekstensi ke nilai ini, tentukan --no-auto-upgrade-minor-version.

--vm-name

Nama Komputer Virtual. Anda dapat mengonfigurasi default menggunakan az configure --defaults vm=<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 vm extension show

Edit

Tampilkan informasi tentang ekstensi yang dilampirkan ke VM.

az vm extension show [--ids]
                     [--instance-view]
                     [--name]
                     [--resource-group]
                     [--subscription]
                     [--vm-name]

Contoh

Gunakan nama VM dan nama ekstensi untuk menampilkan ekstensi yang dilampirkan ke VM.

az vm extension show -g MyResourceGroup --vm-name MyVm -n extension_name

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.

--instance-view

Tampilan instans ekstensi komputer virtual.

Nilai default: False
--name -n

Nama ekstensi.

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

--vm-name

Nama Komputer Virtual. Anda dapat mengonfigurasi default menggunakan az configure --defaults vm=<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 vm extension wait

Edit

Tempatkan CLI dalam status tunggu hingga kondisi ekstensi komputer virtual terpenuhi.

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

Contoh

Tempatkan CLI dalam status tunggu hingga kondisi ekstensi komputer virtual terpenuhi. (dibuat otomatis)

az vm extension wait --created --name MyExtension --resource-group MyResourceGroup --vm-name MyVm

Tempatkan CLI dalam status tunggu hingga kondisi ekstensi komputer virtual terpenuhi. (dibuat otomatis)

az vm extension wait --exists --name MyExtension --resource-group MyResourceGroup --vm-name MyVm

Tempatkan CLI dalam status tunggu hingga kondisi ekstensi komputer virtual terpenuhi. (dibuat otomatis)

az vm extension wait --ids @- --name MyExtension --subscription MySubscription --updated --vm-name MyVm

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

--interval

Interval polling dalam hitungan detik.

Nilai default: 30
--name -n

Nama ekstensi.

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

Nama Komputer Virtual. Anda dapat mengonfigurasi default menggunakan az configure --defaults vm=<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.