az vm extension

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

az vm extension delete	Menghapus ekstensi yang dilampirkan ke VM.
az vm extension image	Temukan ekstensi VM yang tersedia untuk langganan dan wilayah.
az vm extension image list	Cantumkan informasi tentang ekstensi yang tersedia.
az vm extension image list-names	Cantumkan nama ekstensi yang tersedia.
az vm extension image list-versions	Mencantumkan versi untuk ekstensi yang tersedia.
az vm extension image show	Tampilkan informasi untuk ekstensi.
az vm extension list	Mencantumkan ekstensi yang dilampirkan ke VM.
az vm extension set	Atur ekstensi untuk VM.
az vm extension show	Menampilkan informasi tentang ekstensi yang dilampirkan ke VM.
az vm extension wait	Tempatkan CLI dalam status menunggu hingga kondisi ekstensi komputer virtual terpenuhi.

az vm extension delete

Menghapus ekstensi yang dilampirkan ke VM.

az vm extension delete [--ids]
                       [--name]
                       [--no-wait]
                       [--resource-group]
                       [--vm-name]

Contoh

Gunakan nama dan ekstensi VM untuk menghapus ekstensi dari VM.

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

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

Nama ekstensi.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

--resource-group -g

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

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

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi yang lebih lengkap 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

Mencantumkan ekstensi yang dilampirkan ke VM.

az vm extension list --resource-group
                     --vm-name

Contoh

Mencantumkan ekstensi terlampir ke VM bernama.

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

Parameter yang Diperlukan

--resource-group -g

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

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

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi yang lebih lengkap 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

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]
                    [--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 tidak berubah.

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

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

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

--no-wait

Jangan menunggu operasi jangka panjang selesai.

--protected-settings

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

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

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi yang lebih lengkap 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

Menampilkan informasi tentang ekstensi yang dilampirkan ke VM.

az vm extension show [--expand]
                     [--ids]
                     [--instance-view]
                     [--name]
                     [--resource-group]
                     [--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

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

--instance-view

Tampilan instans ekstensi komputer virtual.

--name -n

Nama ekstensi.

--resource-group -g

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

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

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi yang lebih lengkap 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

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

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

Contoh

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

--custom

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

--deleted

Tunggu hingga dihapus.

--exists

Tunggu hingga sumber daya ada.

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

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

--timeout

Waktu tunggu maksimum dalam detik.

nilai default: 3600

--updated

Tunggu hingga diperbarui dengan provisioningState di 'Berhasil'.

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

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi yang lebih lengkap 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.