Microsoft.Compute virtualMachines/extensions 2022-03-01

• Senaste
• 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-resursdefinition

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

• Resursgrupper – Se kommandon för resursgruppsdistribution

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

Resursformat

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

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'
  }
}

Egenskapsvärden

virtualMachines/extensions

Name	Beskrivning	Värde
name	Resursnamnet Se hur du anger namn och typer för underordnade resurser i Bicep.	sträng (krävs)
location	Resursplats	sträng
tags	Resurstaggar	Ordlista med taggnamn och värden. Se Taggar i mallar
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: virtualMachines
properties	Beskriver egenskaperna för ett tillägg för virtuell dator.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

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	Hur tilläggshanteraren ska tvingas uppdatera även om tilläggskonfigurationen inte har ändrats.	sträng
instanceView	Vyn för tilläggsinstansen för virtuella datorer.	VirtualMachineExtensionInstanceView
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
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

VirtualMachineExtensionInstanceView

Name	Beskrivning	Värde
name	Namnet på det virtuella datortillägget.	sträng
Status	Resursstatusinformationen.	InstanceViewStatus[]
understatusar	Resursstatusinformationen.	InstanceViewStatus[]
typ	Anger filnamnstilläggets typ. ett exempel är "CustomScriptExtension".	sträng
typeHandlerVersion	Anger skripthanterarens version.	sträng

InstanceViewStatus

Name	Beskrivning	Värde
kod	Statuskoden.	sträng
displayStatus	Den korta localizable-etiketten för statusen.	sträng
nivå	Nivåkoden.	"Fel" "Info" "Varning"
meddelande	Det detaljerade statusmeddelandet, inklusive för aviseringar och felmeddelanden.	sträng
time	Tidpunkten för statusen.	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
Skapa en virtuell Windows-dator med tillägget För skydd mot skadlig kod aktiverat	Den här mallen skapar en virtuell Windows-dator och konfigurerar skydd mot skadlig kod
IIS-server med DSC-tillägg på en virtuell Windows-dator	Den här mallen skapar en virtuell Windows-dator och konfigurerar en IIS-server med DSC-tillägget. Observera att DSC-konfigurationsmodulen behöver en SAS-token för att skickas om du använder Azure Storage. För DSC-modullänk från GitHub (standard i den här mallen) behövs inte detta.
ESET VM-tillägg	Skapar en virtuell dator med ESET-tillägg
McAfee Endpoint Security (utvärderingslicens) på en virtuell Windows-dator	Den här mallen skapar en virtuell Windows-dator och konfigurerar en utvärderingsversion av McAfee Endpoint Security
Distribuera en virtuell Ubuntu-dator med OMS-tillägget	Med den här mallen kan du distribuera en virtuell Ubuntu-dator med OMS-tillägget installerat och registrerat på en angiven arbetsyta
Distribuera en virtuell Windows-dator med OMS-tillägget	Med den här mallen kan du distribuera en virtuell Windows-dator med OMS-tillägget installerat och registrerat på en angiven arbetsyta
Utvärderingsversion av Symantec Endpoint Protection-tillägget på en virtuell Windows-dator	Den här mallen skapar en virtuell Windows-dator och konfigurerar en utvärderingsversion av Symantec Endpoint Protection
Tillägg för anpassat skript på en virtuell Ubuntu-dator	Den här mallen skapar en virtuell Ubuntu-dator och installerar CustomScript-tillägget
Tillägg för os-korrigering på en virtuell Ubuntu-dator	Den här mallen skapar en virtuell Ubuntu-dator och installerar OSPatching-tillägget
Distribuera en virtuell Premium Windows-dator med diagnostik	Med den här mallen kan du distribuera en virtuell Premium Windows-dator med några olika alternativ för Windows-versionen med den senaste korrigerade versionen.
Distribuera en enkel virtuell Windows-dator med övervakning och diagnostik	Med den här mallen kan du distribuera en enkel virtuell Windows-dator tillsammans med diagnostiktillägget som möjliggör övervakning och diagnostik för den virtuella datorn
Använda skripttillägg för att installera Mongo DB på en virtuell Ubuntu-dator	Den här mallen distribuerar Konfigurerar och installerar Mongo DB på en virtuell Ubuntu-dator i två separata skript. Den här mallen är ett bra exempel som visar hur du uttrycker beroenden mellan två skript som körs på samma virtuella dator. Den här mallen distribuerar även ett lagringskonto, Virtual Network, offentliga IP-adresser och ett nätverksgränssnitt.

Resursdefinition för ARM-mall

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

• Resursgrupper – Se kommandon för resursgruppsdistribution

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

Resursformat

Om du vill skapa en Resurs för Microsoft.Compute/virtualMachines/extensions lägger du till följande JSON i mallen.

{
  "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"
  }
}

Egenskapsvärden

virtualMachines/extensions

Name	Beskrivning	Värde
typ	Resurstypen	"Microsoft.Compute/virtualMachines/extensions"
apiVersion	Resurs-API-versionen	'2022-03-01'
name	Resursnamnet Se hur du anger namn och typer för underordnade resurser i JSON ARM-mallar.	sträng (krävs)
location	Resursplats	sträng
tags	Resurstaggar	Ordlista med taggnamn och värden. Se Taggar i mallar
properties	Beskriver egenskaperna för ett tillägg för virtuell dator.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

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	Hur tilläggshanteraren ska tvingas uppdatera även om tilläggskonfigurationen inte har ändrats.	sträng
instanceView	Vyn för tilläggsinstansen för virtuella datorer.	VirtualMachineExtensionInstanceView
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
utgivare	Namnet på tilläggshanterarutgivaren.	sträng
inställningar	Json-formaterade 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 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

VirtualMachineExtensionInstanceView

Name	Beskrivning	Värde
name	Namnet på det virtuella datortillägget.	sträng
Status	Resursstatusinformationen.	InstanceViewStatus[]
understatusar	Resursstatusinformationen.	InstanceViewStatus[]
typ	Anger filnamnstilläggets typ. ett exempel är "CustomScriptExtension".	sträng
typeHandlerVersion	Anger skripthanterarens version.	sträng

InstanceViewStatus

Name	Beskrivning	Värde
kod	Statuskoden.	sträng
displayStatus	Den korta localizable-etiketten för statusen.	sträng
nivå	Nivåkoden.	"Fel" "Info" "Varning"
meddelande	Det detaljerade statusmeddelandet, inklusive för aviseringar och felmeddelanden.	sträng
time	Tidpunkten för statusen.	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
Skapa en virtuell Windows-dator med tillägget Skydd mot skadlig kod aktiverat	Den här mallen skapar en virtuell Windows-dator och konfigurerar skydd mot skadlig kod
IIS Server med DSC-tillägget på en virtuell Windows-dator	Den här mallen skapar en virtuell Windows-dator och konfigurerar en IIS-server med DSC-tillägget. Observera att DSC-konfigurationsmodulen behöver en SAS-token för att skickas om du använder Azure Storage. För DSC-modullänk från GitHub (standard i den här mallen) behövs inte detta.
ESET VM-tillägg	Skapar en virtuell dator med ESET-tillägg
McAfee Endpoint Security (utvärderingslicens) på en virtuell Windows-dator	Den här mallen skapar en virtuell Windows-dator och konfigurerar en utvärderingsversion av McAfee Endpoint Security
Distribuera en virtuell Ubuntu-dator med OMS-tillägget	Med den här mallen kan du distribuera en virtuell Ubuntu-dator med OMS-tillägget installerat och registrerat på en angiven arbetsyta
Distribuera en virtuell Windows-dator med OMS-tillägget	Med den här mallen kan du distribuera en virtuell Windows-dator med OMS-tillägget installerat och registrerat på en angiven arbetsyta
Utvärderingsversion av Symantec Endpoint Protection-tillägget på en virtuell Windows-dator	Den här mallen skapar en virtuell Windows-dator och konfigurerar en utvärderingsversion av Symantec Endpoint Protection
Tillägg för anpassat skript på en virtuell Ubuntu-dator	Den här mallen skapar en virtuell Ubuntu-dator och installerar CustomScript-tillägget
Tillägg för os-korrigering på en virtuell Ubuntu-dator	Den här mallen skapar en virtuell Ubuntu-dator och installerar OSPatching-tillägget
Distribuera en virtuell Premium Windows-dator med diagnostik	Med den här mallen kan du distribuera en virtuell Premium Windows-dator med några olika alternativ för Windows-versionen med den senaste korrigerade versionen.
Distribuera en enkel virtuell Windows-dator med övervakning och diagnostik	Med den här mallen kan du distribuera en enkel virtuell Windows-dator tillsammans med diagnostiktillägget som möjliggör övervakning och diagnostik för den virtuella datorn
Använda skripttillägg för att installera Mongo DB på en virtuell Ubuntu-dator	Den här mallen distribuerar Konfigurerar och installerar Mongo DB på en virtuell Ubuntu-dator i två separata skript. Den här mallen är ett bra exempel som visar hur du uttrycker beroenden mellan två skript som körs på samma virtuella dator. Den här mallen distribuerar också ett lagringskonto, Virtual Network, offentliga IP-adresser och ett nätverksgränssnitt.

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen virtualMachines/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/virtualMachines/extensions-resurs lägger du till följande Terraform i mallen.

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"
    }
  })
}

Egenskapsvärden

virtualMachines/extensions

Name	Beskrivning	Värde
typ	Resurstypen	"Microsoft.Compute/virtualMachines/extensions@2022-03-01"
name	Resursnamnet	sträng (krävs)
location	Resursplats	sträng
parent_id	ID:t för resursen som är överordnad för den här resursen.	ID för resurs av typen: virtualMachines
tags	Resurstaggar	Ordlista med taggnamn och värden.
properties	Beskriver egenskaperna för ett tillägg för virtuella datorer.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

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	Hur tilläggshanteraren ska tvingas uppdatera även om tilläggskonfigurationen inte har ändrats.	sträng
instanceView	Vyn för tilläggsinstansen för virtuella datorer.	VirtualMachineExtensionInstanceView
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
utgivare	Namnet på tilläggshanterarutgivaren.	sträng
inställningar	Json-formaterade 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 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

VirtualMachineExtensionInstanceView

Name	Beskrivning	Värde
name	Namnet på det virtuella datortillägget.	sträng
Status	Resursstatusinformationen.	InstanceViewStatus[]
understatusar	Resursstatusinformationen.	InstanceViewStatus[]
typ	Anger filnamnstilläggets typ. ett exempel är "CustomScriptExtension".	sträng
typeHandlerVersion	Anger skripthanterarens version.	sträng

InstanceViewStatus

Name	Beskrivning	Värde
kod	Statuskoden.	sträng
displayStatus	Den korta localizable-etiketten för statusen.	sträng
nivå	Nivåkoden.	"Fel" "Info" "Varning"
meddelande	Det detaljerade statusmeddelandet, inklusive för aviseringar och felmeddelanden.	sträng
time	Tidpunkten för statusen.	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