Bagikan melalui

Microsoft.Compute virtualMachines/extensions

  • Artikel
  • Terbaru
  • 2024-07-01
  • 2024-03-01
  • 2023-09-01
  • 2023-07-01
  • 2023-03-01
  • 2022-11-01
  • 2022-08-01
  • 2022-03-01
  • 2021-11-01
  • 2021-07-01
  • 2021-04-01
  • 2021-03-01
  • 2020-12-01

Definisi sumber daya Bicep

Jenis sumber daya virtualMachines/extensions dapat disebarkan dengan operasi yang menargetkan:

  • Grup sumber daya - Lihat perintah penyebaran grup sumber daya

Untuk daftar properti yang diubah di setiap versi API, lihat mengubah log.

Format sumber daya

Untuk membuat sumber daya Microsoft.Compute/virtualMachines/extensions, tambahkan Bicep berikut ke templat Anda.

resource symbolicname 'Microsoft.Compute/virtualMachines/extensions@2024-07-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    autoUpgradeMinorVersion: bool
    enableAutomaticUpgrade: bool
    forceUpdateTag: 'string'
    instanceView: {
      name: 'string'
      statuses: [
        {
          code: 'string'
          displayStatus: 'string'
          level: 'string'
          message: 'string'
          time: 'string'
        }
      ]
      substatuses: [
        {
          code: 'string'
          displayStatus: 'string'
          level: 'string'
          message: 'string'
          time: 'string'
        }
      ]
      type: 'string'
      typeHandlerVersion: 'string'
    }
    protectedSettings: any()
    protectedSettingsFromKeyVault: {
      secretUrl: 'string'
      sourceVault: {
        id: 'string'
      }
    }
    provisionAfterExtensions: [
      'string'
    ]
    publisher: 'string'
    settings: any()
    suppressFailures: bool
    type: 'string'
    typeHandlerVersion: 'string'
  }
}

Nilai properti

virtualMachines/extensions

Nama Deskripsi Nilai
Nama Nama sumber daya

Lihat cara mengatur nama dan jenis untuk sumber daya anak di Bicep.		 string (diperlukan)
tempat Lokasi sumber daya tali
Tags Tag sumber daya Kamus nama dan nilai tag. Lihat Tag dalam templat
ortu Di Bicep, Anda dapat menentukan sumber daya induk untuk sumber daya anak. Anda hanya perlu menambahkan properti ini ketika sumber daya anak dideklarasikan di luar sumber daya induk.

Untuk informasi selengkapnya, lihat sumber daya Turunan di luar sumber daya induk.		 Nama simbolis untuk sumber daya jenis: virtualMachines
Properti Menjelaskan properti Ekstensi Komputer Virtual. VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Nama Deskripsi Nilai
autoUpgradeMinorVersion Menunjukkan apakah ekstensi harus menggunakan versi minor yang lebih baru jika tersedia pada waktu penyebaran. Namun, setelah disebarkan, ekstensi tidak akan meningkatkan versi minor kecuali disebarkan ulang, bahkan dengan properti ini diatur ke true. bool
enableAutomaticUpgrade Menunjukkan apakah ekstensi harus ditingkatkan secara otomatis oleh platform jika ada versi ekstensi yang lebih baru yang tersedia. bool
forceUpdateTag Bagaimana handler ekstensi harus diperbarui meskipun konfigurasi ekstensi belum berubah. tali
instanceView Tampilan instans ekstensi komputer virtual. VirtualMachineExtensionInstanceView
protectedSettings Ekstensi dapat berisi protectedSettings atau protectedSettingsFromKeyVault atau tidak ada pengaturan yang dilindungi sama sekali. Untuk Bicep, Anda dapat menggunakan fungsi any().
protectedSettingsFromKeyVault Pengaturan yang dilindungi ekstensi yang diteruskan oleh referensi, dan dikonsumsi dari brankas kunci KeyVaultSecretReference
provisionAfterExtensions Kumpulan nama ekstensi setelah ekstensi ini perlu disediakan. string[]
penerbit Nama penerbit handler ekstensi. tali
Pengaturan Pengaturan publik berformat Json untuk ekstensi. Untuk Bicep, Anda dapat menggunakan fungsi any().
suppressFailures Menunjukkan apakah kegagalan yang berasal dari ekstensi akan ditekan (Kegagalan operasional seperti tidak terhubung ke VM tidak akan ditekan terlepas dari nilai ini). Defaultnya adalah false. bool
jenis Menentukan jenis ekstensi; contohnya adalah "CustomScriptExtension". tali
typeHandlerVersion Menentukan versi handler skrip. tali

VirtualMachineExtensionInstanceView

Nama Deskripsi Nilai
Nama Nama ekstensi komputer virtual. tali
Status Informasi status sumber daya. InstanceViewStatus[]
substatus Informasi status sumber daya. InstanceViewStatus[]
jenis Menentukan jenis ekstensi; contohnya adalah "CustomScriptExtension". tali
typeHandlerVersion Menentukan versi handler skrip. tali

InstanceViewStatus

Nama Deskripsi Nilai
kode Kode status. tali
displayStatus Label pendek yang dapat dilokalkan untuk status tersebut. tali
tingkat Kode tingkat. 'Kesalahan'
'Info'
'Peringatan'
pesan Pesan status terperinci, termasuk untuk pemberitahuan dan pesan kesalahan. tali
Waktu Waktu status. tali

KeyVaultSecretReference

Nama Deskripsi Nilai
secretUrl URL yang mereferensikan rahasia di Key Vault. string (diperlukan)
sourceVault URL relatif Key Vault yang berisi rahasia. SubResource (diperlukan)

SubResource

Nama Deskripsi Nilai
Id Id Sumber Daya tali

Templat mulai cepat

Templat mulai cepat berikut menyebarkan jenis sumber daya ini.

Templat Deskripsi
Membuat VM Windows dengan ekstensi Anti-Malware diaktifkan

Sebarkan ke Azure 		Templat ini membuat VM Windows dan menyiapkan perlindungan Anti-Malware
IIS Server menggunakan ekstensi DSC pada VM Windows

Sebarkan ke Azure 		Templat ini membuat VM Windows dan menyiapkan server IIS menggunakan ekstensi DSC. Perhatikan, modul konfigurasi DSC memerlukan token SAS untuk diteruskan jika Anda menggunakan Azure Storage. Untuk tautan modul DSC dari GitHub (default dalam templat ini), ini tidak diperlukan.
Ekstensi VM ESET

Sebarkan ke Azure 		Membuat VM dengan ekstensi ESET
McAfee Endpoint Security (lisensi uji coba) pada Windows VM

Sebarkan ke Azure 		Templat ini membuat VM Windows dan menyiapkan versi percobaan McAfee Endpoint Security
Menyebarkan VM Ubuntu dengan ekstensi OMS

Sebarkan ke Azure 		Templat ini memungkinkan Anda untuk menyebarkan VM Ubuntu dengan ekstensi OMS yang diinstal dan di-onboard ke ruang kerja tertentu
Menyebarkan VM Windows dengan ekstensi OMS

Sebarkan ke Azure 		Templat ini memungkinkan Anda untuk menyebarkan VM Windows dengan ekstensi OMS yang diinstal dan di-onboard ke ruang kerja tertentu
uji coba ekstensi Perlindungan Titik Akhir Symantec pada windows VM

Sebarkan ke Azure 		Templat ini membuat VM Windows dan menyiapkan versi percobaan Perlindungan Titik Akhir Symantec
ekstensi Skrip Kustom pada VM Ubuntu

Sebarkan ke Azure 		Templat ini membuat VM Ubuntu dan menginstal ekstensi CustomScript
ekstensi Patching OS pada VM Ubuntu

Sebarkan ke Azure 		Templat ini membuat VM Ubuntu dan menginstal ekstensi OSPatching
Menyebarkan VM Windows Premium dengan diagnostik

Sebarkan ke Azure 		Templat ini memungkinkan Anda untuk menyebarkan VM Windows Premium menggunakan beberapa opsi berbeda untuk versi Windows, menggunakan versi patch terbaru.
Menyebarkan VM Windows sederhana dengan pemantauan dan diagnostik

Sebarkan ke Azure 		Templat ini memungkinkan Anda untuk menyebarkan VM Windows sederhana bersama dengan ekstensi diagnostik yang memungkinkan pemantauan dan diagnostik untuk VM
Menggunakan ekstensi skrip untuk menginstal Mongo DB pada VM Ubuntu

Sebarkan ke Azure 		Templat ini menyebarkan Konfigurasi dan Instal Mongo DB pada Ubuntu Virtual Machine dalam dua skrip terpisah. Templat ini adalah contoh yang baik yang menampilkan cara mengekspresikan dependensi antara dua skrip yang berjalan pada komputer virtual yang sama. Templat ini juga menyebarkan Akun Penyimpanan, Jaringan Virtual, alamat IP Publik, dan Antarmuka Jaringan.

Definisi sumber daya templat ARM

Jenis sumber daya virtualMachines/extensions dapat disebarkan dengan operasi yang menargetkan:

  • Grup sumber daya - Lihat perintah penyebaran grup sumber daya

Untuk daftar properti yang diubah di setiap versi API, lihat mengubah log.

Format sumber daya

Untuk membuat sumber daya Microsoft.Compute/virtualMachines/extensions, tambahkan JSON berikut ke templat Anda.

{
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "apiVersion": "2024-07-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "autoUpgradeMinorVersion": "bool",
    "enableAutomaticUpgrade": "bool",
    "forceUpdateTag": "string",
    "instanceView": {
      "name": "string",
      "statuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "level": "string",
          "message": "string",
          "time": "string"
        }
      ],
      "substatuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "level": "string",
          "message": "string",
          "time": "string"
        }
      ],
      "type": "string",
      "typeHandlerVersion": "string"
    },
    "protectedSettings": {},
    "protectedSettingsFromKeyVault": {
      "secretUrl": "string",
      "sourceVault": {
        "id": "string"
      }
    },
    "provisionAfterExtensions": [ "string" ],
    "publisher": "string",
    "settings": {},
    "suppressFailures": "bool",
    "type": "string",
    "typeHandlerVersion": "string"
  }
}

Nilai properti

virtualMachines/extensions

Nama Deskripsi Nilai
jenis Jenis sumber daya 'Microsoft.Compute/virtualMachines/extensions'
apiVersion Versi api sumber daya '2024-07-01'
Nama Nama sumber daya

Lihat cara mengatur nama dan jenis untuk sumber daya anak di templat JSON ARM.		 string (diperlukan)
tempat Lokasi sumber daya tali
Tags Tag sumber daya Kamus nama dan nilai tag. Lihat Tag dalam templat
Properti Menjelaskan properti Ekstensi Komputer Virtual. VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Nama Deskripsi Nilai
autoUpgradeMinorVersion Menunjukkan apakah ekstensi harus menggunakan versi minor yang lebih baru jika tersedia pada waktu penyebaran. Namun, setelah disebarkan, ekstensi tidak akan meningkatkan versi minor kecuali disebarkan ulang, bahkan dengan properti ini diatur ke true. bool
enableAutomaticUpgrade Menunjukkan apakah ekstensi harus ditingkatkan secara otomatis oleh platform jika ada versi ekstensi yang lebih baru yang tersedia. bool
forceUpdateTag Bagaimana handler ekstensi harus diperbarui meskipun konfigurasi ekstensi belum berubah. tali
instanceView Tampilan instans ekstensi komputer virtual. VirtualMachineExtensionInstanceView
protectedSettings Ekstensi dapat berisi protectedSettings atau protectedSettingsFromKeyVault atau tidak ada pengaturan yang dilindungi sama sekali.
protectedSettingsFromKeyVault Pengaturan yang dilindungi ekstensi yang diteruskan oleh referensi, dan dikonsumsi dari brankas kunci KeyVaultSecretReference
provisionAfterExtensions Kumpulan nama ekstensi setelah ekstensi ini perlu disediakan. string[]
penerbit Nama penerbit handler ekstensi. tali
Pengaturan Pengaturan publik berformat Json untuk ekstensi.
suppressFailures Menunjukkan apakah kegagalan yang berasal dari ekstensi akan ditekan (Kegagalan operasional seperti tidak terhubung ke VM tidak akan ditekan terlepas dari nilai ini). Defaultnya adalah false. bool
jenis Menentukan jenis ekstensi; contohnya adalah "CustomScriptExtension". tali
typeHandlerVersion Menentukan versi handler skrip. tali

VirtualMachineExtensionInstanceView

Nama Deskripsi Nilai
Nama Nama ekstensi komputer virtual. tali
Status Informasi status sumber daya. InstanceViewStatus[]
substatus Informasi status sumber daya. InstanceViewStatus[]
jenis Menentukan jenis ekstensi; contohnya adalah "CustomScriptExtension". tali
typeHandlerVersion Menentukan versi handler skrip. tali

InstanceViewStatus

Nama Deskripsi Nilai
kode Kode status. tali
displayStatus Label pendek yang dapat dilokalkan untuk status tersebut. tali
tingkat Kode tingkat. 'Kesalahan'
'Info'
'Peringatan'
pesan Pesan status terperinci, termasuk untuk pemberitahuan dan pesan kesalahan. tali
Waktu Waktu status. tali

KeyVaultSecretReference

Nama Deskripsi Nilai
secretUrl URL yang mereferensikan rahasia di Key Vault. string (diperlukan)
sourceVault URL relatif Key Vault yang berisi rahasia. SubResource (diperlukan)

SubResource

Nama Deskripsi Nilai
Id Id Sumber Daya tali

Templat mulai cepat

Templat mulai cepat berikut menyebarkan jenis sumber daya ini.

Templat Deskripsi
Membuat VM Windows dengan ekstensi Anti-Malware diaktifkan

Sebarkan ke Azure 		Templat ini membuat VM Windows dan menyiapkan perlindungan Anti-Malware
IIS Server menggunakan ekstensi DSC pada VM Windows

Sebarkan ke Azure 		Templat ini membuat VM Windows dan menyiapkan server IIS menggunakan ekstensi DSC. Perhatikan, modul konfigurasi DSC memerlukan token SAS untuk diteruskan jika Anda menggunakan Azure Storage. Untuk tautan modul DSC dari GitHub (default dalam templat ini), ini tidak diperlukan.
Ekstensi VM ESET

Sebarkan ke Azure 		Membuat VM dengan ekstensi ESET
McAfee Endpoint Security (lisensi uji coba) pada Windows VM

Sebarkan ke Azure 		Templat ini membuat VM Windows dan menyiapkan versi percobaan McAfee Endpoint Security
Menyebarkan VM Ubuntu dengan ekstensi OMS

Sebarkan ke Azure 		Templat ini memungkinkan Anda untuk menyebarkan VM Ubuntu dengan ekstensi OMS yang diinstal dan di-onboard ke ruang kerja tertentu
Menyebarkan VM Windows dengan ekstensi OMS

Sebarkan ke Azure 		Templat ini memungkinkan Anda untuk menyebarkan VM Windows dengan ekstensi OMS yang diinstal dan di-onboard ke ruang kerja tertentu
uji coba ekstensi Perlindungan Titik Akhir Symantec pada windows VM

Sebarkan ke Azure 		Templat ini membuat VM Windows dan menyiapkan versi percobaan Perlindungan Titik Akhir Symantec
ekstensi Skrip Kustom pada VM Ubuntu

Sebarkan ke Azure 		Templat ini membuat VM Ubuntu dan menginstal ekstensi CustomScript
ekstensi Patching OS pada VM Ubuntu

Sebarkan ke Azure 		Templat ini membuat VM Ubuntu dan menginstal ekstensi OSPatching
Menyebarkan VM Windows Premium dengan diagnostik

Sebarkan ke Azure 		Templat ini memungkinkan Anda untuk menyebarkan VM Windows Premium menggunakan beberapa opsi berbeda untuk versi Windows, menggunakan versi patch terbaru.
Menyebarkan VM Windows sederhana dengan pemantauan dan diagnostik

Sebarkan ke Azure 		Templat ini memungkinkan Anda untuk menyebarkan VM Windows sederhana bersama dengan ekstensi diagnostik yang memungkinkan pemantauan dan diagnostik untuk VM
Menggunakan ekstensi skrip untuk menginstal Mongo DB pada VM Ubuntu

Sebarkan ke Azure 		Templat ini menyebarkan Konfigurasi dan Instal Mongo DB pada Ubuntu Virtual Machine dalam dua skrip terpisah. Templat ini adalah contoh yang baik yang menampilkan cara mengekspresikan dependensi antara dua skrip yang berjalan pada komputer virtual yang sama. Templat ini juga menyebarkan Akun Penyimpanan, Jaringan Virtual, alamat IP Publik, dan Antarmuka Jaringan.

Definisi sumber daya Terraform (penyedia AzAPI)

Jenis sumber daya virtualMachines/extensions dapat disebarkan dengan operasi yang menargetkan:

  • grup Sumber Daya

Untuk daftar properti yang diubah di setiap versi API, lihat mengubah log.

Format sumber daya

Untuk membuat sumber daya Microsoft.Compute/virtualMachines/extensions, tambahkan Terraform berikut ke templat Anda.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachines/extensions@2024-07-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      autoUpgradeMinorVersion = bool
      enableAutomaticUpgrade = bool
      forceUpdateTag = "string"
      instanceView = {
        name = "string"
        statuses = [
          {
            code = "string"
            displayStatus = "string"
            level = "string"
            message = "string"
            time = "string"
          }
        ]
        substatuses = [
          {
            code = "string"
            displayStatus = "string"
            level = "string"
            message = "string"
            time = "string"
          }
        ]
        type = "string"
        typeHandlerVersion = "string"
      }
      protectedSettingsFromKeyVault = {
        secretUrl = "string"
        sourceVault = {
          id = "string"
        }
      }
      provisionAfterExtensions = [
        "string"
      ]
      publisher = "string"
      suppressFailures = bool
      type = "string"
      typeHandlerVersion = "string"
    }
  })
}

Nilai properti

virtualMachines/extensions

Nama Deskripsi Nilai
jenis Jenis sumber daya "Microsoft.Compute/virtualMachines/extensions@2024-07-01"
Nama Nama sumber daya string (diperlukan)
tempat Lokasi sumber daya tali
parent_id ID sumber daya yang merupakan induk untuk sumber daya ini. ID untuk sumber daya jenis: virtualMachines
Tags Tag sumber daya Kamus nama dan nilai tag.
Properti Menjelaskan properti Ekstensi Komputer Virtual. VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Nama Deskripsi Nilai
autoUpgradeMinorVersion Menunjukkan apakah ekstensi harus menggunakan versi minor yang lebih baru jika tersedia pada waktu penyebaran. Namun, setelah disebarkan, ekstensi tidak akan meningkatkan versi minor kecuali disebarkan ulang, bahkan dengan properti ini diatur ke true. bool
enableAutomaticUpgrade Menunjukkan apakah ekstensi harus ditingkatkan secara otomatis oleh platform jika ada versi ekstensi yang lebih baru yang tersedia. bool
forceUpdateTag Bagaimana handler ekstensi harus diperbarui meskipun konfigurasi ekstensi belum berubah. tali
instanceView Tampilan instans ekstensi komputer virtual. VirtualMachineExtensionInstanceView
protectedSettings Ekstensi dapat berisi protectedSettings atau protectedSettingsFromKeyVault atau tidak ada pengaturan yang dilindungi sama sekali.
protectedSettingsFromKeyVault Pengaturan yang dilindungi ekstensi yang diteruskan oleh referensi, dan dikonsumsi dari brankas kunci KeyVaultSecretReference
provisionAfterExtensions Kumpulan nama ekstensi setelah ekstensi ini perlu disediakan. string[]
penerbit Nama penerbit handler ekstensi. tali
Pengaturan Pengaturan publik berformat Json untuk ekstensi.
suppressFailures Menunjukkan apakah kegagalan yang berasal dari ekstensi akan ditekan (Kegagalan operasional seperti tidak terhubung ke VM tidak akan ditekan terlepas dari nilai ini). Defaultnya adalah false. bool
jenis Menentukan jenis ekstensi; contohnya adalah "CustomScriptExtension". tali
typeHandlerVersion Menentukan versi handler skrip. tali

VirtualMachineExtensionInstanceView

Nama Deskripsi Nilai
Nama Nama ekstensi komputer virtual. tali
Status Informasi status sumber daya. InstanceViewStatus[]
substatus Informasi status sumber daya. InstanceViewStatus[]
jenis Menentukan jenis ekstensi; contohnya adalah "CustomScriptExtension". tali
typeHandlerVersion Menentukan versi handler skrip. tali

InstanceViewStatus

Nama Deskripsi Nilai
kode Kode status. tali
displayStatus Label pendek yang dapat dilokalkan untuk status tersebut. tali
tingkat Kode tingkat. "Kesalahan"
"Info"
"Peringatan"
pesan Pesan status terperinci, termasuk untuk pemberitahuan dan pesan kesalahan. tali
Waktu Waktu status. tali

KeyVaultSecretReference

Nama Deskripsi Nilai
secretUrl URL yang mereferensikan rahasia di Key Vault. string (diperlukan)
sourceVault URL relatif Key Vault yang berisi rahasia. SubResource (diperlukan)

SubResource

Nama Deskripsi Nilai
Id Id Sumber Daya tali