Microsoft.Compute virtualMachines/extensions

Článek
08/17/2024

nejnovější
2024-07-01
2024-03-01
2023-09-01
2023-07-01
2023-03-01
11. 11. 2022
2022-08-01
1. 3. 2022
11. 11. 2021
2021-07-01
2021-04-01
2021-03-01
12. 12. 2020

Definice prostředku Bicep

Typ prostředku virtualMachines/extensions je možné nasadit s operacemi, které cílí:

skupiny prostředků – viz příkazy nasazení skupiny prostředků

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Compute/virtualMachines/extensions, přidejte do šablony následující bicep.

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

Hodnoty vlastností

virtualMachines/extensions

Jméno	Popis	Hodnota
Jméno	Název prostředku Podívejte se, jak nastavit názvy a typy podřízených prostředků v Bicep.	string (povinné)
umístění	Umístění prostředku	řetězec
visačky	Značky prostředků	Slovník názvů a hodnot značek Viz Značky v šablonách
rodič	V bicep můžete zadat nadřazený prostředek pro podřízený prostředek. Tuto vlastnost je potřeba přidat pouze v případě, že je podřízený prostředek deklarován mimo nadřazený prostředek. Další informace najdete v tématu Podřízený prostředek mimo nadřazený prostředek.	Symbolický název prostředku typu: virtualMachines
vlastnosti	Popisuje vlastnosti rozšíření virtuálního počítače.	virtualMachineExtensionProperties

VirtualMachineExtensionProperties

Jméno	Popis	Hodnota
autoUpgradeMinorVersion	Určuje, jestli má rozšíření používat novější podverzi, pokud je k dispozici v době nasazení. Po nasazení však rozšíření neupgraduje podverze, pokud se znovu nenasadí, a to ani s touto vlastností nastavenou na true.	Bool
enableAutomaticUpgrade	Určuje, jestli má být rozšíření automaticky upgradováno platformou, pokud je k dispozici novější verze rozšíření.	Bool
forceUpdateTag	Způsob vynucení aktualizace obslužné rutiny rozšíření i v případě, že se konfigurace rozšíření nezměnila.	řetězec
instanceView	Zobrazení instance rozšíření virtuálního počítače.	VirtualMachineExtensionInstanceView
protectedSettings	Rozšíření může obsahovat buď protectedSettings, nebo protectedSettingsFromKeyVault, nebo vůbec žádná chráněná nastavení.	Pro Bicep můžete použít funkci any().
protectedSettingsFromKeyVault	Nastavení chráněná rozšířeními, která jsou předána odkazem, a spotřebovaná z trezoru klíčů	keyVaultSecretReference
provisionAfterExtensions	Kolekce názvů rozšíření, po kterých je potřeba toto rozšíření zřídit.	string[]
vydavatel	Název vydavatele obslužné rutiny rozšíření.	řetězec
nastavení	Veřejná nastavení formátovaná json pro rozšíření	Pro Bicep můžete použít funkci any().
suppressFailures	Určuje, jestli se potlačí selhání vyplývající z rozšíření (provozní selhání, jako je například nepřipojování k virtuálnímu počítači, nebudou potlačována bez ohledu na tuto hodnotu). Výchozí hodnota je false.	Bool
typ	Určuje typ rozšíření; Příkladem je CustomScriptExtension.	řetězec
typeHandlerVersion	Určuje verzi obslužné rutiny skriptu.	řetězec

VirtualMachineExtensionInstanceView

Jméno	Popis	Hodnota
Jméno	Název rozšíření virtuálního počítače.	řetězec
Stavy	Informace o stavu zdroje	InstanceViewStatus[]
dílčí statistiky	Informace o stavu zdroje	InstanceViewStatus[]
typ	Určuje typ rozšíření; Příkladem je CustomScriptExtension.	řetězec
typeHandlerVersion	Určuje verzi obslužné rutiny skriptu.	řetězec

InstanceViewStatus

Jméno	Popis	Hodnota
kód	Stavový kód.	řetězec
displayStatus	Krátký lokalizovatelný popisek stavu.	řetězec
úroveň	Kód úrovně.	Chyba Informace "Upozornění"
zpráva	Podrobná stavová zpráva, včetně výstrah a chybových zpráv.	řetězec
Čas	Čas stavu.	řetězec

KeyVaultSecretReference

Jméno	Popis	Hodnota
secretUrl	Adresa URL odkazující na tajný kód ve službě Key Vault.	string (povinné)
sourceVault	Relativní adresa URL služby Key Vault obsahující tajný klíč.	subresource (povinné)

Podsourc

Jméno	Popis	Hodnota
id	ID prostředku	řetězec

Šablony pro rychlý start

Následující šablony pro rychlý start nasazují tento typ prostředku.

Šablona	Popis
vytvoření virtuálního počítače s Windows s povoleným rozšířením Antimalwaru nasazení	Tato šablona vytvoří virtuální počítač s Windows a nastaví ochranu proti malwaru.
serveru IIS pomocí rozšíření DSC na virtuálním počítači s Windows nasazení	Tato šablona vytvoří virtuální počítač s Windows a nastaví server IIS pomocí rozšíření DSC. Mějte na paměti, že modul konfigurace DSC vyžaduje předání tokenu SAS, pokud používáte Azure Storage. Pro odkaz na modul DSC z GitHubu (výchozí nastavení v této šabloně) to není potřeba.
rozšíření ESET VM nasazení	Vytvoří virtuální počítač s rozšířením ESET.
McAfee Endpoint Security (zkušební licence) na virtuálním počítači s Windows nasazení	Tato šablona vytvoří virtuální počítač s Windows a nastaví zkušební verzi McAfee Endpoint Security.
Nasazení virtuálního počítače s Ubuntu s rozšířením OMS nasazení	Tato šablona umožňuje nasadit virtuální počítač s Ubuntu s nainstalovaným a nasazeným rozšířením OMS do zadaného pracovního prostoru.
Nasazení virtuálního počítače s Windows s rozšířením OMS nasazení	Tato šablona umožňuje nasadit virtuální počítač s Windows s nainstalovaným rozšířením OMS a nasazeným do zadaného pracovního prostoru.
zkušební verze rozšíření Symantec Endpoint Protection na virtuálním počítači s Windows nasazení	Tato šablona vytvoří virtuální počítač s Windows a nastaví zkušební verzi Symantec Endpoint Protection.
rozšíření vlastních skriptů na virtuálním počítači s Ubuntu nasazení	Tato šablona vytvoří virtuální počítač s Ubuntu a nainstaluje rozšíření CustomScript.
rozšíření oprav operačního systému na virtuálním počítači s Ubuntu nasazení	Tato šablona vytvoří virtuální počítač s Ubuntu a nainstaluje rozšíření OSPatching.
Nasazení virtuálního počítače s Windows Úrovně Premium s diagnostickými nasazení	Tato šablona umožňuje nasadit virtuální počítač s Windows Premium pomocí několika různých možností pro verzi Windows s použitím nejnovější opravené verze.
Nasazení jednoduchého virtuálního počítače s Windows s monitorováním a diagnostikou nasazení	Tato šablona umožňuje nasadit jednoduchý virtuální počítač s Windows spolu s rozšířením diagnostiky, které umožňuje monitorování a diagnostiku virtuálního počítače.
Instalace Mongo DB na virtuální počítač s Ubuntu pomocí rozšíření skriptů nasazení	Tato šablona nasadí službu Configures and Installs Mongo DB na virtuální počítač s Ubuntu ve dvou samostatných skriptech. Tato šablona je dobrým příkladem, který předvádí, jak vyjádřit závislosti mezi dvěma skripty spuštěnými na stejném virtuálním počítači. Tato šablona také nasadí účet úložiště, virtuální síť, veřejné IP adresy a síťové rozhraní.

Definice prostředku šablony ARM

Typ prostředku virtualMachines/extensions je možné nasadit s operacemi, které cílí:

skupiny prostředků – viz příkazy nasazení skupiny prostředků

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Compute/virtualMachines/extensions, přidejte do šablony následující JSON.

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

Hodnoty vlastností

virtualMachines/extensions

Jméno	Popis	Hodnota
typ	Typ prostředku	Microsoft.Compute/virtualMachines/extensions
apiVersion	Verze rozhraní API prostředku	'2024-07-01'
Jméno	Název prostředku Podívejte se, jak nastavit názvy a typy podřízených prostředků v šablonách JSON ARM.	string (povinné)
umístění	Umístění prostředku	řetězec
visačky	Značky prostředků	Slovník názvů a hodnot značek Viz Značky v šablonách
vlastnosti	Popisuje vlastnosti rozšíření virtuálního počítače.	virtualMachineExtensionProperties

VirtualMachineExtensionProperties

Jméno	Popis	Hodnota
autoUpgradeMinorVersion	Určuje, jestli má rozšíření používat novější podverzi, pokud je k dispozici v době nasazení. Po nasazení však rozšíření neupgraduje podverze, pokud se znovu nenasadí, a to ani s touto vlastností nastavenou na true.	Bool
enableAutomaticUpgrade	Určuje, jestli má být rozšíření automaticky upgradováno platformou, pokud je k dispozici novější verze rozšíření.	Bool
forceUpdateTag	Způsob vynucení aktualizace obslužné rutiny rozšíření i v případě, že se konfigurace rozšíření nezměnila.	řetězec
instanceView	Zobrazení instance rozšíření virtuálního počítače.	VirtualMachineExtensionInstanceView
protectedSettings	Rozšíření může obsahovat buď protectedSettings, nebo protectedSettingsFromKeyVault, nebo vůbec žádná chráněná nastavení.
protectedSettingsFromKeyVault	Nastavení chráněná rozšířeními, která jsou předána odkazem, a spotřebovaná z trezoru klíčů	keyVaultSecretReference
provisionAfterExtensions	Kolekce názvů rozšíření, po kterých je potřeba toto rozšíření zřídit.	string[]
vydavatel	Název vydavatele obslužné rutiny rozšíření.	řetězec
nastavení	Veřejná nastavení formátovaná json pro rozšíření
suppressFailures	Určuje, jestli se potlačí selhání vyplývající z rozšíření (provozní selhání, jako je například nepřipojování k virtuálnímu počítači, nebudou potlačována bez ohledu na tuto hodnotu). Výchozí hodnota je false.	Bool
typ	Určuje typ rozšíření; Příkladem je CustomScriptExtension.	řetězec
typeHandlerVersion	Určuje verzi obslužné rutiny skriptu.	řetězec

VirtualMachineExtensionInstanceView

Jméno	Popis	Hodnota
Jméno	Název rozšíření virtuálního počítače.	řetězec
Stavy	Informace o stavu zdroje	InstanceViewStatus[]
dílčí statistiky	Informace o stavu zdroje	InstanceViewStatus[]
typ	Určuje typ rozšíření; Příkladem je CustomScriptExtension.	řetězec
typeHandlerVersion	Určuje verzi obslužné rutiny skriptu.	řetězec

InstanceViewStatus

Jméno	Popis	Hodnota
kód	Stavový kód.	řetězec
displayStatus	Krátký lokalizovatelný popisek stavu.	řetězec
úroveň	Kód úrovně.	Chyba Informace "Upozornění"
zpráva	Podrobná stavová zpráva, včetně výstrah a chybových zpráv.	řetězec
Čas	Čas stavu.	řetězec

KeyVaultSecretReference

Jméno	Popis	Hodnota
secretUrl	Adresa URL odkazující na tajný kód ve službě Key Vault.	string (povinné)
sourceVault	Relativní adresa URL služby Key Vault obsahující tajný klíč.	subresource (povinné)

Podsourc

Jméno	Popis	Hodnota
id	ID prostředku	řetězec

Šablony pro rychlý start

Následující šablony pro rychlý start nasazují tento typ prostředku.

Šablona	Popis
vytvoření virtuálního počítače s Windows s povoleným rozšířením Antimalwaru nasazení	Tato šablona vytvoří virtuální počítač s Windows a nastaví ochranu proti malwaru.
serveru IIS pomocí rozšíření DSC na virtuálním počítači s Windows nasazení	Tato šablona vytvoří virtuální počítač s Windows a nastaví server IIS pomocí rozšíření DSC. Mějte na paměti, že modul konfigurace DSC vyžaduje předání tokenu SAS, pokud používáte Azure Storage. Pro odkaz na modul DSC z GitHubu (výchozí nastavení v této šabloně) to není potřeba.
rozšíření ESET VM nasazení	Vytvoří virtuální počítač s rozšířením ESET.
McAfee Endpoint Security (zkušební licence) na virtuálním počítači s Windows nasazení	Tato šablona vytvoří virtuální počítač s Windows a nastaví zkušební verzi McAfee Endpoint Security.
Nasazení virtuálního počítače s Ubuntu s rozšířením OMS nasazení	Tato šablona umožňuje nasadit virtuální počítač s Ubuntu s nainstalovaným a nasazeným rozšířením OMS do zadaného pracovního prostoru.
Nasazení virtuálního počítače s Windows s rozšířením OMS nasazení	Tato šablona umožňuje nasadit virtuální počítač s Windows s nainstalovaným rozšířením OMS a nasazeným do zadaného pracovního prostoru.
zkušební verze rozšíření Symantec Endpoint Protection na virtuálním počítači s Windows nasazení	Tato šablona vytvoří virtuální počítač s Windows a nastaví zkušební verzi Symantec Endpoint Protection.
rozšíření vlastních skriptů na virtuálním počítači s Ubuntu nasazení	Tato šablona vytvoří virtuální počítač s Ubuntu a nainstaluje rozšíření CustomScript.
rozšíření oprav operačního systému na virtuálním počítači s Ubuntu nasazení	Tato šablona vytvoří virtuální počítač s Ubuntu a nainstaluje rozšíření OSPatching.
Nasazení virtuálního počítače s Windows Úrovně Premium s diagnostickými nasazení	Tato šablona umožňuje nasadit virtuální počítač s Windows Premium pomocí několika různých možností pro verzi Windows s použitím nejnovější opravené verze.
Nasazení jednoduchého virtuálního počítače s Windows s monitorováním a diagnostikou nasazení	Tato šablona umožňuje nasadit jednoduchý virtuální počítač s Windows spolu s rozšířením diagnostiky, které umožňuje monitorování a diagnostiku virtuálního počítače.
Instalace Mongo DB na virtuální počítač s Ubuntu pomocí rozšíření skriptů nasazení	Tato šablona nasadí službu Configures and Installs Mongo DB na virtuální počítač s Ubuntu ve dvou samostatných skriptech. Tato šablona je dobrým příkladem, který předvádí, jak vyjádřit závislosti mezi dvěma skripty spuštěnými na stejném virtuálním počítači. Tato šablona také nasadí účet úložiště, virtuální síť, veřejné IP adresy a síťové rozhraní.

Definice prostředku Terraformu (poskytovatel AzAPI)

Typ prostředku virtualMachines/extensions je možné nasadit s operacemi, které cílí:

skupiny prostředků

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Compute/virtualMachines/extensions, přidejte do šablony následující Terraform.

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

Hodnoty vlastností

virtualMachines/extensions

Jméno	Popis	Hodnota
typ	Typ prostředku	Microsoft.Compute/virtualMachines/extensions@2024-07-01
Jméno	Název prostředku	string (povinné)
umístění	Umístění prostředku	řetězec
parent_id	ID prostředku, který je nadřazený pro tento prostředek.	ID prostředku typu: virtualMachines
visačky	Značky prostředků	Slovník názvů a hodnot značek
vlastnosti	Popisuje vlastnosti rozšíření virtuálního počítače.	virtualMachineExtensionProperties

VirtualMachineExtensionProperties

Jméno	Popis	Hodnota
autoUpgradeMinorVersion	Určuje, jestli má rozšíření používat novější podverzi, pokud je k dispozici v době nasazení. Po nasazení však rozšíření neupgraduje podverze, pokud se znovu nenasadí, a to ani s touto vlastností nastavenou na true.	Bool
enableAutomaticUpgrade	Určuje, jestli má být rozšíření automaticky upgradováno platformou, pokud je k dispozici novější verze rozšíření.	Bool
forceUpdateTag	Způsob vynucení aktualizace obslužné rutiny rozšíření i v případě, že se konfigurace rozšíření nezměnila.	řetězec
instanceView	Zobrazení instance rozšíření virtuálního počítače.	VirtualMachineExtensionInstanceView
protectedSettings	Rozšíření může obsahovat buď protectedSettings, nebo protectedSettingsFromKeyVault, nebo vůbec žádná chráněná nastavení.
protectedSettingsFromKeyVault	Nastavení chráněná rozšířeními, která jsou předána odkazem, a spotřebovaná z trezoru klíčů	keyVaultSecretReference
provisionAfterExtensions	Kolekce názvů rozšíření, po kterých je potřeba toto rozšíření zřídit.	string[]
vydavatel	Název vydavatele obslužné rutiny rozšíření.	řetězec
nastavení	Veřejná nastavení formátovaná json pro rozšíření
suppressFailures	Určuje, jestli se potlačí selhání vyplývající z rozšíření (provozní selhání, jako je například nepřipojování k virtuálnímu počítači, nebudou potlačována bez ohledu na tuto hodnotu). Výchozí hodnota je false.	Bool
typ	Určuje typ rozšíření; Příkladem je CustomScriptExtension.	řetězec
typeHandlerVersion	Určuje verzi obslužné rutiny skriptu.	řetězec

VirtualMachineExtensionInstanceView

Jméno	Popis	Hodnota
Jméno	Název rozšíření virtuálního počítače.	řetězec
Stavy	Informace o stavu zdroje	InstanceViewStatus[]
dílčí statistiky	Informace o stavu zdroje	InstanceViewStatus[]
typ	Určuje typ rozšíření; Příkladem je CustomScriptExtension.	řetězec
typeHandlerVersion	Určuje verzi obslužné rutiny skriptu.	řetězec

InstanceViewStatus

Jméno	Popis	Hodnota
kód	Stavový kód.	řetězec
displayStatus	Krátký lokalizovatelný popisek stavu.	řetězec
úroveň	Kód úrovně.	"Chyba" "Informace" "Upozornění"
zpráva	Podrobná stavová zpráva, včetně výstrah a chybových zpráv.	řetězec
Čas	Čas stavu.	řetězec

KeyVaultSecretReference

Jméno	Popis	Hodnota
secretUrl	Adresa URL odkazující na tajný kód ve službě Key Vault.	string (povinné)
sourceVault	Relativní adresa URL služby Key Vault obsahující tajný klíč.	subresource (povinné)

Podsourc

Jméno	Popis	Hodnota
id	ID prostředku	řetězec

Sdílet prostřednictvím

Microsoft.Compute virtualMachines/extensions

Definice prostředku Bicep

Formát prostředku

Hodnoty vlastností

virtualMachines/extensions

VirtualMachineExtensionProperties

VirtualMachineExtensionInstanceView

InstanceViewStatus

KeyVaultSecretReference

Podsourc

Šablony pro rychlý start

Definice prostředku šablony ARM

Formát prostředku

Hodnoty vlastností

virtualMachines/extensions

VirtualMachineExtensionProperties

VirtualMachineExtensionInstanceView

InstanceViewStatus

KeyVaultSecretReference

Podsourc

Šablony pro rychlý start

Definice prostředku Terraformu (poskytovatel AzAPI)

Formát prostředku

Hodnoty vlastností

virtualMachines/extensions

VirtualMachineExtensionProperties

VirtualMachineExtensionInstanceView

InstanceViewStatus

KeyVaultSecretReference

Podsourc

Váš názor

Další materiály