Microsoft.Compute/virtualMachineScaleSets/extensions - Bicep, ARM template & Terraform AzAPI reference

Bicep-resourcedefinitie

Het resourcetype virtualMachineScaleSets/extensions kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Resourcegroepen - Zie opdrachten voor de implementatie van resourcegroepen

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource Microsoft.Compute/virtualMachineScaleSets/extensions wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets/extensions@2024-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'
  }
}

Eigenschapswaarden

virtualMachineScaleSets/extensions

Naam	Beschrijving	Waarde
naam	De resourcenaam Zie hoe u namen en typen instelt voor onderliggende resources in Bicep-.	tekenreeks (vereist)
ouder	In Bicep kunt u de bovenliggende resource voor een onderliggende resource opgeven. U hoeft deze eigenschap alleen toe te voegen wanneer de onderliggende resource buiten de bovenliggende resource wordt gedeclareerd. Zie onderliggende resource buiten de bovenliggende resourcevoor meer informatie.	Symbolische naam voor resource van het type: virtualMachineScaleSets
Eigenschappen	Beschrijft de eigenschappen van een virtuele-machineschaalsetextensie.	VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

Naam	Beschrijving	Waarde
autoUpgradeMinorVersion	Geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als deze beschikbaar is tijdens de implementatie. Zodra de extensie eenmaal is geïmplementeerd, worden er echter geen secundaire versies bijgewerkt, tenzij deze opnieuw wordt geïmplementeerd, zelfs niet als deze eigenschap is ingesteld op true.	Bool
enableAutomaticUpgrade	Geeft aan of de extensie automatisch moet worden bijgewerkt door het platform als er een nieuwere versie van de extensie beschikbaar is.	Bool
forceUpdateTag	Als er een waarde wordt opgegeven en verschilt van de vorige waarde, wordt de extensiehandler gedwongen om bij te werken, zelfs als de extensieconfiguratie niet is gewijzigd.	snaar
protectedSettings	De extensie kan protectedSettings of protectedSettingsFromKeyVault of helemaal geen beveiligde instellingen bevatten.	Voor Bicep kunt u de functie any() gebruiken.
protectedSettingsFromKeyVault	De met extensies beveiligde instellingen die doorverwijzing worden doorgegeven en die worden gebruikt vanuit de sleutelkluis	KeyVaultSecretReference
provisionAfterExtensions	Verzameling extensienamen waarna deze extensie moet worden ingericht.	tekenreeks[]
uitgever	De naam van de uitgever van de extensie-handler.	snaar
Instellingen	In Json opgemaakte openbare instellingen voor de extensie.	Voor Bicep kunt u de functie any() gebruiken.
suppressFailures	Geeft aan of fouten die voortvloeien uit de extensie worden onderdrukt (operationele fouten, zoals het niet verbinden met de VIRTUELE machine, worden niet onderdrukt, ongeacht deze waarde). De standaardwaarde is onwaar.	Bool
type	Hiermee geeft u het type van de extensie; een voorbeeld is CustomScriptExtension.	snaar
typeHandlerVersion	Hiermee geeft u de versie van de scripthandler.	snaar

KeyVaultSecretReference

Naam	Beschrijving	Waarde
secretUrl	De URL die verwijst naar een geheim in een Sleutelkluis.	tekenreeks (vereist)
sourceVault	De relatieve URL van de sleutelkluis die het geheim bevat.	SubResource (vereist)

SubResource

Naam	Beschrijving	Waarde
legitimatiebewijs	Resource-id	snaar

Quickstart-sjablonen

Met de volgende quickstart-sjablonen wordt dit resourcetype geïmplementeerd.

Sjabloon	Beschrijving
Darktrace Autoscaling vSensors implementeren	Met deze sjabloon kunt u een automatisch schalende implementatie van Darktrace vSensors implementeren
Deze sjabloon ontsleutelt eerder versleutelde Windows VMSS-	Met deze sjabloon wordt versleuteling uitgeschakeld voor een actieve Windows-VM-schaalset
Deze sjabloon versleutelt een actieve Windows VMSS-	Met deze sjabloon wordt versleuteling ingeschakeld voor een actieve Windows-VM-schaalset
een nieuwe Windows-VMSS maken en versleutelen met jumpbox-	Met deze sjabloon kunt u een eenvoudige VM-schaalset van Windows-VM's implementeren met behulp van de laatst gepatchte versie van serverversies van Windows. Met deze sjabloon wordt ook een jumpbox met een openbaar IP-adres in hetzelfde virtuele netwerk geïmplementeerd. U kunt verbinding maken met de jumpbox via dit openbare IP-adres en vervolgens verbinding maken met VM's in de schaalset via privé-IP-adressen. Met deze sjabloon schakelt u versleuteling in op de VM-schaalset van Windows-VM's.
Een vertrouwde start-compatibele Windows-VM-schaalset implementeren	Met deze sjabloon kunt u een vm-schaalset met vertrouwde startfuncties voor Virtuele Windows-machines implementeren met behulp van de nieuwste patchversie van Windows Server 2016, Windows Server 2019 of Windows Server 2022 Azure Edition. Deze VM's bevinden zich achter een load balancer met NAT-regels voor RDP-verbindingen. Als u Secureboot en vTPM inschakelt, wordt de extensie Guest Attestation geïnstalleerd op uw VMSS. Met deze extensie worden externe attestation- uitgevoerd door de cloud.

Resourcedefinitie van ARM-sjabloon

Het resourcetype virtualMachineScaleSets/extensions kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Resourcegroepen - Zie opdrachten voor de implementatie van resourcegroepen

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een resource voor Microsoft.Compute/virtualMachineScaleSets/extensions wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

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

Eigenschapswaarden

virtualMachineScaleSets/extensions

Naam	Beschrijving	Waarde
type	Het resourcetype	'Microsoft.Compute/virtualMachineScaleSets/extensions'
apiVersion	De versie van de resource-API	'2024-07-01'
naam	De resourcenaam Zie hoe u namen en typen instelt voor onderliggende resources in JSON ARM-sjablonen.	tekenreeks (vereist)
Eigenschappen	Beschrijft de eigenschappen van een virtuele-machineschaalsetextensie.	VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

Naam	Beschrijving	Waarde
autoUpgradeMinorVersion	Geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als deze beschikbaar is tijdens de implementatie. Zodra de extensie eenmaal is geïmplementeerd, worden er echter geen secundaire versies bijgewerkt, tenzij deze opnieuw wordt geïmplementeerd, zelfs niet als deze eigenschap is ingesteld op true.	Bool
enableAutomaticUpgrade	Geeft aan of de extensie automatisch moet worden bijgewerkt door het platform als er een nieuwere versie van de extensie beschikbaar is.	Bool
forceUpdateTag	Als er een waarde wordt opgegeven en verschilt van de vorige waarde, wordt de extensiehandler gedwongen om bij te werken, zelfs als de extensieconfiguratie niet is gewijzigd.	snaar
protectedSettings	De extensie kan protectedSettings of protectedSettingsFromKeyVault of helemaal geen beveiligde instellingen bevatten.
protectedSettingsFromKeyVault	De met extensies beveiligde instellingen die doorverwijzing worden doorgegeven en die worden gebruikt vanuit de sleutelkluis	KeyVaultSecretReference
provisionAfterExtensions	Verzameling extensienamen waarna deze extensie moet worden ingericht.	tekenreeks[]
uitgever	De naam van de uitgever van de extensie-handler.	snaar
Instellingen	In Json opgemaakte openbare instellingen voor de extensie.
suppressFailures	Geeft aan of fouten die voortvloeien uit de extensie worden onderdrukt (operationele fouten, zoals het niet verbinden met de VIRTUELE machine, worden niet onderdrukt, ongeacht deze waarde). De standaardwaarde is onwaar.	Bool
type	Hiermee geeft u het type van de extensie; een voorbeeld is CustomScriptExtension.	snaar
typeHandlerVersion	Hiermee geeft u de versie van de scripthandler.	snaar

KeyVaultSecretReference

Naam	Beschrijving	Waarde
secretUrl	De URL die verwijst naar een geheim in een Sleutelkluis.	tekenreeks (vereist)
sourceVault	De relatieve URL van de sleutelkluis die het geheim bevat.	SubResource (vereist)

SubResource

Naam	Beschrijving	Waarde
legitimatiebewijs	Resource-id	snaar

Quickstart-sjablonen

Met de volgende quickstart-sjablonen wordt dit resourcetype geïmplementeerd.

Sjabloon	Beschrijving
Darktrace Autoscaling vSensors implementeren	Met deze sjabloon kunt u een automatisch schalende implementatie van Darktrace vSensors implementeren
Deze sjabloon ontsleutelt eerder versleutelde Windows VMSS-	Met deze sjabloon wordt versleuteling uitgeschakeld voor een actieve Windows-VM-schaalset
Deze sjabloon versleutelt een actieve Windows VMSS-	Met deze sjabloon wordt versleuteling ingeschakeld voor een actieve Windows-VM-schaalset
een nieuwe Windows-VMSS maken en versleutelen met jumpbox-	Met deze sjabloon kunt u een eenvoudige VM-schaalset van Windows-VM's implementeren met behulp van de laatst gepatchte versie van serverversies van Windows. Met deze sjabloon wordt ook een jumpbox met een openbaar IP-adres in hetzelfde virtuele netwerk geïmplementeerd. U kunt verbinding maken met de jumpbox via dit openbare IP-adres en vervolgens verbinding maken met VM's in de schaalset via privé-IP-adressen. Met deze sjabloon schakelt u versleuteling in op de VM-schaalset van Windows-VM's.
Een vertrouwde start-compatibele Windows-VM-schaalset implementeren	Met deze sjabloon kunt u een vm-schaalset met vertrouwde startfuncties voor Virtuele Windows-machines implementeren met behulp van de nieuwste patchversie van Windows Server 2016, Windows Server 2019 of Windows Server 2022 Azure Edition. Deze VM's bevinden zich achter een load balancer met NAT-regels voor RDP-verbindingen. Als u Secureboot en vTPM inschakelt, wordt de extensie Guest Attestation geïnstalleerd op uw VMSS. Met deze extensie worden externe attestation- uitgevoerd door de cloud.

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype virtualMachineScaleSets/extensions kan worden geïmplementeerd met bewerkingen die zijn gericht op:

resourcegroepen

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een resource voor Microsoft.Compute/virtualMachineScaleSets/extensions wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets/extensions@2024-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"
    }
  })
}

Eigenschapswaarden

virtualMachineScaleSets/extensions

Naam	Beschrijving	Waarde
type	Het resourcetype	"Microsoft.Compute/virtualMachineScaleSets/extensions@2024-07-01"
naam	De resourcenaam	tekenreeks (vereist)
parent_id	De id van de resource die het bovenliggende item voor deze resource is.	Id voor resource van het type: virtualMachineScaleSets
Eigenschappen	Beschrijft de eigenschappen van een virtuele-machineschaalsetextensie.	VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

Naam	Beschrijving	Waarde
autoUpgradeMinorVersion	Geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als deze beschikbaar is tijdens de implementatie. Zodra de extensie eenmaal is geïmplementeerd, worden er echter geen secundaire versies bijgewerkt, tenzij deze opnieuw wordt geïmplementeerd, zelfs niet als deze eigenschap is ingesteld op true.	Bool
enableAutomaticUpgrade	Geeft aan of de extensie automatisch moet worden bijgewerkt door het platform als er een nieuwere versie van de extensie beschikbaar is.	Bool
forceUpdateTag	Als er een waarde wordt opgegeven en verschilt van de vorige waarde, wordt de extensiehandler gedwongen om bij te werken, zelfs als de extensieconfiguratie niet is gewijzigd.	snaar
protectedSettings	De extensie kan protectedSettings of protectedSettingsFromKeyVault of helemaal geen beveiligde instellingen bevatten.
protectedSettingsFromKeyVault	De met extensies beveiligde instellingen die doorverwijzing worden doorgegeven en die worden gebruikt vanuit de sleutelkluis	KeyVaultSecretReference
provisionAfterExtensions	Verzameling extensienamen waarna deze extensie moet worden ingericht.	tekenreeks[]
uitgever	De naam van de uitgever van de extensie-handler.	snaar
Instellingen	In Json opgemaakte openbare instellingen voor de extensie.
suppressFailures	Geeft aan of fouten die voortvloeien uit de extensie worden onderdrukt (operationele fouten, zoals het niet verbinden met de VIRTUELE machine, worden niet onderdrukt, ongeacht deze waarde). De standaardwaarde is onwaar.	Bool
type	Hiermee geeft u het type van de extensie; een voorbeeld is CustomScriptExtension.	snaar
typeHandlerVersion	Hiermee geeft u de versie van de scripthandler.	snaar

KeyVaultSecretReference

Naam	Beschrijving	Waarde
secretUrl	De URL die verwijst naar een geheim in een Sleutelkluis.	tekenreeks (vereist)
sourceVault	De relatieve URL van de sleutelkluis die het geheim bevat.	SubResource (vereist)

SubResource

Naam	Beschrijving	Waarde
legitimatiebewijs	Resource-id	snaar

Delen via

Microsoft.Compute virtualMachineScaleSets/extensions

Bicep-resourcedefinitie

Resource-indeling

Eigenschapswaarden

virtualMachineScaleSets/extensions

VirtualMachineScaleSetExtensionProperties

KeyVaultSecretReference

SubResource

Quickstart-sjablonen

Resourcedefinitie van ARM-sjabloon

Resource-indeling

Eigenschapswaarden

virtualMachineScaleSets/extensions

VirtualMachineScaleSetExtensionProperties

KeyVaultSecretReference

SubResource

Quickstart-sjablonen

Resourcedefinitie van Terraform (AzAPI-provider)

Resource-indeling

Eigenschapswaarden

virtualMachineScaleSets/extensions

VirtualMachineScaleSetExtensionProperties

KeyVaultSecretReference

SubResource

Feedback

Aanvullende resources