Dela via


Microsoft.Compute virtualMachineScaleSets/extensions 2023-07-01

Bicep-resursdefinition

Resurstypen virtualMachineScaleSets/extensions kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Compute/virtualMachineScaleSets/extensions-resurs lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets/extensions@2023-07-01' = {
  name: 'string'
  parent: resourceSymbolicName
  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'
  }
}

Egenskapsvärden

virtualMachineScaleSets/extensions

Name Beskrivning Värde
name Resursnamnet

Se hur du anger namn och typer för underordnade resurser i Bicep.
sträng (krävs)
parent I Bicep kan du ange den överordnade resursen för en underordnad resurs. Du behöver bara lägga till den här egenskapen när den underordnade resursen deklareras utanför den överordnade resursen.

Mer information finns i Underordnad resurs utanför överordnad resurs.
Symboliskt namn för resurs av typen: virtualMachineScaleSets
properties Beskriver egenskaperna för ett tillägg för vm-skalningsuppsättningar. VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

Name Beskrivning Värde
autoUpgradeMinorVersion Anger om tillägget ska använda en nyare delversion om en är tillgänglig vid distributionen. När tillägget har distribuerats uppgraderas dock inte mindre versioner om de inte distribueras om, även om den här egenskapen är inställd på true. boolesk
enableAutomaticUpgrade Anger om tillägget ska uppgraderas automatiskt av plattformen om det finns en nyare version av tillägget. boolesk
forceUpdateTag Om ett värde anges och skiljer sig från det tidigare värdet tvingas tilläggshanteraren att uppdatera även om tilläggskonfigurationen inte har ändrats. sträng
protectedSettings Tillägget kan innehålla antingen protectedSettings eller protectedSettingsFromKeyVault eller inga skyddade inställningar alls. För Bicep kan du använda funktionen any().
protectedSettingsFromKeyVault Tilläggsskyddade inställningar som skickas med referens och som används från nyckelvalvet KeyVaultSecretReference
provisionAfterExtensions Samling med tilläggsnamn varefter det här tillägget måste etableras. string[]
utgivare Namnet på tilläggshanterarutgivaren. sträng
inställningar Json-formaterade offentliga inställningar för tillägget. För Bicep kan du använda funktionen any().
suppressFailures Anger om fel som härrör från tillägget kommer att ignoreras (driftfel som att inte ansluta till den virtuella datorn ignoreras inte oavsett det här värdet). Standardvärdet är False. boolesk
typ Anger filnamnstilläggets typ. ett exempel är "CustomScriptExtension". sträng
typeHandlerVersion Anger skripthanterarens version. sträng

KeyVaultSecretReference

Name Beskrivning Värde
secretUrl URL:en som refererar till en hemlighet i en Key Vault. sträng (krävs)
sourceVault Den relativa URL:en för Key Vault som innehåller hemligheten. SubResource (krävs)

Underresurs

Name Beskrivning Värde
id Resurs-ID sträng

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall Description
Distribuera Darktrace Autoscaling vSensors

Distribuera till Azure
Med den här mallen kan du distribuera en automatisk skalningsdistribution av Darktrace vSensors
Den här mallen dekrypterar tidigare krypterade Windows VMSS

Distribuera till Azure
Den här mallen inaktiverar kryptering på en windows-VM-skalningsuppsättning som körs
Den här mallen krypterar en Windows VMSS som körs

Distribuera till Azure
Den här mallen aktiverar kryptering på en windows-VM-skalningsuppsättning som körs
Skapa och kryptera en ny Windows VMSS med jumpbox

Distribuera till Azure
Med den här mallen kan du distribuera en enkel VM-skalningsuppsättning med virtuella Windows-datorer med den senaste korrigerade versionen av serverbaserade Windows-versioner. Den här mallen distribuerar också en jumpbox med en offentlig IP-adress i samma virtuella nätverk. Du kan ansluta till jumpboxen via den här offentliga IP-adressen och sedan ansluta därifrån till virtuella datorer i skalningsuppsättningen via privata IP-adresser. Den här mallen aktiverar kryptering på VM-skalningsuppsättningen för virtuella Windows-datorer.
Distribuera en betrodd startkompatibel Skalningsuppsättning för virtuella Windows-datorer

Distribuera till Azure
Med den här mallen kan du distribuera en betrodd startkompatibel VM-skalningsuppsättning med virtuella Windows-datorer med den senaste korrigerade versionen av Windows Server 2016, Windows Server 2019 eller Windows Server 2022 Azure Edition. Dessa virtuella datorer ligger bakom en lastbalanserare med NAT-regler för RDP-anslutningar. Om du aktiverar Secureboot och vTPM installeras gästattesteringstillägget på din VMSS. Det här tillägget utför fjärrattestering av molnet.

Resursdefinition för ARM-mall

Resurstypen virtualMachineScaleSets/extensions kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Compute/virtualMachineScaleSets/extensions-resurs lägger du till följande JSON i mallen.

{
  "type": "Microsoft.Compute/virtualMachineScaleSets/extensions",
  "apiVersion": "2023-07-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"
  }
}

Egenskapsvärden

virtualMachineScaleSets/extensions

Name Beskrivning Värde
typ Resurstypen "Microsoft.Compute/virtualMachineScaleSets/extensions"
apiVersion Resurs-API-versionen '2023-07-01'
name Resursnamnet

Se hur du anger namn och typer för underordnade resurser i JSON ARM-mallar.
sträng (krävs)
properties Beskriver egenskaperna för ett vm-skalningsuppsättningstillägg. VirtualMachineScaleSetExtensionEgenskaper

VirtualMachineScaleSetExtensionEgenskaper

Name Beskrivning Värde
autoUpgradeMinorVersion Anger om tillägget ska använda en nyare delversion om en är tillgänglig vid distributionstillfället. När tillägget har distribuerats uppgraderas dock inte delversioner om de inte distribueras om, även med den här egenskapen inställd på true. boolesk
enableAutomaticUpgrade Anger om tillägget ska uppgraderas automatiskt av plattformen om det finns en nyare version av tillägget. boolesk
forceUpdateTag Om ett värde anges och skiljer sig från det tidigare värdet tvingas tilläggshanteraren att uppdatera även om tilläggskonfigurationen inte har ändrats. sträng
protectedSettings Tillägget kan innehålla antingen protectedSettings eller protectedSettingsFromKeyVault eller inga skyddade inställningar alls.
protectedSettingsFromKeyVault Tilläggsskyddade inställningar som skickas med referens och som används från nyckelvalvet KeyVaultSecretReference
provisionAfterExtensions Samling med tilläggsnamn varefter det här tillägget måste etableras. string[]
utgivare Namnet på tilläggshanterarens utgivare. sträng
inställningar Json har formaterat offentliga inställningar för tillägget.
suppressFailures Anger om fel som härrör från tillägget kommer att ignoreras (driftfel som att inte ansluta till den virtuella datorn ignoreras oavsett det här värdet). Standardvärdet är False. boolesk
typ Anger filnamnstilläggets typ. ett exempel är "CustomScriptExtension". sträng
typeHandlerVersion Anger versionen av skripthanteraren. sträng

KeyVaultSecretReference

Name Beskrivning Värde
secretUrl URL:en som refererar till en hemlighet i en Key Vault. sträng (krävs)
sourceVault Den relativa URL:en för Key Vault som innehåller hemligheten. SubResource (krävs)

SubResource

Name Beskrivning Värde
id Resurs-ID sträng

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall Description
Distribuera Darktrace Autoscaling vSensors

Distribuera till Azure
Med den här mallen kan du distribuera en automatisk skalningsdistribution av Darktrace vSensors
Den här mallen dekrypterar tidigare krypterade Windows VMSS

Distribuera till Azure
Den här mallen inaktiverar kryptering på en windows-VM-skalningsuppsättning som körs
Den här mallen krypterar en Windows VMSS som körs

Distribuera till Azure
Den här mallen aktiverar kryptering på en windows-VM-skalningsuppsättning som körs
Skapa och kryptera en ny Windows VMSS med jumpbox

Distribuera till Azure
Med den här mallen kan du distribuera en enkel VM-skalningsuppsättning med virtuella Windows-datorer med den senaste korrigerade versionen av serverbaserade Windows-versioner. Den här mallen distribuerar också en jumpbox med en offentlig IP-adress i samma virtuella nätverk. Du kan ansluta till jumpboxen via den här offentliga IP-adressen och sedan ansluta därifrån till virtuella datorer i skalningsuppsättningen via privata IP-adresser. Den här mallen aktiverar kryptering på VM-skalningsuppsättningen för virtuella Windows-datorer.
Distribuera en betrodd startkompatibel Skalningsuppsättning för virtuella Windows-datorer

Distribuera till Azure
Med den här mallen kan du distribuera en betrodd startkompatibel VM-skalningsuppsättning med virtuella Windows-datorer med den senaste korrigerade versionen av Windows Server 2016, Windows Server 2019 eller Windows Server 2022 Azure Edition. Dessa virtuella datorer ligger bakom en lastbalanserare med NAT-regler för RDP-anslutningar. Om du aktiverar Secureboot och vTPM installeras gästattesteringstillägget på din VMSS. Det här tillägget utför fjärrattestering av molnet.

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen virtualMachineScaleSets/extensions kan distribueras med åtgärder som mål:

  • Resursgrupper

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Compute/virtualMachineScaleSets/extensions-resurs lägger du till följande Terraform i mallen.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets/extensions@2023-07-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      autoUpgradeMinorVersion = bool
      enableAutomaticUpgrade = bool
      forceUpdateTag = "string"
      protectedSettingsFromKeyVault = {
        secretUrl = "string"
        sourceVault = {
          id = "string"
        }
      }
      provisionAfterExtensions = [
        "string"
      ]
      publisher = "string"
      suppressFailures = bool
      type = "string"
      typeHandlerVersion = "string"
    }
  })
}

Egenskapsvärden

virtualMachineScaleSets/extensions

Name Beskrivning Värde
typ Resurstypen "Microsoft.Compute/virtualMachineScaleSets/extensions@2023-07-01"
name Resursnamnet sträng (krävs)
parent_id ID:t för resursen som är överordnad för den här resursen. ID för resurs av typen: virtualMachineScaleSets
properties Beskriver egenskaperna för ett vm-skalningsuppsättningstillägg. VirtualMachineScaleSetExtensionEgenskaper

VirtualMachineScaleSetExtensionEgenskaper

Name Beskrivning Värde
autoUpgradeMinorVersion Anger om tillägget ska använda en nyare delversion om en är tillgänglig vid distributionstillfället. När tillägget har distribuerats uppgraderas dock inte delversioner om de inte distribueras om, även med den här egenskapen inställd på true. boolesk
enableAutomaticUpgrade Anger om tillägget ska uppgraderas automatiskt av plattformen om det finns en nyare version av tillägget. boolesk
forceUpdateTag Om ett värde anges och skiljer sig från det tidigare värdet tvingas tilläggshanteraren att uppdatera även om tilläggskonfigurationen inte har ändrats. sträng
protectedSettings Tillägget kan innehålla antingen protectedSettings eller protectedSettingsFromKeyVault eller inga skyddade inställningar alls.
protectedSettingsFromKeyVault Tilläggsskyddade inställningar som skickas med referens och som används från nyckelvalvet KeyVaultSecretReference
provisionAfterExtensions Samling med tilläggsnamn varefter det här tillägget måste etableras. string[]
utgivare Namnet på tilläggshanterarens utgivare. sträng
inställningar Json har formaterat offentliga inställningar för tillägget.
suppressFailures Anger om fel som härrör från tillägget kommer att ignoreras (driftfel som att inte ansluta till den virtuella datorn ignoreras oavsett det här värdet). Standardvärdet är False. boolesk
typ Anger filnamnstilläggets typ. ett exempel är "CustomScriptExtension". sträng
typeHandlerVersion Anger versionen av skripthanteraren. sträng

KeyVaultSecretReference

Name Beskrivning Värde
secretUrl URL:en som refererar till en hemlighet i en Key Vault. sträng (krävs)
sourceVault Den relativa URL:en för Key Vault som innehåller hemligheten. SubResource (krävs)

SubResource

Name Beskrivning Värde
id Resurs-ID sträng