Microsoft.Compute virtualMachines/extensions

• Laatste
• 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-resourcedefinitie

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

• Resourcegroepen - Zie opdrachten voor resourcegroepimplementatie

Zie wijzigingenlogboek voor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

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

resource symbolicname 'Microsoft.Compute/virtualMachines/extensions@2023-09-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'
      }
    }
    provisionAfterExtensions: [
      'string'
    ]
    publisher: 'string'
    settings: any()
    suppressFailures: bool
    type: 'string'
    typeHandlerVersion: 'string'
  }
}

Eigenschapswaarden

virtualMachines/extensies

Naam	Description	Waarde
naam	De resourcenaam Meer informatie over het instellen van namen en typen voor onderliggende resources in Bicep.	tekenreeks (vereist)
location	Resourcelocatie	tekenreeks
tags	Resourcetags	Woordenlijst met tagnamen en -waarden. Tags in sjablonen bekijken
Bovenliggende	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 bovenliggende resource voor meer informatie.	Symbolische naam voor resource van het type: virtualMachines
properties	Beschrijft de eigenschappen van een virtuele-machine-extensie.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Naam	Description	Waarde
autoUpgradeMinorVersion	Geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als deze beschikbaar is tijdens de implementatie. Zodra de extensie is geïmplementeerd, worden secundaire versies echter niet bijgewerkt, tenzij opnieuw geïmplementeerd, zelfs als deze eigenschap is ingesteld op true.	booleaans
enableAutomaticUpgrade	Geeft aan of de extensie automatisch moet worden bijgewerkt door het platform als er een nieuwere versie van de extensie beschikbaar is.	booleaans
forceUpdateTag	Hoe de extensie-handler moet worden gedwongen bij te werken, zelfs als de extensieconfiguratie niet is gewijzigd.	tekenreeks
instanceView	De weergave van het exemplaar van de extensie van de virtuele machine.	VirtualMachineExtensionInstanceView
protectedSettings	De extensie kan protectedSettings of protectedSettingsFromKeyVault bevatten of helemaal geen beveiligde instellingen bevatten.	Voor Bicep kunt u de functie any() gebruiken.
protectedSettingsFromKeyVault	De met extensies beveiligde instellingen die worden doorgegeven via verwijzing en die worden gebruikt vanuit de sleutelkluis	KeyVaultSecretReference
provisionAfterExtensions	Verzameling extensienamen waarna deze extensie moet worden ingericht.	tekenreeks[]
publisher	De naam van de uitgever van de extensie-handler.	tekenreeks
instellingen	Met Json opgemaakte openbare instellingen voor de extensie.	Voor Bicep kunt u de functie any() gebruiken.
suppressFailures	Hiermee wordt aangegeven of fouten die het gevolg zijn van de extensie, worden onderdrukt (operationele fouten, zoals het niet maken van verbinding met de VM, worden niet onderdrukt, ongeacht deze waarde). De standaardwaarde is false.	booleaans
type	Hiermee geeft u het type van de extensie; Een voorbeeld is CustomScriptExtension.	tekenreeks
typeHandlerVersion	Hiermee geeft u de versie van de scripthandler op.	tekenreeks

VirtualMachineExtensionInstanceView

Naam	Description	Waarde
naam	De naam van de extensie van de virtuele machine.	tekenreeks
Statussen	De informatie over de resourcestatus.	InstanceViewStatus[]
substatussen	De informatie over de resourcestatus.	InstanceViewStatus[]
type	Hiermee geeft u het type van de extensie; Een voorbeeld is CustomScriptExtension.	tekenreeks
typeHandlerVersion	Hiermee geeft u de versie van de scripthandler op.	tekenreeks

InstanceViewStatus

Naam	Description	Waarde
code	De statuscode.	tekenreeks
displayStatus	Het korte lokaliseerbare label voor de status.	tekenreeks
niveau	De niveaucode.	'Fout' 'Info' 'Waarschuwing'
message	Het gedetailleerde statusbericht, inclusief voor waarschuwingen en foutberichten.	tekenreeks
tijd	De tijd van de status.	tekenreeks

KeyVaultSecretReference

Naam	Description	Waarde
secretUrl	De URL die verwijst naar een geheim in een Key Vault.	tekenreeks (vereist)
sourceVault	De relatieve URL van de Key Vault die het geheim bevat.	SubResource (vereist)

Subresource

Naam	Description	Waarde
id	Resource-id	tekenreeks

Snelstartsjablonen

Met de volgende snelstartsjablonen wordt dit resourcetype geïmplementeerd.

Template	Beschrijving
Een Windows-VM maken waarvoor de antimalware-extensie is ingeschakeld	Met deze sjabloon maakt u een Virtuele Windows-machine en stelt u de antimalwarebeveiliging in
IIS-server met dsc-extensie op een Windows-VM	Met deze sjabloon maakt u een Virtuele Windows-machine en stelt u een IIS-server in met behulp van de DSC-extensie. Opmerking: voor de DSC-configuratiemodule moet een SAS-token worden doorgegeven als u Azure Storage gebruikt. Voor dsc-modulekoppeling van GitHub (standaard in deze sjabloon) is dit niet nodig.
ESET VM-extensie	Hiermee maakt u een VM met DE ESET-extensie
McAfee Endpoint Security (proeflicentie) op Windows-VM	Met deze sjabloon maakt u een Windows-VM en stelt u een proefversie van McAfee Endpoint Security in
Een Ubuntu-VM implementeren met de OMS-extensie	Met deze sjabloon kunt u een Ubuntu-VM implementeren met de OMS-extensie geïnstalleerd en onboarding naar een opgegeven werkruimte
Een Windows-VM implementeren met de OMS-extensie	Met deze sjabloon kunt u een Windows-VM implementeren waarop de OMS-extensie is geïnstalleerd en onboarding naar een opgegeven werkruimte is uitgevoerd
Proefversie van Symantec Endpoint Protection-extensie op Windows-VM	Met deze sjabloon maakt u een Virtuele Windows-machine en stelt u een proefversie van Symantec Endpoint Protection in
Aangepaste scriptextensie op een Ubuntu-VM	Met deze sjabloon maakt u een Ubuntu-VM en installeert u de CustomScript-extensie
Patching-extensie voor het besturingssysteem op een Ubuntu-VM	Met deze sjabloon maakt u een Ubuntu-VM en installeert u de OSPatching-extensie
Een Premium Windows-VM implementeren met diagnostische gegevens	Met deze sjabloon kunt u een Premium Windows-VM implementeren met behulp van een aantal verschillende opties voor de Windows-versie, met behulp van de meest recente gepatchte versie.
Een eenvoudige Windows-VM implementeren met bewaking en diagnostische gegevens	Met deze sjabloon kunt u een eenvoudige Windows-VM implementeren, samen met de diagnostische extensie die bewaking en diagnose voor de VM mogelijk maakt
Scriptextensies gebruiken om Mongo DB te installeren op Ubuntu VM	Met deze sjabloon wordt Mongo DB op een virtuele Ubuntu-machine in twee afzonderlijke scripts geïmplementeerd en geïnstalleerd. Deze sjabloon is een goed voorbeeld dat laat zien hoe u afhankelijkheden kunt uitdrukken tussen twee scripts die op dezelfde virtuele machine worden uitgevoerd. Met deze sjabloon worden ook een opslagaccount, Virtual Network, openbare IP-adressen en een netwerkinterface geïmplementeerd.

Resourcedefinitie van ARM-sjabloon

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

• Resourcegroepen - Zie opdrachten voor resourcegroepimplementatie

Zie wijzigingenlogboek voor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

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

{
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "apiVersion": "2023-09-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"
      }
    },
    "provisionAfterExtensions": [ "string" ],
    "publisher": "string",
    "settings": {},
    "suppressFailures": "bool",
    "type": "string",
    "typeHandlerVersion": "string"
  }
}

Eigenschapswaarden

virtualMachines/extensies

Naam	Description	Waarde
type	Het resourcetype	'Microsoft.Compute/virtualMachines/extensions'
apiVersion	De resource-API-versie	'2023-09-01'
naam	De resourcenaam Meer informatie over het instellen van namen en typen voor onderliggende resources in JSON ARM-sjablonen.	tekenreeks (vereist)
location	Resourcelocatie	tekenreeks
tags	Resourcetags	Woordenlijst met tagnamen en -waarden. Tags in sjablonen bekijken
properties	Beschrijft de eigenschappen van een virtuele-machine-extensie.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Naam	Description	Waarde
autoUpgradeMinorVersion	Geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als deze beschikbaar is tijdens de implementatie. Zodra de extensie is geïmplementeerd, worden secundaire versies echter niet bijgewerkt, tenzij opnieuw geïmplementeerd, zelfs als deze eigenschap is ingesteld op true.	booleaans
enableAutomaticUpgrade	Geeft aan of de extensie automatisch moet worden bijgewerkt door het platform als er een nieuwere versie van de extensie beschikbaar is.	booleaans
forceUpdateTag	Hoe de extensie-handler moet worden gedwongen bij te werken, zelfs als de extensieconfiguratie niet is gewijzigd.	tekenreeks
instanceView	De weergave van het exemplaar van de extensie van de virtuele machine.	VirtualMachineExtensionInstanceView
protectedSettings	De extensie kan protectedSettings of protectedSettingsFromKeyVault bevatten of helemaal geen beveiligde instellingen bevatten.
protectedSettingsFromKeyVault	De met extensies beveiligde instellingen die worden doorgegeven via verwijzing en die worden gebruikt vanuit de sleutelkluis	KeyVaultSecretReference
provisionAfterExtensions	Verzameling extensienamen waarna deze extensie moet worden ingericht.	tekenreeks[]
publisher	De naam van de uitgever van de extensie-handler.	tekenreeks
instellingen	Met Json opgemaakte openbare instellingen voor de extensie.
suppressFailures	Hiermee wordt aangegeven of fouten die het gevolg zijn van de extensie, worden onderdrukt (operationele fouten, zoals het niet maken van verbinding met de VM, worden niet onderdrukt, ongeacht deze waarde). De standaardwaarde is false.	booleaans
type	Hiermee geeft u het type van de extensie; Een voorbeeld is CustomScriptExtension.	tekenreeks
typeHandlerVersion	Hiermee geeft u de versie van de scripthandler op.	tekenreeks

VirtualMachineExtensionInstanceView

Naam	Description	Waarde
naam	De naam van de extensie van de virtuele machine.	tekenreeks
Statussen	De informatie over de resourcestatus.	InstanceViewStatus[]
substatussen	De informatie over de resourcestatus.	InstanceViewStatus[]
type	Hiermee geeft u het type van de extensie; Een voorbeeld is CustomScriptExtension.	tekenreeks
typeHandlerVersion	Hiermee geeft u de versie van de scripthandler op.	tekenreeks

InstanceViewStatus

Naam	Description	Waarde
code	De statuscode.	tekenreeks
displayStatus	Het korte lokaliseerbare label voor de status.	tekenreeks
niveau	De niveaucode.	'Fout' 'Info' 'Waarschuwing'
message	Het gedetailleerde statusbericht, inclusief voor waarschuwingen en foutberichten.	tekenreeks
tijd	De tijd van de status.	tekenreeks

KeyVaultSecretReference

Naam	Description	Waarde
secretUrl	De URL die verwijst naar een geheim in een Key Vault.	tekenreeks (vereist)
sourceVault	De relatieve URL van de Key Vault die het geheim bevat.	SubResource (vereist)

SubResource

Naam	Description	Waarde
id	Resource-id	tekenreeks

Snelstartsjablonen

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

Template	Beschrijving
Een Windows-VM maken waarvoor de antimalware-extensie is ingeschakeld	Met deze sjabloon wordt een Virtuele Windows-machine gemaakt en wordt de antimalwarebeveiliging ingesteld
IIS-server met dsc-extensie op een Windows-VM	Met deze sjabloon maakt u een Virtuele Windows-machine en stelt u een IIS-server in met behulp van de DSC-extensie. Opmerking: voor de DSC-configuratiemodule moet een SAS-token worden doorgegeven als u Azure Storage gebruikt. Voor de koppeling van de DSC-module vanuit GitHub (standaard in deze sjabloon) is dit niet nodig.
ESET VM-extensie	Hiermee maakt u een VM met de ESET-extensie
McAfee Endpoint Security (proeflicentie) op Windows-VM	Met deze sjabloon wordt een Windows-VM gemaakt en wordt een evaluatieversie van McAfee Endpoint Security ingesteld
Een Ubuntu-VM implementeren met de OMS-extensie	Met deze sjabloon kunt u een Ubuntu-VM implementeren met de OMS-extensie geïnstalleerd en onboarding naar een opgegeven werkruimte
Een Windows-VM implementeren met de OMS-extensie	Met deze sjabloon kunt u een Windows-VM implementeren met de OMS-extensie geïnstalleerd en onboarding naar een opgegeven werkruimte
Proefversie van Symantec Endpoint Protection-extensie op Windows-VM	Met deze sjabloon wordt een Windows-VM gemaakt en wordt een evaluatieversie van Symantec Endpoint Protection ingesteld
Aangepaste scriptextensie op een Ubuntu-VM	Met deze sjabloon maakt u een Ubuntu-VM en installeert u de CustomScript-extensie
Extensie voor het patchen van het besturingssysteem op een Ubuntu-VM	Met deze sjabloon maakt u een Ubuntu-VM en installeert u de OSPatching-extensie
Een Premium Windows-VM implementeren met diagnostische gegevens	Met deze sjabloon kunt u een Premium Windows-VM implementeren met behulp van een aantal verschillende opties voor de Windows-versie, met behulp van de meest recente gepatchte versie.
Een eenvoudige Windows-VM implementeren met bewaking en diagnostische gegevens	Met deze sjabloon kunt u een eenvoudige Windows-VM implementeren, samen met de diagnostische extensie waarmee bewaking en diagnostische gegevens voor de VM mogelijk zijn
Scriptextensies gebruiken om Mongo DB te installeren op Ubuntu-VM	Met deze sjabloon wordt Mongo DB geconfigureerd en geïnstalleerd op een virtuele Ubuntu-machine in twee afzonderlijke scripts. Deze sjabloon is een goed voorbeeld waarin wordt getoond hoe u afhankelijkheden kunt uitdrukken tussen twee scripts die op dezelfde virtuele machine worden uitgevoerd. Met deze sjabloon worden ook een opslagaccount, Virtual Network, openbare IP-adressen en een netwerkinterface geïmplementeerd.

Resourcedefinitie van Terraform (AzAPI-provider)

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

• Resourcegroepen

Zie wijzigingenlogboek voor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachines/extensions@2023-09-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"
        }
      }
      provisionAfterExtensions = [
        "string"
      ]
      publisher = "string"
      suppressFailures = bool
      type = "string"
      typeHandlerVersion = "string"
    }
  })
}

Eigenschapswaarden

virtualMachines/extensies

Naam	Description	Waarde
type	Het resourcetype	"Microsoft.Compute/virtualMachines/extensions@2023-09-01"
naam	De resourcenaam	tekenreeks (vereist)
location	Resourcelocatie	tekenreeks
parent_id	De id van de resource die het bovenliggende item voor deze resource is.	Id voor resource van het type: virtualMachines
tags	Resourcetags	Woordenlijst met tagnamen en -waarden.
properties	Beschrijft de eigenschappen van een virtuele-machine-extensie.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Naam	Description	Waarde
autoUpgradeMinorVersion	Geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als deze beschikbaar is tijdens de implementatie. Zodra de extensie 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.	booleaans
enableAutomaticUpgrade	Geeft aan of de extensie automatisch moet worden bijgewerkt door het platform als er een nieuwere versie van de extensie beschikbaar is.	booleaans
forceUpdateTag	Hoe de extensie-handler moet worden gedwongen bij te werken, zelfs als de extensieconfiguratie niet is gewijzigd.	tekenreeks
instanceView	De weergave van het exemplaar van de extensie van de virtuele machine.	VirtualMachineExtensionInstanceView
protectedSettings	De extensie kan protectedSettings of protectedSettingsFromKeyVault bevatten of helemaal geen beveiligde instellingen bevatten.
protectedSettingsFromKeyVault	De met extensies beveiligde instellingen die worden doorgegeven via verwijzing en die worden gebruikt vanuit de sleutelkluis	KeyVaultSecretReference
provisionAfterExtensions	Verzameling extensienamen waarna deze extensie moet worden ingericht.	tekenreeks[]
publisher	De naam van de uitgever van de extensie-handler.	tekenreeks
instellingen	Met Json opgemaakte openbare instellingen voor de extensie.
suppressFailures	Hiermee wordt aangegeven of fouten die het gevolg zijn van de extensie, worden onderdrukt (operationele fouten, zoals het niet maken van verbinding met de VM, worden niet onderdrukt, ongeacht deze waarde). De standaardwaarde is false.	booleaans
type	Hiermee geeft u het type van de extensie; Een voorbeeld is CustomScriptExtension.	tekenreeks
typeHandlerVersion	Hiermee geeft u de versie van de scripthandler op.	tekenreeks

VirtualMachineExtensionInstanceView

Naam	Description	Waarde
naam	De naam van de extensie van de virtuele machine.	tekenreeks
Statussen	De informatie over de resourcestatus.	InstanceViewStatus[]
substatussen	De informatie over de resourcestatus.	InstanceViewStatus[]
type	Hiermee geeft u het type van de extensie; Een voorbeeld is CustomScriptExtension.	tekenreeks
typeHandlerVersion	Hiermee geeft u de versie van de scripthandler op.	tekenreeks

InstanceViewStatus

Naam	Description	Waarde
code	De statuscode.	tekenreeks
displayStatus	Het korte lokaliseerbare label voor de status.	tekenreeks
niveau	De niveaucode.	"Fout" "Info" "Waarschuwing"
message	Het gedetailleerde statusbericht, inclusief voor waarschuwingen en foutberichten.	tekenreeks
tijd	De tijd van de status.	tekenreeks

KeyVaultSecretReference

Naam	Description	Waarde
secretUrl	De URL die verwijst naar een geheim in een Key Vault.	tekenreeks (vereist)
sourceVault	De relatieve URL van de Key Vault die het geheim bevat.	SubResource (vereist)

Subresource

Naam	Description	Waarde
id	Resource-id	tekenreeks