Microsoft.Compute virtualMachines/extensions 2022-08-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@2022-08-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'
      }
    }
    publisher: 'string'
    settings: any()
    suppressFailures: bool
    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	string
etiketler	Kaynak etiketleri	Etiket adlarının ve değerlerinin sözlüğü. Bkz . Şablonlardaki etiketler
Üst	Bicep'te bir alt kaynağın üst kaynağını 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 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.	Bicep için any() işlevini kullanabilirsiniz.
protectedSettingsFromKeyVault	Başvuru tarafından geçirilen ve anahtar kasasından kullanılan korumalı uzantı ayarları	KeyVaultSecretReference
yayımcı	Uzantı işleyici yayımcısının adı.	string
ayarlar	Uzantı için Json biçimli genel ayarlar.	Bicep için any() işlevini kullanabilirsiniz.
suppressFailures	Uzantıdan kaynaklanan hataların gizlenip gizlenmeyeceğini gösterir (VM'ye bağlanmama gibi işlem hataları bu değerden bağımsız olarak gizlenmeyecektir). Varsayılan değer false.	bool
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

KeyVaultSecretReference

Ad	Açıklama	Değer
secretUrl	Key Vault gizli diziye başvuran URL.	dize (gerekli)
sourceVault	Gizli diziyi içeren Key Vault göreli URL'si.	SubResource (gerekli)

Subresource

Ad	Açıklama	Değer
kimlik	Kaynak Kimliği	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 korumasını ayarlar
Windows VM'de DSC uzantısı 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 eklenen bir Ubuntu VM dağıtmanıza olanak tanır
OMS uzantısına sahip bir Windows VM dağıtma	Bu şablon, OMS uzantısı yüklü ve belirtilen çalışma alanına eklenen 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 uygulanan sürümü kullanarak Windows sürümü için birkaç farklı seçenek kullanarak Premium Windows VM dağıtmanızı sağlar.
İ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": "2022-08-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"
      }
    },
    "publisher": "string",
    "settings": {},
    "suppressFailures": "bool",
    "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ü	'2022-08-01'
name	Kaynak adı Bkz. JSON ARM şablonlarında alt kaynaklar için adları ve türleri ayarlama.	dize (gerekli)
location	Kaynak konumu	string
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 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.
protectedSettingsFromKeyVault	Başvuru tarafından geçirilen ve anahtar kasasından kullanılan korumalı uzantı ayarları	KeyVaultSecretReference
yayımcı	Uzantı işleyici yayımcısının adı.	string
ayarlar	Uzantı için Json biçimli genel ayarlar.
suppressFailures	Uzantıdan kaynaklanan hataların gizlenip gizlenmeyeceğini gösterir (VM'ye bağlanmama gibi işlem hataları bu değerden bağımsız olarak gizlenmeyecektir). Varsayılan değer false.	bool
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

KeyVaultSecretReference

Ad	Açıklama	Değer
secretUrl	Key Vault gizli diziye başvuran URL.	dize (gerekli)
sourceVault	Gizli diziyi içeren Key Vault göreli URL'si.	SubResource (gerekli)

Subresource

Ad	Açıklama	Değer
kimlik	Kaynak Kimliği	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 korumasını ayarlar
Windows VM'de DSC uzantısı 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 eklenen bir Ubuntu VM dağıtmanıza olanak tanır
OMS uzantısına sahip bir Windows VM dağıtma	Bu şablon, OMS uzantısı yüklü ve belirtilen çalışma alanına eklenen 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 uygulanan sürümü kullanarak Windows sürümü için birkaç farklı seçenek kullanarak Premium Windows VM dağıtmanızı sağlar.
İ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@2022-08-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"
        }
      }
      publisher = "string"
      suppressFailures = bool
      type = "string"
      typeHandlerVersion = "string"
    }
  })
}

Özellik değerleri

virtualMachines/extensions

Ad	Açıklama	Değer
tür	Kaynak türü	"Microsoft.Compute/virtualMachines/extensions@2022-08-01"
name	Kaynak adı	dize (gerekli)
location	Kaynak konumu	string
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çbir korumalı ayar içeremez.
protectedSettingsFromKeyVault	Başvuru ile geçirilen ve anahtar kasasından kullanılan korumalı uzantı ayarları	KeyVaultSecretReference
yayımcı	Uzantı işleyici yayımcısının adı.	string
ayarlar	Uzantı için Json biçimlendirilmiş genel ayarlar.
suppressFailures	Uzantıdan kaynaklanan hataların gizlenip gizlenmeyeceğini gösterir (VM'ye bağlanmama gibi operasyonel hatalar bu değerden bağımsız olarak gizlenmeyecektir). Varsayılan değer false.	bool
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

KeyVaultSecretReference

Ad	Açıklama	Değer
secretUrl	Key Vault gizli diziye başvuran URL.	dize (gerekli)
sourceVault	Gizli diziyi içeren Key Vault göreli URL'si.	AltKaynak (gerekli)

Subresource

Ad	Açıklama	Değer
kimlik	Kaynak Kimliği	string