Microsoft.Compute virtualMachines/extensions

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:

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplóban 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@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'
  }
}

Tulajdonságértékek

virtualMachines/extensions

Név Leírás Érték
name Az erőforrás neve

Megtudhatja, hogyan állíthatja be a gyermekerőforrások nevét és típusát a Bicepben.
sztring (kötelező)
location Erőforrás helye sztring
tags Erőforráscímkék Címkenevek és -értékek szótára. Címkék megtekintése sablonokban
Szülő A Bicepben megadhatja egy 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ó: Gyermekerőforrás a szülőerőforráson kívül.
A következő típusú erőforrás szimbolikus neve: virtualMachines
properties Egy virtuálisgép-bővítmény 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. logikai
enableAutomaticUpgrade Azt jelzi, hogy a bővítményt a platformnak automatikusan frissítenie kell-e, ha elérhető a bővítmény újabb verziója. logikai
forceUpdateTag Hogyan kell a bővítménykezelőt frissíteni akkor is, ha a bővítmény konfigurációja nem változott. sztring
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 értékeket, vagy egyáltalán nem tartalmaz védett beállításokat. A Bicep esetében használhatja az any() függvényt.
protectedSettingsFromKeyVault A hivatkozással átadott és a Key Vaultból felhasznált bővítmények által védett beállítások KeyVaultSecretReference
provisionAfterExtensions Bővítménynevek gyűjteménye, amely után ki kell építeni ezt a bővítményt. sztring[]
közzétevő A bővítménykezelő közzétevőjének neve. sztring
beállítások A Json formázta a bővítmény nyilvános beállításait. A Bicep esetében használhatja az any() függvényt.
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 hiánya, nem lesznek letiltva, függetlenül attól, hogy milyen értékről van szó). Az alapértelmezett érték hamis. logikai
típus Megadja a bővítmény típusát; Ilyen például a "CustomScriptExtension". sztring
typeHandlerVersion A szkriptkezelő verzióját adja meg. sztring

VirtualMachineExtensionInstanceView

Név Leírás Érték
name A virtuálisgép-bővítmény neve. sztring
Á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". sztring
typeHandlerVersion A szkriptkezelő verzióját adja meg. sztring

InstanceViewStatus

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

KeyVaultSecretReference

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

Alforrás

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

Gyorssablonok

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

Sablon Description
Windows rendszerű virtuális gép létrehozása kártevőirtó bővítmény engedélyezésével

Üzembe helyezés az Azure-ban
Ez a sablon létrehoz egy Windows rendszerű virtuális gépet, és beállítja a Kártevőirtó védelmet
IIS Server DSC-bővítmény használatával Windows rendszerű virtuális gépen

Üzembe helyezés az Azure-ban
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 az Azure Storage használata esetén a DSC konfigurációs modulnak sas-jogkivonatot kell átadnia. 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

Üzembe helyezés az Azure-ban
Virtuális gép létrehozása ESET-bővítménnyel
McAfee Endpoint Security (próbaverziós licenc) Windows rendszerű virtuális gépen

Üzembe helyezés az Azure-ban
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énnyel

Üzembe helyezés az Azure-ban
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ésével
Windows rendszerű virtuális gép üzembe helyezése az OMS-bővítménnyel

Üzembe helyezés az Azure-ban
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 történő előkészítésével
Symantec Endpoint Protection-bővítmény próbaverziója Windows rendszerű virtuális gépen

Üzembe helyezés az Azure-ban
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ális gépen

Üzembe helyezés az Azure-ban
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ási bővítmény Ubuntu rendszerű virtuális gépen

Üzembe helyezés az Azure-ban
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 diagnosztikával

Üzembe helyezés az Azure-ban
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ítással.
Egyszerű Windows rendszerű virtuális gép üzembe helyezése monitorozással és diagnosztikával

Üzembe helyezés az Azure-ban
Ez a sablon lehetővé teszi egy egyszerű Windows rendszerű virtuális gép üzembe helyezését a diagnosztikai bővítménysel együtt, amely lehetővé teszi a virtuális gép monitorozását és diagnosztikát
A Mongo DB Ubuntu virtuális gépen való telepítéséhez használjon szkriptbővítményeket

Üzembe helyezés az Azure-ban
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 egy tárfiókot, Virtual Network, nyilvános IP-címeket és 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:

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplóban 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": "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"
  }
}

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 '2023-09-01'
name Az erőforrás neve

Megtudhatja, hogyan állíthatja be a gyermekerőforrások nevét és típusát A JSON ARM-sablonokban.
sztring (kötelező)
location Erőforrás helye sztring
tags Erőforráscímkék Címkenevek és -értékek szótára. Címkék megtekintése sablonokban
properties Egy virtuálisgép-bővítmény 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. logikai
enableAutomaticUpgrade Azt jelzi, hogy a bővítményt a platformnak automatikusan frissítenie kell-e, ha elérhető a bővítmény újabb verziója. logikai
forceUpdateTag Hogyan kell a bővítménykezelőt frissíteni akkor is, ha a bővítmény konfigurációja nem változott. sztring
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 értékeket, vagy egyáltalán nem tartalmaz védett beállításokat.
protectedSettingsFromKeyVault A hivatkozással átadott és a Key Vaultból felhasznált bővítmények által védett beállítások KeyVaultSecretReference
provisionAfterExtensions Bővítménynevek gyűjteménye, amely után ki kell építeni ezt a bővítményt. sztring[]
közzétevő A bővítménykezelő közzétevőjének neve. sztring
beállítások A Json formázta a bővítmény nyilvános beállításait.
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 hiánya, nem lesznek letiltva, függetlenül attól, hogy milyen értékről van szó). Az alapértelmezett érték hamis. logikai
típus Megadja a bővítmény típusát; Ilyen például a "CustomScriptExtension". sztring
typeHandlerVersion A szkriptkezelő verzióját adja meg. sztring

VirtualMachineExtensionInstanceView

Név Leírás Érték
name A virtuálisgép-bővítmény neve. sztring
Á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". sztring
typeHandlerVersion A szkriptkezelő verzióját adja meg. sztring

InstanceViewStatus

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

KeyVaultSecretReference

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

Alforrás

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

Gyorssablonok

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

Sablon Description
Windows rendszerű virtuális gép létrehozása kártevőirtó bővítmény engedélyezésével

Üzembe helyezés az Azure-ban
Ez a sablon létrehoz egy Windows rendszerű virtuális gépet, és beállítja a Kártevőirtó védelmet
IIS Server DSC-bővítmény használatával Windows rendszerű virtuális gépen

Üzembe helyezés az Azure-ban
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 az Azure Storage használata esetén a DSC konfigurációs modulnak sas-jogkivonatot kell átadnia. 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

Üzembe helyezés az Azure-ban
Virtuális gép létrehozása ESET-bővítménnyel
McAfee Endpoint Security (próbaverziós licenc) Windows rendszerű virtuális gépen

Üzembe helyezés az Azure-ban
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énnyel

Üzembe helyezés az Azure-ban
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ésével
Windows rendszerű virtuális gép üzembe helyezése az OMS-bővítménnyel

Üzembe helyezés az Azure-ban
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 történő előkészítésével
Symantec Endpoint Protection-bővítmény próbaverziója Windows rendszerű virtuális gépen

Üzembe helyezés az Azure-ban
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ális gépen

Üzembe helyezés az Azure-ban
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ási bővítmény Ubuntu rendszerű virtuális gépen

Üzembe helyezés az Azure-ban
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 diagnosztikával

Üzembe helyezés az Azure-ban
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ítással.
Egyszerű Windows rendszerű virtuális gép üzembe helyezése monitorozással és diagnosztikával

Üzembe helyezés az Azure-ban
Ez a sablon lehetővé teszi egy egyszerű Windows rendszerű virtuális gép üzembe helyezését a diagnosztikai bővítménysel együtt, amely lehetővé teszi a virtuális gép monitorozását és diagnosztikát
A Mongo DB Ubuntu virtuális gépen való telepítéséhez használjon szkriptbővítményeket

Üzembe helyezés az Azure-ban
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 egy tárfiókot, Virtual Network, nyilvános IP-címeket és hálózati adaptert is üzembe helyez.

Terraform (AzAPI-szolgáltató) 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

Az egyes API-verziók módosított tulajdonságainak listáját a változásnaplóban 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@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"
    }
  })
}

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@2023-09-01"
name Az erőforrás neve sztring (kötelező)
location Erőforrás helye sztring
parent_id Az erőforrás szülőjének azonosítója. A következő típusú erőforrás azonosítója: virtualMachines
tags Erőforráscímkék Címkenevek és -értékek szótára.
properties Egy virtuálisgép-bővítmény 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. logikai
enableAutomaticUpgrade Azt jelzi, hogy a bővítményt a platformnak automatikusan frissítenie kell-e, ha elérhető a bővítmény újabb verziója. logikai
forceUpdateTag Hogyan kell a bővítménykezelőt a frissítésre kényszeríteni, még akkor is, ha a bővítmény konfigurációja nem változott. sztring
instanceView A virtuálisgép-bővítmény példánynézete. VirtualMachineExtensionInstanceView
protectedSettings A bővítmény tartalmazhat protectedSettings 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 Bővítménynevek gyűjteménye, amely után ezt a bővítményt ki kell építeni. sztring[]
közzétevő A bővítménykezelő közzétevőjének neve. sztring
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, ettől az értéktől függetlenül nem lesznek letiltva). Az alapértelmezett érték hamis. logikai
típus Megadja a bővítmény típusát; Ilyen például a "CustomScriptExtension". sztring
typeHandlerVersion A szkriptkezelő verzióját adja meg. sztring

VirtualMachineExtensionInstanceView

Név Leírás Érték
name A virtuális gép bővítményének neve. sztring
Á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". sztring
typeHandlerVersion A szkriptkezelő verzióját adja meg. sztring

InstanceViewStatus

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

KeyVaultSecretReference

Név Leírás Érték
secretUrl A titkos kódra hivatkozó URL-cím egy Key Vault. sztring (kötelező)
sourceVault A titkos kódot tartalmazó Key Vault relatív URL-címe. Alforrás (kötelező)

Alforrás

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