Microsoft.Compute virtualMachineScaleSets/extensions 2024-03-01

• en son
• 2024-11-01
• 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
• 2020-06-01
• 2019-12-01
• 2019-07-01
• 2019-03-01
• 2018-10-01
• 2018-06-01
• 2018-04-01
• 2017-12-01
• 2017-03-30

Bicep kaynak tanımı

virtualMachineScaleSets/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/virtualMachineScaleSets/extensions kaynağı oluşturmak için şablonunuza aşağıdaki Bicep'i ekleyin.

resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets/extensions@2024-03-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    autoUpgradeMinorVersion: bool
    enableAutomaticUpgrade: bool
    forceUpdateTag: 'string'
    protectedSettings: any(...)
    protectedSettingsFromKeyVault: {
      secretUrl: 'string'
      sourceVault: {
        id: 'string'
      }
    }
    provisionAfterExtensions: [
      'string'
    ]
    publisher: 'string'
    settings: any(...)
    suppressFailures: bool
    type: 'string'
    typeHandlerVersion: 'string'
  }
}

Özellik Değerleri

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)

Microsoft.Compute/virtualMachineScaleSets/extensions

Ad	Açıklama	Değer
ad	Kaynak adı	dize (gerekli)
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: virtualMachineScaleSets
Özellikler	Sanal Makine Ölçek Kümesi Uzantısının özelliklerini açıklar.	VirtualMachineScaleSetExtensionProperties

Alt Kaynak

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

VirtualMachineScaleSetExtensionProperties

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	Bir değer sağlanırsa ve önceki değerden farklıysa, uzantı yapılandırması değişmemiş olsa bile uzantı işleyicisi güncelleştirmeye zorlanır.	dizgi
protectedSettings	Uzantı protectedSettings veya protectedSettingsFromKeyVault içerebilir veya hiç korumalı ayar içeremez.	herhangi
protectedSettingsFromKeyVault	Uzantılar, başvuruyla geçirilen ve anahtar kasasından tüketilen korumalı ayarlar	KeyVaultSecretReference
provisionAfterExtensions	Bu uzantının sağlanması gereken uzantı adlarının koleksiyonu.	string[]
yayınevi	Uzantı işleyici yayımcısının adı.	dizgi
Ayarlar	Uzantı için Json tarafından biçimlendirilmiş genel ayarlar.	herhangi
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

Kullanım Örnekleri

Azure Hızlı Başlangıç Örnekleri

Aşağıdaki Azure Hızlı Başlangıç şablonları bu kaynak türünü dağıtmak için Bicep örnekleri içerir.

Bicep Dosyası

Açıklama

Güvenilen başlatma özellikli bir Windows VM Ölçek Kümesi dağıtma

Bu şablon, Windows Server 2016, Windows Server 2019 veya Windows Server 2022 Azure Edition'ın en son düzeltme eki uygulanmış sürümünü kullanarak güvenilir başlatma özellikli bir Windows VM Ölçek Kümesi dağıtmanızı sağlar. Bu VM'ler, RDP bağlantıları için NAT kuralları olan bir yük dengeleyicinin arkasındadır. Secureboot ve vTPM'yi etkinleştirirseniz, VMSS'nize Konuk Kanıtlama uzantısı yüklenir. Bu uzantı, bulut tarafından uzak kanıtlama gerçekleştirir.

ARM şablonu kaynak tanımı

virtualMachineScaleSets/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/virtualMachineScaleSets/extensions kaynağı oluşturmak için, şablonunuza aşağıdaki JSON'u ekleyin.

{
  "type": "Microsoft.Compute/virtualMachineScaleSets/extensions",
  "apiVersion": "2024-03-01",
  "name": "string",
  "properties": {
    "autoUpgradeMinorVersion": "bool",
    "enableAutomaticUpgrade": "bool",
    "forceUpdateTag": "string",
    "protectedSettings": {},
    "protectedSettingsFromKeyVault": {
      "secretUrl": "string",
      "sourceVault": {
        "id": "string"
      }
    },
    "provisionAfterExtensions": [ "string" ],
    "publisher": "string",
    "settings": {},
    "suppressFailures": "bool",
    "type": "string",
    "typeHandlerVersion": "string"
  }
}

Özellik Değerleri

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)

Microsoft.Compute/virtualMachineScaleSets/extensions

Ad	Açıklama	Değer
apiVersion	API sürümü	'2024-03-01'
ad	Kaynak adı	dize (gerekli)
Özellikler	Sanal Makine Ölçek Kümesi Uzantısının özelliklerini açıklar.	VirtualMachineScaleSetExtensionProperties
tür	Kaynak türü	'Microsoft.Compute/virtualMachineScaleSets/extensions'

Alt Kaynak

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

VirtualMachineScaleSetExtensionProperties

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	Bir değer sağlanırsa ve önceki değerden farklıysa, uzantı yapılandırması değişmemiş olsa bile uzantı işleyicisi güncelleştirmeye zorlanır.	dizgi
protectedSettings	Uzantı protectedSettings veya protectedSettingsFromKeyVault içerebilir veya hiç korumalı ayar içeremez.	herhangi
protectedSettingsFromKeyVault	Uzantılar, başvuruyla geçirilen ve anahtar kasasından tüketilen korumalı ayarlar	KeyVaultSecretReference
provisionAfterExtensions	Bu uzantının sağlanması gereken uzantı adlarının koleksiyonu.	string[]
yayınevi	Uzantı işleyici yayımcısının adı.	dizgi
Ayarlar	Uzantı için Json tarafından biçimlendirilmiş genel ayarlar.	herhangi
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

Kullanım Örnekleri

Azure Hızlı Başlangıç Şablonları

Aşağıdaki Azure Hızlı Başlangıç şablonları bu kaynak türünü dağıtmak.

Şablon	Açıklama
Sıçrama kutusu ile yeni bir Windows VMSS oluşturma ve şifreleme dağıtım	Bu şablon, sunucu Windows sürümlerinin en son düzeltme eki uygulanmış sürümünü kullanarak basit bir Windows VM Ölçek Kümesi dağıtmanıza olanak tanır. Bu şablon aynı sanal ağda genel IP adresine sahip bir sıçrama kutusu da dağıtır. Bu genel IP adresi aracılığıyla sıçrama kutusuna bağlanabilir, ardından buradan özel IP adresleri aracılığıyla ölçek kümesindeki VM'lere bağlanabilirsiniz. Bu şablon, Windows VM'lerinin VM Ölçek Kümesinde şifrelemeyi etkinleştirir.
Güvenilen başlatma özellikli bir Windows VM Ölçek Kümesi dağıtma dağıtım	Bu şablon, Windows Server 2016, Windows Server 2019 veya Windows Server 2022 Azure Edition'ın en son düzeltme eki uygulanmış sürümünü kullanarak güvenilir başlatma özellikli bir Windows VM Ölçek Kümesi dağıtmanızı sağlar. Bu VM'ler, RDP bağlantıları için NAT kuralları olan bir yük dengeleyicinin arkasındadır. Secureboot ve vTPM'yi etkinleştirirseniz, VMSS'nize Konuk Kanıtlama uzantısı yüklenir. Bu uzantı, bulut tarafından uzak kanıtlama gerçekleştirir.
Darktrace Otomatik Ölçeklendirme vSensors Dağıtma dağıtım	Bu şablon, Darktrace vSensors'ın otomatik olarak otomatik ölçeklendirme dağıtımını dağıtmanızı sağlar
Bu şablon daha önce şifrelenmiş Windows VMSS şifresini çözer dağıtım	Bu şablon, çalışan bir Windows VM Ölçek Kümesinde şifrelemeyi devre dışı bırakır
Bu şablon çalışan bir Windows VMSS şifreler dağıtım	Bu şablon, çalışan bir Windows VM Ölçek Kümesinde şifrelemeyi etkinleştirir

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

virtualMachineScaleSets/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/virtualMachineScaleSets/extensions kaynağı oluşturmak için şablonunuza aşağıdaki Terraform'u ekleyin.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets/extensions@2024-03-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      autoUpgradeMinorVersion = bool
      enableAutomaticUpgrade = bool
      forceUpdateTag = "string"
      protectedSettings = ?
      protectedSettingsFromKeyVault = {
        secretUrl = "string"
        sourceVault = {
          id = "string"
        }
      }
      provisionAfterExtensions = [
        "string"
      ]
      publisher = "string"
      settings = ?
      suppressFailures = bool
      type = "string"
      typeHandlerVersion = "string"
    }
  }
}

Özellik Değerleri

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)

Microsoft.Compute/virtualMachineScaleSets/extensions

Ad	Açıklama	Değer
ad	Kaynak adı	dize (gerekli)
parent_id	Bu kaynağın üst öğesi olan kaynağın kimliği.	Tür kaynağı kimliği: virtualMachineScaleSets
Özellikler	Sanal Makine Ölçek Kümesi Uzantısının özelliklerini açıklar.	VirtualMachineScaleSetExtensionProperties
tür	Kaynak türü	"Microsoft.Compute/virtualMachineScaleSets/extensions@2024-03-01"

Alt Kaynak

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

VirtualMachineScaleSetExtensionProperties

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	Bir değer sağlanırsa ve önceki değerden farklıysa, uzantı yapılandırması değişmemiş olsa bile uzantı işleyicisi güncelleştirmeye zorlanır.	dizgi
protectedSettings	Uzantı protectedSettings veya protectedSettingsFromKeyVault içerebilir veya hiç korumalı ayar içeremez.	herhangi
protectedSettingsFromKeyVault	Uzantılar, başvuruyla geçirilen ve anahtar kasasından tüketilen korumalı ayarlar	KeyVaultSecretReference
provisionAfterExtensions	Bu uzantının sağlanması gereken uzantı adlarının koleksiyonu.	string[]
yayınevi	Uzantı işleyici yayımcısının adı.	dizgi
Ayarlar	Uzantı için Json tarafından biçimlendirilmiş genel ayarlar.	herhangi
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