Aracılığıyla paylaş

Microsoft.Compute virtualMachines/extensions 2022-03-01

  • Makale

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-03-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
ad Kaynak adı

Bicep'nde alt kaynaklar için adları ve türleri ayarlamayı öğrenin.		 dize (gerekli)
yer Kaynak konumu dizgi
Etiketler Kaynak etiketleri Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri
ebeveyn Bicep'te bir alt kaynak için üst kaynak belirtebilirsiniz. Bu özelliği yalnızca alt kaynak üst kaynağın dışında bildirildiğinde eklemeniz gerekir.

Daha fazla bilgi için bkz. Alt kaynaküst kaynak dışında.		 Kaynak türü için sembolik ad: virtualMachines
Özellikler Bir Sanal Makine Uzantısının özelliklerini açıklar. VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Ad Açıklama Değer
autoUpgradeMinorVersion Dağıtım zamanında kullanılabilir durumdaysa 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şmemiş olsa bile uzantı işleyicisinin nasıl güncelleştirilmeye zorlanması gerektiği. dizgi
instanceView 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 Uzantılar, başvuruyla geçirilen ve anahtar kasasından tüketilen korumalı ayarlar KeyVaultSecretReference
yayınevi Uzantı işleyici yayımcısının adı. dizgi
Ayarlar Uzantı için Json tarafından biçimlendirilmiş 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şlemsel hatalar bu değerden bağımsız olarak gizlenmeyecektir). Varsayılan değer false'tur. Bool
tür Uzantının türünü belirtir; "CustomScriptExtension" örnektir. dizgi
typeHandlerVersion Betik işleyicisinin sürümünü belirtir. dizgi

VirtualMachineExtensionInstanceView

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

InstanceViewStatus

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

KeyVaultSecretReference

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

Alt Kaynak

Ad Açıklama Değer
Kimliği Kaynak Kimliği dizgi

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

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

Şablon Açıklama
Kötü Amaçlı Yazılımdan Koruma uzantısı etkinleştirilmiş bir Windows VM oluşturma

Azure 'a dağıtma		 Bu şablon bir Windows VM oluşturur ve Kötü Amaçlı Yazılımdan Koruma'nı ayarlar
Windows VM üzerinde DSC uzantısını kullanarak IIS Sunucusunu

Azure 'a dağıtma		 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ı

Azure 'a dağıtma		 ESET uzantısına sahip bir VM oluşturur
Windows VM'de McAfee Endpoint Security (deneme lisansı)

Azure 'a dağıtma		 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

Azure 'a dağıtma		 Bu şablon, OMS uzantısı yüklü ve belirtilen bir çalışma alanına eklenen bir Ubuntu VM dağıtmanıza olanak tanır
OMS uzantısına sahip bir Windows VM dağıtma

Azure 'a dağıtma		 Bu şablon, OMS uzantısı yüklü ve belirtilen bir çalışma alanına eklenen bir Windows VM dağıtmanıza olanak tanır
Windows VM'de Symantec Endpoint Protection uzantısı deneme sürümünü

Azure 'a dağıtma		 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ını

Azure 'a dağıtma		 Bu şablon bir Ubuntu VM oluşturur ve CustomScript uzantısını yükler
Ubuntu VM işletim sistemi düzeltme eki uygulama uzantısı

Azure 'a dağıtma		 Bu şablon bir Ubuntu VM oluşturur ve OSPatching uzantısını yükler
Tanılama ile Premium Windows VM dağıtma

Azure 'a 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

Azure 'a dağıtma		 Bu şablon, vm için izleme ve tanılamaya olanak tanıyan tanılama uzantısıyla birlikte basit bir Windows VM dağıtmanızı sağlar
Mongo DB'yi Ubuntu VM yüklemek için betik uzantılarını kullanma

Azure 'a dağıtma		 Bu şablon, Bir Ubuntu Sanal Makinesine Mongo DB 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 bir 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 dosyasını ekleyin.

{
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "apiVersion": "2022-03-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-03-01'
ad Kaynak adı

JSON ARM şablonlarında alt kaynakların adlarını ve türlerini ayarlamayı öğrenin.		 dize (gerekli)
yer Kaynak konumu dizgi
Etiketler Kaynak etiketleri Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri
Özellikler Bir Sanal Makine Uzantısının özelliklerini açıklar. VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Ad Açıklama Değer
autoUpgradeMinorVersion Dağıtım zamanında kullanılabilir durumdaysa 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şmemiş olsa bile uzantı işleyicisinin nasıl güncelleştirilmeye zorlanması gerektiği. dizgi
instanceView 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 Uzantılar, başvuruyla geçirilen ve anahtar kasasından tüketilen korumalı ayarlar KeyVaultSecretReference
yayınevi Uzantı işleyici yayımcısının adı. dizgi
Ayarlar Uzantı için Json tarafından biçimlendirilmiş genel ayarlar.
suppressFailures Uzantıdan kaynaklanan hataların gizlenip gizlenmeyeceğini gösterir (VM'ye bağlanmama gibi işlemsel hatalar bu değerden bağımsız olarak gizlenmeyecektir). Varsayılan değer false'tur. Bool
tür Uzantının türünü belirtir; "CustomScriptExtension" örnektir. dizgi
typeHandlerVersion Betik işleyicisinin sürümünü belirtir. dizgi

VirtualMachineExtensionInstanceView

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

InstanceViewStatus

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

KeyVaultSecretReference

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

Alt Kaynak

Ad Açıklama Değer
Kimliği Kaynak Kimliği dizgi

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

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

Şablon Açıklama
Kötü Amaçlı Yazılımdan Koruma uzantısı etkinleştirilmiş bir Windows VM oluşturma

Azure 'a dağıtma		 Bu şablon bir Windows VM oluşturur ve Kötü Amaçlı Yazılımdan Koruma'nı ayarlar
Windows VM üzerinde DSC uzantısını kullanarak IIS Sunucusunu

Azure 'a dağıtma		 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ı

Azure 'a dağıtma		 ESET uzantısına sahip bir VM oluşturur
Windows VM'de McAfee Endpoint Security (deneme lisansı)

Azure 'a dağıtma		 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

Azure 'a dağıtma		 Bu şablon, OMS uzantısı yüklü ve belirtilen bir çalışma alanına eklenen bir Ubuntu VM dağıtmanıza olanak tanır
OMS uzantısına sahip bir Windows VM dağıtma

Azure 'a dağıtma		 Bu şablon, OMS uzantısı yüklü ve belirtilen bir çalışma alanına eklenen bir Windows VM dağıtmanıza olanak tanır
Windows VM'de Symantec Endpoint Protection uzantısı deneme sürümünü

Azure 'a dağıtma		 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ını

Azure 'a dağıtma		 Bu şablon bir Ubuntu VM oluşturur ve CustomScript uzantısını yükler
Ubuntu VM işletim sistemi düzeltme eki uygulama uzantısı

Azure 'a dağıtma		 Bu şablon bir Ubuntu VM oluşturur ve OSPatching uzantısını yükler
Tanılama ile Premium Windows VM dağıtma

Azure 'a 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

Azure 'a dağıtma		 Bu şablon, vm için izleme ve tanılamaya olanak tanıyan tanılama uzantısıyla birlikte basit bir Windows VM dağıtmanızı sağlar
Mongo DB'yi Ubuntu VM yüklemek için betik uzantılarını kullanma

Azure 'a dağıtma		 Bu şablon, Bir Ubuntu Sanal Makinesine Mongo DB 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 bir 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-03-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-03-01"
ad Kaynak adı dize (gerekli)
yer Kaynak konumu dizgi
parent_id Bu kaynağın üst öğesi olan kaynağın kimliği. Tür kaynağı kimliği: virtualMachines
Etiketler Kaynak etiketleri Etiket adları ve değerleri sözlüğü.
Özellikler Bir Sanal Makine Uzantısının özelliklerini açıklar. VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Ad Açıklama Değer
autoUpgradeMinorVersion Dağıtım zamanında kullanılabilir durumdaysa 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şmemiş olsa bile uzantı işleyicisinin nasıl güncelleştirilmeye zorlanması gerektiği. dizgi
instanceView 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 Uzantılar, başvuruyla geçirilen ve anahtar kasasından tüketilen korumalı ayarlar KeyVaultSecretReference
yayınevi Uzantı işleyici yayımcısının adı. dizgi
Ayarlar Uzantı için Json tarafından biçimlendirilmiş genel ayarlar.
suppressFailures Uzantıdan kaynaklanan hataların gizlenip gizlenmeyeceğini gösterir (VM'ye bağlanmama gibi işlemsel hatalar bu değerden bağımsız olarak gizlenmeyecektir). Varsayılan değer false'tur. Bool
tür Uzantının türünü belirtir; "CustomScriptExtension" örnektir. dizgi
typeHandlerVersion Betik işleyicisinin sürümünü belirtir. dizgi

VirtualMachineExtensionInstanceView

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

InstanceViewStatus

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

KeyVaultSecretReference

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

Alt Kaynak

Ad Açıklama Değer
Kimliği Kaynak Kimliği dizgi