Bagikan melalui


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

Nama Deskripsi Jenis Status
az vm extension delete

Hapus operasi untuk menghapus ekstensi.

Core GA
az vm extension image

Temukan ekstensi VM yang tersedia untuk langganan dan wilayah.

Core GA
az vm extension image list

Cantumkan informasi tentang ekstensi yang tersedia.

Core GA
az vm extension image list-names

Cantumkan nama ekstensi yang tersedia.

Core GA
az vm extension image list-versions

Mencantumkan versi untuk ekstensi yang tersedia.

Core GA
az vm extension image show

Tampilkan informasi untuk ekstensi.

Core GA
az vm extension list

Mencantumkan ekstensi yang dilampirkan ke VM.

Core GA
az vm extension set

Atur ekstensi untuk VM.

Core GA
az vm extension show

Tampilkan informasi tentang ekstensi yang dilampirkan ke VM.

Core GA
az vm extension wait

Tempatkan CLI dalam status tunggu hingga kondisi terpenuhi.

Core GA

az vm extension delete

Hapus operasi untuk menghapus ekstensi.

az vm extension delete [--ids]
                       [--name --vm-extension-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

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--ids

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

Properti Nilai
Grup parameter: Resource Id Arguments
--name --vm-extension-name -n

Nama ekstensi komputer virtual.

Properti Nilai
Grup parameter: Resource Id Arguments
--no-wait

Jangan menunggu operasi jangka panjang selesai.

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

Properti Nilai
Grup parameter: Resource Id Arguments
--subscription

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

Properti Nilai
Grup parameter: Resource Id Arguments
--vm-name

Nama Komputer Virtual. Anda dapat mengonfigurasi default menggunakan az configure --defaults vm=<name>.

Properti Nilai
Grup parameter: Resource Id Arguments
Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti Nilai
Nilai default: False
--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti Nilai
Nilai default: False
--output -o

Format output.

Properti Nilai
Nilai default: json
Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--verbose

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

Properti Nilai
Nilai default: False

az vm extension list

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

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--ids

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

Properti Nilai
Grup parameter: Resource Id Arguments
--resource-group -g

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

Properti Nilai
Grup parameter: Resource Id Arguments
--subscription

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

Properti Nilai
Grup parameter: Resource Id Arguments
--vm-name

Nama Komputer Virtual. Anda dapat mengonfigurasi default menggunakan az configure --defaults vm=<name>.

Properti Nilai
Grup parameter: Resource Id Arguments
Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti Nilai
Nilai default: False
--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti Nilai
Nilai default: False
--output -o

Format output.

Properti Nilai
Nilai default: json
Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--verbose

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

Properti Nilai
Nilai default: False

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

Properti Nilai
Nilai dari: az vm extension image list
--publisher

Nama penerbit ekstensi.

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--enable-auto-upgrade

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

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

Properti Nilai
Nilai default: False
--ids

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

Properti Nilai
Grup parameter: Resource Id Arguments
--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.

Properti Nilai
Nilai default: False
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.

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

Jangan menunggu operasi jangka panjang selesai.

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

Properti Nilai
Grup parameter: Resource Id Arguments
--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.

Properti Nilai
Grup parameter: Resource Id Arguments
--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>.

Properti Nilai
Grup parameter: Resource Id Arguments
Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti Nilai
Nilai default: False
--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti Nilai
Nilai default: False
--output -o

Format output.

Properti Nilai
Nilai default: json
Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--verbose

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

Properti Nilai
Nilai default: False

az vm extension show

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

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--ids

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

Properti Nilai
Grup parameter: Resource Id Arguments
--instance-view

Tampilan instans ekstensi komputer virtual.

Properti Nilai
Nilai default: False
--name -n

Nama ekstensi.

Properti Nilai
Grup parameter: Resource Id Arguments
--resource-group -g

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

Properti Nilai
Grup parameter: Resource Id Arguments
--subscription

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

Properti Nilai
Grup parameter: Resource Id Arguments
--vm-name

Nama Komputer Virtual. Anda dapat mengonfigurasi default menggunakan az configure --defaults vm=<name>.

Properti Nilai
Grup parameter: Resource Id Arguments
Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti Nilai
Nilai default: False
--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti Nilai
Nilai default: False
--output -o

Format output.

Properti Nilai
Nilai default: json
Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--verbose

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

Properti Nilai
Nilai default: False

az vm extension wait

Tempatkan CLI dalam status tunggu hingga kondisi terpenuhi.

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

Parameter Opsional

Parameter berikut bersifat opsional, tetapi tergantung pada konteksnya, satu atau beberapa mungkin menjadi diperlukan agar perintah berhasil dijalankan.

--created

Tunggu hingga dibuat dengan 'provisioningState' di 'Berhasil'.

Properti Nilai
Grup parameter: Wait Condition Arguments
Nilai default: False
--custom

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

Properti Nilai
Grup parameter: Wait Condition Arguments
--deleted

Tunggu hingga dihapus.

Properti Nilai
Grup parameter: Wait Condition Arguments
Nilai default: False
--exists

Tunggu hingga sumber daya ada.

Properti Nilai
Grup parameter: Wait Condition Arguments
Nilai default: False
--expand

Ekspresi perluas untuk diterapkan pada operasi.

--ids

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

Properti Nilai
Grup parameter: Resource Id Arguments
--interval

Interval polling dalam hitungan detik.

Properti Nilai
Grup parameter: Wait Condition Arguments
Nilai default: 30
--name --vm-extension-name -n

Nama ekstensi komputer virtual.

Properti Nilai
Grup parameter: Resource Id Arguments
--resource-group -g

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

Properti Nilai
Grup parameter: Resource Id Arguments
--subscription

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

Properti Nilai
Grup parameter: Resource Id Arguments
--timeout

Tunggu maksimum dalam detik.

Properti Nilai
Grup parameter: Wait Condition Arguments
Nilai default: 3600
--updated

Tunggu hingga diperbarui dengan provisioningState di 'Berhasil'.

Properti Nilai
Grup parameter: Wait Condition Arguments
Nilai default: False
--vm-name

Nama Komputer Virtual. Anda dapat mengonfigurasi default menggunakan az configure --defaults vm=<name>.

Properti Nilai
Grup parameter: Resource Id Arguments
Parameter Global
--debug

Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.

Properti Nilai
Nilai default: False
--help -h

Tampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya tampilkan kesalahan, menekan peringatan.

Properti Nilai
Nilai default: False
--output -o

Format output.

Properti Nilai
Nilai default: json
Nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.

--verbose

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

Properti Nilai
Nilai default: False