Microsoft.Compute virtualMachines/extensions 2020-12-01

• En son
• 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

Bicep kaynak tanımı

virtualMachines/extensions kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

• Kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.Compute/virtualMachines/extensions kaynağı oluşturmak için şablonunuza aşağıdaki Bicep'i ekleyin.

resource symbolicname 'Microsoft.Compute/virtualMachines/extensions@2020-12-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()
    publisher: 'string'
    settings: any()
    type: 'string'
    typeHandlerVersion: 'string'
  }
}

Özellik değerleri

virtualMachines/extensions

Ad	Açıklama	Değer
name	Kaynak adı Bicep'te alt kaynaklar için adları ve türleri ayarlamayı öğrenin.	dize (gerekli)
location	Kaynak konumu	dize (gerekli)
etiketler	Kaynak etiketleri	Etiket adlarının ve değerlerinin sözlüğü. Bkz. Şablonlardaki etiketler
Üst	Bicep'te alt kaynak için üst kaynağı belirtebilirsiniz. Bu özelliği yalnızca alt kaynak üst kaynağın dışında bildirildiğinde eklemeniz gerekir. Daha fazla bilgi için bkz . Üst kaynağın dışındaki alt kaynak.	Kaynak türü için sembolik ad: virtualMachines
properties	Bir Sanal Makine Uzantısının özelliklerini açıklar.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Ad	Açıklama	Değer
autoUpgradeMinorVersion	Dağıtım zamanında kullanılabilirse uzantının daha yeni bir ikincil sürüm kullanıp kullanmayacağını gösterir. Ancak dağıtıldıktan sonra, bu özellik true olarak ayarlanmış olsa bile uzantı yeniden dağıtılmadığı sürece ikincil sürümleri yükseltmez.	bool
enableAutomaticUpgrade	Kullanılabilir uzantının daha yeni bir sürümü varsa, uzantının platform tarafından otomatik olarak yükseltilip yükseltilmeyeceğini gösterir.	bool
forceUpdateTag	Uzantı yapılandırması değişmese bile uzantı işleyicisinin nasıl güncelleştirilmeye zorlanması gerektiği.	string
ınstanceview	Sanal makine uzantısı örneği görünümü.	VirtualMachineExtensionInstanceView
protectedSettings	Uzantı protectedSettings veya protectedSettingsFromKeyVault içerebilir veya hiçbir korumalı ayar içeremez.	Bicep için any() işlevini kullanabilirsiniz.
yayımcı	Uzantı işleyici yayımcısının adı.	string
ayarlar	Uzantı için Json biçimlendirilmiş genel ayarlar.	Bicep için any() işlevini kullanabilirsiniz.
tür	Uzantının türünü belirtir; "CustomScriptExtension" örnek olarak verilmiştir.	string
typeHandlerVersion	Betik işleyicisinin sürümünü belirtir.	string

VirtualMachineExtensionInstanceView

Ad	Açıklama	Değer
name	Sanal makine uzantısı adı.	string
Durum	Kaynak durumu bilgileri.	InstanceViewStatus[]
alt yordamlar	Kaynak durumu bilgileri.	InstanceViewStatus[]
tür	Uzantının türünü belirtir; "CustomScriptExtension" örnek olarak verilmiştir.	string
typeHandlerVersion	Betik işleyicisinin sürümünü belirtir.	string

InstanceViewStatus

Ad	Açıklama	Değer
kod	Durum kodu.	string
displayStatus	Durum için kısa yerelleştirilebilir etiket.	string
düzey	Düzey kodu.	'Hata' 'Bilgi' 'Uyarı'
message	Uyarılar ve hata iletileri de dahil olmak üzere ayrıntılı durum iletisi.	string
time	Durum zamanı.	string

Hızlı başlangıç şablonları

Aşağıdaki hızlı başlangıç şablonları bu kaynak türünü dağıtır.

Şablon	Description
Kötü Amaçlı Yazılımdan Koruma uzantısı etkinleştirilmiş bir Windows VM oluşturma	Bu şablon bir Windows VM oluşturur ve Kötü Amaçlı Yazılımdan Koruma'nın kurulumunu sağlar
Windows VM'de DSC uzantısını kullanan IIS Sunucusu	Bu şablon bir Windows VM oluşturur ve DSC uzantısını kullanarak bir IIS sunucusu ayarlar. Azure Depolama kullanıyorsanız DSC yapılandırma modülünün bir SAS belirtecinin geçirilmesi gerektiğini unutmayın. GitHub'dan DSC modülü bağlantısı için (bu şablonda varsayılan olarak) bu gerekli değildir.
ESET VM Uzantısı	ESET uzantısına sahip bir VM oluşturur
Windows VM'de McAfee Endpoint Security (deneme lisansı)	Bu şablon bir Windows VM oluşturur ve McAfee Endpoint Security'nin deneme sürümünü ayarlar
OMS uzantısıyla Ubuntu VM dağıtma	Bu şablon, OMS uzantısı yüklü ve belirtilen çalışma alanına eklenmiş bir Ubuntu VM dağıtmanızı sağlar
OMS uzantısına sahip bir Windows VM dağıtma	Bu şablon, OMS uzantısı yüklü ve belirtilen çalışma alanına eklenmiş bir Windows VM dağıtmanızı sağlar
Windows VM'de Symantec Endpoint Protection uzantısı deneme sürümü	Bu şablon bir Windows VM oluşturur ve Symantec Endpoint Protection'ın deneme sürümünü ayarlar
Ubuntu VM'sinde Özel Betik uzantısı	Bu şablon bir Ubuntu VM oluşturur ve CustomScript uzantısını yükler
Ubuntu VM'sinde işletim sistemi düzeltme eki uygulama uzantısı	Bu şablon bir Ubuntu VM oluşturur ve OSPatching uzantısını yükler
Tanılama ile Premium Windows VM dağıtma	Bu şablon, En son düzeltme eki uygulanmış sürümü kullanarak Windows sürümü için birkaç farklı seçenek kullanarak Premium Windows VM dağıtmanıza olanak tanır.
İzleme ve tanılama ile basit bir Windows VM dağıtma	Bu şablon, vm için izlemeyi ve tanılamayı etkinleştiren tanılama uzantısıyla birlikte basit bir Windows VM dağıtmanızı sağlar
Ubuntu VM'ye Mongo DB yüklemek için betik uzantılarını kullanma	Bu şablon, Bir Ubuntu Sanal Makinesinde Mongo DB'yi Yapılandırıp Yükler'i iki ayrı betikte dağıtır. Bu şablon, aynı sanal makinede çalışan iki betik arasındaki bağımlılıkların nasıl ifade edildiğine ilişkin iyi bir örnektir. Bu şablon ayrıca bir Depolama Hesabı, Sanal Ağ, Genel IP adresleri ve ağ arabirimi dağıtır.

ARM şablonu kaynak tanımı

virtualMachines/extensions kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

• Kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.Compute/virtualMachines/extensions kaynağı oluşturmak için şablonunuza aşağıdaki JSON'u ekleyin.

{
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "apiVersion": "2020-12-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": {},
    "publisher": "string",
    "settings": {},
    "type": "string",
    "typeHandlerVersion": "string"
  }
}

Özellik değerleri

virtualMachines/extensions

Ad	Açıklama	Değer
tür	Kaynak türü	'Microsoft.Compute/virtualMachines/extensions'
apiVersion	Kaynak API'sinin sürümü	'2020-12-01'
name	Kaynak adı JSON ARM şablonlarında alt kaynaklar için adları ve türleri ayarlamayı öğrenin.	dize (gerekli)
location	Kaynak konumu	dize (gerekli)
etiketler	Kaynak etiketleri	Etiket adlarının ve değerlerinin sözlüğü. Bkz. Şablonlardaki etiketler
properties	Bir Sanal Makine Uzantısının özelliklerini açıklar.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Ad	Açıklama	Değer
autoUpgradeMinorVersion	Dağıtım zamanında kullanılabilirse uzantının daha yeni bir ikincil sürüm kullanıp kullanmayacağını gösterir. Ancak dağıtıldıktan sonra, bu özellik true olarak ayarlanmış olsa bile uzantı yeniden dağıtılmadığı sürece ikincil sürümleri yükseltmez.	bool
enableAutomaticUpgrade	Kullanılabilir uzantının daha yeni bir sürümü varsa, uzantının platform tarafından otomatik olarak yükseltilip yükseltilmeyeceğini gösterir.	bool
forceUpdateTag	Uzantı yapılandırması değişmese bile uzantı işleyicisinin nasıl güncelleştirilmeye zorlanması gerektiği.	string
ınstanceview	Sanal makine uzantısı örneği görünümü.	VirtualMachineExtensionInstanceView
protectedSettings	Uzantı protectedSettings veya protectedSettingsFromKeyVault içerebilir veya hiçbir korumalı ayar içeremez.
yayımcı	Uzantı işleyici yayımcısının adı.	string
ayarlar	Uzantı için Json biçimlendirilmiş genel ayarlar.
tür	Uzantının türünü belirtir; "CustomScriptExtension" örnek olarak verilmiştir.	string
typeHandlerVersion	Betik işleyicisinin sürümünü belirtir.	string

VirtualMachineExtensionInstanceView

Ad	Açıklama	Değer
name	Sanal makine uzantısı adı.	string
Durum	Kaynak durumu bilgileri.	InstanceViewStatus[]
alt yordamlar	Kaynak durumu bilgileri.	InstanceViewStatus[]
tür	Uzantının türünü belirtir; "CustomScriptExtension" örnek olarak verilmiştir.	string
typeHandlerVersion	Betik işleyicisinin sürümünü belirtir.	string

InstanceViewStatus

Ad	Açıklama	Değer
kod	Durum kodu.	string
displayStatus	Durum için kısa yerelleştirilebilir etiket.	string
düzey	Düzey kodu.	'Hata' 'Bilgi' 'Uyarı'
message	Uyarılar ve hata iletileri de dahil olmak üzere ayrıntılı durum iletisi.	string
time	Durum zamanı.	string

Hızlı başlangıç şablonları

Aşağıdaki hızlı başlangıç şablonları bu kaynak türünü dağıtır.

Şablon	Description
Kötü Amaçlı Yazılımdan Koruma uzantısı etkinleştirilmiş bir Windows VM oluşturma	Bu şablon bir Windows VM oluşturur ve Kötü Amaçlı Yazılımdan Koruma'nın kurulumunu sağlar
Windows VM'de DSC uzantısını kullanan IIS Sunucusu	Bu şablon bir Windows VM oluşturur ve DSC uzantısını kullanarak bir IIS sunucusu ayarlar. Azure Depolama kullanıyorsanız DSC yapılandırma modülünün bir SAS belirtecinin geçirilmesi gerektiğini unutmayın. GitHub'dan DSC modülü bağlantısı için (bu şablonda varsayılan olarak) bu gerekli değildir.
ESET VM Uzantısı	ESET uzantısına sahip bir VM oluşturur
Windows VM'de McAfee Endpoint Security (deneme lisansı)	Bu şablon bir Windows VM oluşturur ve McAfee Endpoint Security'nin deneme sürümünü ayarlar
OMS uzantısıyla Ubuntu VM dağıtma	Bu şablon, OMS uzantısı yüklü ve belirtilen çalışma alanına eklenmiş bir Ubuntu VM dağıtmanızı sağlar
OMS uzantısına sahip bir Windows VM dağıtma	Bu şablon, OMS uzantısı yüklü ve belirtilen çalışma alanına eklenmiş bir Windows VM dağıtmanızı sağlar
Windows VM'de Symantec Endpoint Protection uzantısı deneme sürümü	Bu şablon bir Windows VM oluşturur ve Symantec Endpoint Protection'ın deneme sürümünü ayarlar
Ubuntu VM'sinde Özel Betik uzantısı	Bu şablon bir Ubuntu VM oluşturur ve CustomScript uzantısını yükler
Ubuntu VM'sinde işletim sistemi düzeltme eki uygulama uzantısı	Bu şablon bir Ubuntu VM oluşturur ve OSPatching uzantısını yükler
Tanılama ile Premium Windows VM dağıtma	Bu şablon, En son düzeltme eki uygulanmış sürümü kullanarak Windows sürümü için birkaç farklı seçenek kullanarak Premium Windows VM dağıtmanıza olanak tanır.
İzleme ve tanılama ile basit bir Windows VM dağıtma	Bu şablon, vm için izlemeyi ve tanılamayı etkinleştiren tanılama uzantısıyla birlikte basit bir Windows VM dağıtmanızı sağlar
Ubuntu VM'ye Mongo DB yüklemek için betik uzantılarını kullanma	Bu şablon, Bir Ubuntu Sanal Makinesinde Mongo DB'yi Yapılandırıp Yükler'i iki ayrı betikte dağıtır. Bu şablon, aynı sanal makinede çalışan iki betik arasındaki bağımlılıkların nasıl ifade edildiğine ilişkin iyi bir örnektir. Bu şablon ayrıca bir Depolama Hesabı, Sanal Ağ, Genel IP adresleri ve ağ arabirimi dağıtır.

Terraform (AzAPI sağlayıcısı) kaynak tanımı

virtualMachines/extensions kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

• Kaynak grupları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.Compute/virtualMachines/extensions kaynağı oluşturmak için şablonunuza aşağıdaki Terraform'u ekleyin.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachines/extensions@2020-12-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"
      }
      publisher = "string"
      type = "string"
      typeHandlerVersion = "string"
    }
  })
}

Özellik değerleri

virtualMachines/extensions

Ad	Açıklama	Değer
tür	Kaynak türü	"Microsoft.Compute/virtualMachines/extensions@2020-12-01"
name	Kaynak adı	dize (gerekli)
location	Kaynak konumu	dize (gerekli)
parent_id	Bu kaynağın üst öğesi olan kaynağın kimliği.	Kaynak türü: virtualMachines kimliği
etiketler	Kaynak etiketleri	Etiket adlarının ve değerlerinin sözlüğü.
properties	Bir Sanal Makine Uzantısının özelliklerini açıklar.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Ad	Açıklama	Değer
autoUpgradeMinorVersion	Dağıtım zamanında kullanılabilirse uzantının daha yeni bir ikincil sürüm kullanıp kullanmayacağını gösterir. Ancak dağıtıldıktan sonra uzantı, bu özellik true olarak ayarlanmış olsa bile yeniden dağıtılmadığı sürece ikincil sürümleri yükseltmez.	bool
enableAutomaticUpgrade	Kullanılabilir uzantının daha yeni bir sürümü varsa, uzantının platform tarafından otomatik olarak yükseltilip yükseltilmeyeceğini gösterir.	bool
forceUpdateTag	Uzantı yapılandırması değişmese bile uzantı işleyicisinin nasıl güncelleştirilmeye zorlanması gerektiği.	string
ınstanceview	Sanal makine uzantısı örneği görünümü.	VirtualMachineExtensionInstanceView
protectedSettings	Uzantı protectedSettings veya protectedSettingsFromKeyVault içerebilir veya hiç korumalı ayar içeremez.
yayımcı	Uzantı işleyici yayımcısının adı.	string
ayarlar	Uzantı için Json biçimli genel ayarlar.
tür	Uzantının türünü belirtir; "CustomScriptExtension" örnek olarak verilmiştir.	string
typeHandlerVersion	Betik işleyicisinin sürümünü belirtir.	string

VirtualMachineExtensionInstanceView

Ad	Açıklama	Değer
name	Sanal makine uzantısı adı.	string
Durum	Kaynak durumu bilgileri.	InstanceViewStatus[]
altstatuses	Kaynak durumu bilgileri.	InstanceViewStatus[]
tür	Uzantının türünü belirtir; "CustomScriptExtension" örnek olarak verilmiştir.	string
typeHandlerVersion	Betik işleyicisinin sürümünü belirtir.	string

InstanceViewStatus

Ad	Açıklama	Değer
kod	Durum kodu.	string
displayStatus	Durum için kısa yerelleştirilebilir etiket.	string
düzey	Düzey kodu.	"Hata" "Bilgi" "Uyarı"
message	Uyarılar ve hata iletileri de dahil olmak üzere ayrıntılı durum iletisi.	string
time	Durum zamanı.	string