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

Bicep-erőforrásdefiníció

A virtualMachines/extensions erőforrástípus üzembe helyezhető olyan műveletekkel, amelyek a következő célokat célják:

Erőforráscsoportok – Lásd erőforráscsoport üzembe helyezési parancsaival

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.

Erőforrás formátuma

Microsoft.Compute/virtualMachines/extensions erőforrás létrehozásához adja hozzá a következő Bicep-et a sablonhoz.

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

Tulajdonságértékek

virtualMachines/extensions

Név	Leírás	Érték
név	Az erőforrás neve Megtudhatja, hogyan állíthat be neveket és típusokat a gyermekerőforrásokhoz Bicep.	sztring (kötelező)
hely	Erőforrás helye	húr
Címkék	Erőforráscímkék	Címkenevek és -értékek szótára. sablonok címkéinek megtekintése
szülő	A Bicepben megadhatja a gyermekerőforrás szülőerőforrását. Ezt a tulajdonságot csak akkor kell hozzáadnia, ha a gyermekerőforrás a szülőerőforráson kívül van deklarálva. További információ: szülőerőforráson kívüli gyermekerőforrás.	A következő típusú erőforrás szimbolikus neve: virtualMachines
kellékek	A virtuálisgép-bővítmények tulajdonságait ismerteti.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Név	Leírás	Érték
autoUpgradeMinorVersion	Azt jelzi, hogy a bővítménynek egy újabb alverziót kell-e használnia, ha az üzembe helyezéskor elérhető. Az üzembe helyezés után azonban a bővítmény csak akkor frissíti az alverziókat, ha újra üzembe helyezi, még akkor sem, ha ez a tulajdonság igaz értékre van állítva.	Bool
enableAutomaticUpgrade	Azt jelzi, hogy a bővítményt automatikusan frissítenie kell-e a platformnak, ha a bővítmény újabb verziója érhető el.	Bool
forceUpdateTag	Hogyan kell a bővítménykezelőt frissíteni, még akkor is, ha a bővítménykonfiguráció nem változott.	húr
instanceView	A virtuálisgép-bővítménypéldány nézete.	VirtualMachineExtensionInstanceView
protectedSettings	A bővítmény tartalmazhat védettSettings vagy protectedSettingsFromKeyVault beállítást, vagy egyáltalán nem tartalmaz védett beállításokat.	A Bicep esetében az any() függvény használható.
protectedSettingsFromKeyVault	A hivatkozás által átadott és a Key Vaultból felhasznált bővítmények védett beállításai	KeyVaultSecretReference
provisionAfterExtensions	Olyan bővítménynevek gyűjteménye, amelyek után ezt a bővítményt ki kell építeni.	sztring[]
kiadó	A bővítménykezelő közzétevőjének neve.	húr
Beállítások	Json formátumú nyilvános beállítások a bővítményhez.	A Bicep esetében az any() függvény használható.
suppressFailures	Azt jelzi, hogy a bővítményből eredő hibák el lesznek-e tiltva (az olyan működési hibák, mint például a virtuális géphez való csatlakozás mellőzése, függetlenül attól, hogy ez az érték el lesz-e tiltva). Az alapértelmezett érték hamis.	Bool
típus	Megadja a bővítmény típusát; Ilyen például a "CustomScriptExtension".	húr
typeHandlerVersion	A szkriptkezelő verzióját adja meg.	húr

VirtualMachineExtensionInstanceView

Név	Leírás	Érték
név	A virtuális gép bővítményének neve.	húr
Állapotok	Az erőforrás állapotadatai.	InstanceViewStatus[]
alállapotok	Az erőforrás állapotadatai.	InstanceViewStatus[]
típus	Megadja a bővítmény típusát; Ilyen például a "CustomScriptExtension".	húr
typeHandlerVersion	A szkriptkezelő verzióját adja meg.	húr

InstanceViewStatus

Név	Leírás	Érték
kód	Az állapotkód.	húr
displayStatus	Az állapot rövid honosítható címkéje.	húr
szint	A szintkód.	"Hiba" "Információ" "Figyelmeztetés"
üzenet	A részletes állapotüzenet, beleértve a riasztásokat és a hibaüzeneteket is.	húr
Idő	Az állapot időpontja.	húr

KeyVaultSecretReference

Név	Leírás	Érték
secretUrl	Az URL-cím, amely egy titkos kulcsra hivatkozik egy Key Vaultban.	sztring (kötelező)
sourceVault	A titkos kulcsot tartalmazó Key Vault relatív URL-címe.	subResource (kötelező)

Alforrás

Név	Leírás	Érték
azonosító	Erőforrás-azonosító	húr

Rövid útmutatósablonok

Az alábbi rövid útmutatósablonok üzembe helyezik ezt az erőforrástípust.

Sablon	Leírás
Windows rendszerű virtuális gép létrehozása kártevőirtó kiterjesztéssel engedélyezve	Ez a sablon létrehoz egy Windows rendszerű virtuális gépet, és beállítja a Kártevőirtó védelmet
IIS-kiszolgáló DSC-bővítményt használ windowsos virtuálisgép-	Ez a sablon létrehoz egy Windows rendszerű virtuális gépet, és beállít egy IIS-kiszolgálót a DSC-bővítmény használatával. Vegye figyelembe, hogy a DSC-konfigurációs modulnak sas-jogkivonatot kell átadnia az Azure Storage használata esetén. A GitHubról származó DSC-modul hivatkozásához (ebben a sablonban alapértelmezés szerint) nincs szükség erre.
ESET virtuálisgép-bővítmény	Virtuális gép létrehozása ESET kiterjesztéssel
McAfee Endpoint Security (próbaverziós licenc) Windows rendszerű virtuális gépeken	Ez a sablon létrehoz egy Windows rendszerű virtuális gépet, és beállítja a McAfee Endpoint Security próbaverzióját
Ubuntu virtuális gép üzembe helyezése az OMS-bővítmény	Ez a sablon lehetővé teszi egy Ubuntu virtuális gép üzembe helyezését az OMS-bővítmény telepítésével és egy adott munkaterületre való előkészítéssel
Windows rendszerű virtuális gép üzembe helyezése az OMS-bővítmény	Ez a sablon lehetővé teszi egy Windows rendszerű virtuális gép üzembe helyezését az OMS-bővítmény telepítésével és egy adott munkaterületre való előkészítéssel
Symantec Endpoint Protection bővítmény próbaverziója Windows rendszerű virtuális gépeken	Ez a sablon létrehoz egy Windows rendszerű virtuális gépet, és beállítja a Symantec Endpoint Protection próbaverzióját
egyéni szkriptbővítmény Ubuntu virtuálisgép-	Ez a sablon létrehoz egy Ubuntu virtuális gépet, és telepíti a CustomScript bővítményt
operációsrendszer-javítás bővítménye Ubuntu virtuális gépen	Ez a sablon létrehoz egy Ubuntu virtuális gépet, és telepíti az OSPatching bővítményt
Prémium szintű Windows rendszerű virtuális gép üzembe helyezése diagnosztikai	Ez a sablon lehetővé teszi egy Prémium Szintű Windows rendszerű virtuális gép üzembe helyezését a Windows-verzió néhány különböző lehetőségével, a legújabb javított verzióval.
Egyszerű Windows rendszerű virtuális gép üzembe helyezése monitorozási és diagnosztikai	Ez a sablon lehetővé teszi egy egyszerű Windows rendszerű virtuális gép és a diagnosztikai bővítmény üzembe helyezését, amely lehetővé teszi a virtuális gép monitorozását és diagnosztikát
Mongo DB telepítése szkriptbővítményekkel Ubuntu virtuális gépen	Ez a sablon két külön szkriptben helyezi üzembe a Mongo DB konfigurálását és telepítését egy Ubuntu virtuális gépen. Ez a sablon egy jó példa, amely bemutatja, hogyan fejezhet ki függőségeket két, ugyanazon a virtuális gépen futó szkript között. Ez a sablon emellett egy tárfiókot, egy virtuális hálózatot, egy nyilvános IP-címet és egy hálózati adaptert is üzembe helyez.

ARM-sablon erőforrásdefiníciója

A virtualMachines/extensions erőforrástípus üzembe helyezhető olyan műveletekkel, amelyek a következő célokat célják:

Erőforráscsoportok – Lásd erőforráscsoport üzembe helyezési parancsaival

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.

Erőforrás formátuma

Microsoft.Compute/virtualMachines/extensions erőforrás létrehozásához adja hozzá a következő JSON-t a sablonhoz.

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

Tulajdonságértékek

virtualMachines/extensions

Név	Leírás	Érték
típus	Az erőforrás típusa	"Microsoft.Compute/virtualMachines/extensions"
apiVersion	Az erőforrás API-verziója	'2024-07-01'
név	Az erőforrás neve Megtudhatja, hogyan állíthat be neveket és típusokat a gyermekerőforrásokhoz JSON ARM-sablonokban.	sztring (kötelező)
hely	Erőforrás helye	húr
Címkék	Erőforráscímkék	Címkenevek és -értékek szótára. sablonok címkéinek megtekintése
kellékek	A virtuálisgép-bővítmények tulajdonságait ismerteti.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Név	Leírás	Érték
autoUpgradeMinorVersion	Azt jelzi, hogy a bővítménynek egy újabb alverziót kell-e használnia, ha az üzembe helyezéskor elérhető. Az üzembe helyezés után azonban a bővítmény csak akkor frissíti az alverziókat, ha újra üzembe helyezi, még akkor sem, ha ez a tulajdonság igaz értékre van állítva.	Bool
enableAutomaticUpgrade	Azt jelzi, hogy a bővítményt automatikusan frissítenie kell-e a platformnak, ha a bővítmény újabb verziója érhető el.	Bool
forceUpdateTag	Hogyan kell a bővítménykezelőt frissíteni, még akkor is, ha a bővítménykonfiguráció nem változott.	húr
instanceView	A virtuálisgép-bővítménypéldány nézete.	VirtualMachineExtensionInstanceView
protectedSettings	A bővítmény tartalmazhat védettSettings vagy protectedSettingsFromKeyVault beállítást, vagy egyáltalán nem tartalmaz védett beállításokat.
protectedSettingsFromKeyVault	A hivatkozás által átadott és a Key Vaultból felhasznált bővítmények védett beállításai	KeyVaultSecretReference
provisionAfterExtensions	Olyan bővítménynevek gyűjteménye, amelyek után ezt a bővítményt ki kell építeni.	sztring[]
kiadó	A bővítménykezelő közzétevőjének neve.	húr
Beállítások	Json formátumú nyilvános beállítások a bővítményhez.
suppressFailures	Azt jelzi, hogy a bővítményből eredő hibák el lesznek-e tiltva (az olyan működési hibák, mint például a virtuális géphez való csatlakozás mellőzése, függetlenül attól, hogy ez az érték el lesz-e tiltva). Az alapértelmezett érték hamis.	Bool
típus	Megadja a bővítmény típusát; Ilyen például a "CustomScriptExtension".	húr
typeHandlerVersion	A szkriptkezelő verzióját adja meg.	húr

VirtualMachineExtensionInstanceView

Név	Leírás	Érték
név	A virtuális gép bővítményének neve.	húr
Állapotok	Az erőforrás állapotadatai.	InstanceViewStatus[]
alállapotok	Az erőforrás állapotadatai.	InstanceViewStatus[]
típus	Megadja a bővítmény típusát; Ilyen például a "CustomScriptExtension".	húr
typeHandlerVersion	A szkriptkezelő verzióját adja meg.	húr

InstanceViewStatus

Név	Leírás	Érték
kód	Az állapotkód.	húr
displayStatus	Az állapot rövid honosítható címkéje.	húr
szint	A szintkód.	"Hiba" "Információ" "Figyelmeztetés"
üzenet	A részletes állapotüzenet, beleértve a riasztásokat és a hibaüzeneteket is.	húr
Idő	Az állapot időpontja.	húr

KeyVaultSecretReference

Név	Leírás	Érték
secretUrl	Az URL-cím, amely egy titkos kulcsra hivatkozik egy Key Vaultban.	sztring (kötelező)
sourceVault	A titkos kulcsot tartalmazó Key Vault relatív URL-címe.	subResource (kötelező)

Alforrás

Név	Leírás	Érték
azonosító	Erőforrás-azonosító	húr

Rövid útmutatósablonok

Az alábbi rövid útmutatósablonok üzembe helyezik ezt az erőforrástípust.

Sablon	Leírás
Windows rendszerű virtuális gép létrehozása kártevőirtó kiterjesztéssel engedélyezve	Ez a sablon létrehoz egy Windows rendszerű virtuális gépet, és beállítja a Kártevőirtó védelmet
IIS-kiszolgáló DSC-bővítményt használ windowsos virtuálisgép-	Ez a sablon létrehoz egy Windows rendszerű virtuális gépet, és beállít egy IIS-kiszolgálót a DSC-bővítmény használatával. Vegye figyelembe, hogy a DSC-konfigurációs modulnak sas-jogkivonatot kell átadnia az Azure Storage használata esetén. A GitHubról származó DSC-modul hivatkozásához (ebben a sablonban alapértelmezés szerint) nincs szükség erre.
ESET virtuálisgép-bővítmény	Virtuális gép létrehozása ESET kiterjesztéssel
McAfee Endpoint Security (próbaverziós licenc) Windows rendszerű virtuális gépeken	Ez a sablon létrehoz egy Windows rendszerű virtuális gépet, és beállítja a McAfee Endpoint Security próbaverzióját
Ubuntu virtuális gép üzembe helyezése az OMS-bővítmény	Ez a sablon lehetővé teszi egy Ubuntu virtuális gép üzembe helyezését az OMS-bővítmény telepítésével és egy adott munkaterületre való előkészítéssel
Windows rendszerű virtuális gép üzembe helyezése az OMS-bővítmény	Ez a sablon lehetővé teszi egy Windows rendszerű virtuális gép üzembe helyezését az OMS-bővítmény telepítésével és egy adott munkaterületre való előkészítéssel
Symantec Endpoint Protection bővítmény próbaverziója Windows rendszerű virtuális gépeken	Ez a sablon létrehoz egy Windows rendszerű virtuális gépet, és beállítja a Symantec Endpoint Protection próbaverzióját
egyéni szkriptbővítmény Ubuntu virtuálisgép-	Ez a sablon létrehoz egy Ubuntu virtuális gépet, és telepíti a CustomScript bővítményt
operációsrendszer-javítás bővítménye Ubuntu virtuális gépen	Ez a sablon létrehoz egy Ubuntu virtuális gépet, és telepíti az OSPatching bővítményt
Prémium szintű Windows rendszerű virtuális gép üzembe helyezése diagnosztikai	Ez a sablon lehetővé teszi egy Prémium Szintű Windows rendszerű virtuális gép üzembe helyezését a Windows-verzió néhány különböző lehetőségével, a legújabb javított verzióval.
Egyszerű Windows rendszerű virtuális gép üzembe helyezése monitorozási és diagnosztikai	Ez a sablon lehetővé teszi egy egyszerű Windows rendszerű virtuális gép és a diagnosztikai bővítmény üzembe helyezését, amely lehetővé teszi a virtuális gép monitorozását és diagnosztikát
Mongo DB telepítése szkriptbővítményekkel Ubuntu virtuális gépen	Ez a sablon két külön szkriptben helyezi üzembe a Mongo DB konfigurálását és telepítését egy Ubuntu virtuális gépen. Ez a sablon egy jó példa, amely bemutatja, hogyan fejezhet ki függőségeket két, ugyanazon a virtuális gépen futó szkript között. Ez a sablon emellett egy tárfiókot, egy virtuális hálózatot, egy nyilvános IP-címet és egy hálózati adaptert is üzembe helyez.

Terraform (AzAPI-szolgáltató) erőforrásdefiníciója

A virtualMachines/extensions erőforrástípus üzembe helyezhető olyan műveletekkel, amelyek a következő célokat célják:

erőforráscsoportok

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplócímű témakörben találja.

Erőforrás formátuma

Microsoft.Compute/virtualMachines/extensions erőforrás létrehozásához adja hozzá a következő Terraformot a sablonhoz.

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

Tulajdonságértékek

virtualMachines/extensions

Név	Leírás	Érték
típus	Az erőforrás típusa	"Microsoft.Compute/virtualMachines/extensions@2024-07-01"
név	Az erőforrás neve	sztring (kötelező)
hely	Erőforrás helye	húr
parent_id	Annak az erőforrásnak az azonosítója, amely az erőforrás szülője.	Típus típusú erőforrás azonosítója: virtualMachines
Címkék	Erőforráscímkék	Címkenevek és -értékek szótára.
kellékek	A virtuálisgép-bővítmények tulajdonságait ismerteti.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Név	Leírás	Érték
autoUpgradeMinorVersion	Azt jelzi, hogy a bővítménynek egy újabb alverziót kell-e használnia, ha az üzembe helyezéskor elérhető. Az üzembe helyezés után azonban a bővítmény csak akkor frissíti az alverziókat, ha újra üzembe helyezi, még akkor sem, ha ez a tulajdonság igaz értékre van állítva.	Bool
enableAutomaticUpgrade	Azt jelzi, hogy a bővítményt automatikusan frissítenie kell-e a platformnak, ha a bővítmény újabb verziója érhető el.	Bool
forceUpdateTag	Hogyan kell a bővítménykezelőt frissíteni, még akkor is, ha a bővítménykonfiguráció nem változott.	húr
instanceView	A virtuálisgép-bővítménypéldány nézete.	VirtualMachineExtensionInstanceView
protectedSettings	A bővítmény tartalmazhat védettSettings vagy protectedSettingsFromKeyVault beállítást, vagy egyáltalán nem tartalmaz védett beállításokat.
protectedSettingsFromKeyVault	A hivatkozás által átadott és a Key Vaultból felhasznált bővítmények védett beállításai	KeyVaultSecretReference
provisionAfterExtensions	Olyan bővítménynevek gyűjteménye, amelyek után ezt a bővítményt ki kell építeni.	sztring[]
kiadó	A bővítménykezelő közzétevőjének neve.	húr
Beállítások	Json formátumú nyilvános beállítások a bővítményhez.
suppressFailures	Azt jelzi, hogy a bővítményből eredő hibák el lesznek-e tiltva (az olyan működési hibák, mint például a virtuális géphez való csatlakozás mellőzése, függetlenül attól, hogy ez az érték el lesz-e tiltva). Az alapértelmezett érték hamis.	Bool
típus	Megadja a bővítmény típusát; Ilyen például a "CustomScriptExtension".	húr
typeHandlerVersion	A szkriptkezelő verzióját adja meg.	húr

VirtualMachineExtensionInstanceView

Név	Leírás	Érték
név	A virtuális gép bővítményének neve.	húr
Állapotok	Az erőforrás állapotadatai.	InstanceViewStatus[]
alállapotok	Az erőforrás állapotadatai.	InstanceViewStatus[]
típus	Megadja a bővítmény típusát; Ilyen például a "CustomScriptExtension".	húr
typeHandlerVersion	A szkriptkezelő verzióját adja meg.	húr

InstanceViewStatus

Név	Leírás	Érték
kód	Az állapotkód.	húr
displayStatus	Az állapot rövid honosítható címkéje.	húr
szint	A szintkód.	"Hiba" "Információ" "Figyelmeztetés"
üzenet	A részletes állapotüzenet, beleértve a riasztásokat és a hibaüzeneteket is.	húr
Idő	Az állapot időpontja.	húr

KeyVaultSecretReference

Név	Leírás	Érték
secretUrl	Az URL-cím, amely egy titkos kulcsra hivatkozik egy Key Vaultban.	sztring (kötelező)
sourceVault	A titkos kulcsot tartalmazó Key Vault relatív URL-címe.	subResource (kötelező)

Alforrás

Név	Leírás	Érték
azonosító	Erőforrás-azonosító	húr

Megosztás a következőn keresztül:

Microsoft.Compute virtualMachines/extensions

Bicep-erőforrásdefiníció

Erőforrás formátuma

Tulajdonságértékek

virtualMachines/extensions

VirtualMachineExtensionProperties

VirtualMachineExtensionInstanceView

InstanceViewStatus

KeyVaultSecretReference

Alforrás

Rövid útmutatósablonok

ARM-sablon erőforrásdefiníciója

Erőforrás formátuma

Tulajdonságértékek

virtualMachines/extensions

VirtualMachineExtensionProperties

VirtualMachineExtensionInstanceView

InstanceViewStatus

KeyVaultSecretReference

Alforrás

Rövid útmutatósablonok

Terraform (AzAPI-szolgáltató) erőforrásdefiníciója

Erőforrás formátuma

Tulajdonságértékek

virtualMachines/extensions

VirtualMachineExtensionProperties

VirtualMachineExtensionInstanceView

InstanceViewStatus

KeyVaultSecretReference

Alforrás

Visszajelzés

További források