Virtuální počítače/rozšíření Microsoft.Compute

• Latest (Nejnovější)
• 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

Definice prostředku Bicep

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

• Skupiny prostředků – viz příkazy pro nasazení skupin 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@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'
  }
}

Hodnoty vlastností

virtualMachines/extensions

Název	Description	Hodnota
name	Název prostředku Podívejte se, jak nastavit názvy a typy pro podřízené prostředky v nástroji Bicep.	string (povinné)
location	Umístění prostředku	řetězec
tags	Značky prostředků	Slovník názvů a hodnot značek. Zobrazit značky v šablonách
Nadřazené	V nástroji Bicep můžete zadat nadřazený prostředek podřízeného prostředku. Tuto vlastnost stačí 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
properties	Popisuje vlastnosti rozšíření virtuálního počítače.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Název	Description	Hodnota
autoUpgradeMinorVersion	Určuje, jestli by rozšíření mělo používat novější podverzi, pokud je k dispozici v době nasazení. Po nasazení ale rozšíření neupgraduje podverze, pokud se nenasadí znovu, 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	Rozšíření chrání nastavení, která se předávají odkazem a využívají se z trezoru klíčů.	KeyVaultSecretReference
provisionAfterExtensions	Kolekce názvů rozšíření, po jejichž uplynutí je potřeba toto rozšíření zřídit.	string[]
vydavatel	Název vydavatele obslužné rutiny rozšíření.	řetězec
nastavení	Veřejná nastavení rozšíření ve formátu JSON	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 nepřipojení k virtuálnímu počítači, nebudou potlačeny bez ohledu na tuto hodnotu). Výchozí hodnotou je hodnota 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

Název	Description	Hodnota
name	Název rozšíření virtuálního počítače.	řetězec
Stavy	Informace o stavu zdroje.	InstanceViewStatus[]
dílčí stav	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

Název	Description	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
time	Čas stavu.	řetězec

KeyVaultSecretReference

Název	Description	Hodnota
adresa URL tajného kódu	Adresa URL odkazující na tajný kód v Key Vault.	string (povinné)
sourceVault	Relativní adresa URL Key Vault obsahující tajný kód.	Dílčí zdroj (povinné)

Dílčí zdroj

Název	Description	Hodnota
id	ID prostředku	řetězec

Šablony pro rychlý start

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

Template (Šablona)	Description
Vytvoření virtuálního počítače s Windows s povoleným antimalwarovým rozšířením	Tato šablona vytvoří virtuální počítač s Windows a nastaví antimalwarovou ochranu.
Server IIS využívající rozšíření DSC na virtuálním počítači s Windows	Tato šablona vytvoří virtuální počítač s Windows a nastaví server služby IIS pomocí rozšíření DSC. Poznámka: Konfigurační modul DSC vyžaduje předání tokenu SAS, pokud používáte Službu Azure Storage. V případě odkazu na modul DSC z GitHubu (výchozí nastavení v této šabloně) to není potřeba.
ESET VM Extension	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	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	Tato šablona umožňuje nasadit virtuální počítač s Ubuntu s nainstalovaným rozšířením OMS a nasazeným do zadaného pracovního prostoru.
Nasazení virtuálního počítače s Windows s rozšířením OMS	Tato šablona umožňuje nasadit virtuální počítač s Windows s nainstalovaným rozšířením OMS a onboardovaným do zadaného pracovního prostoru.
Zkušební verze rozšíření Symantec Endpoint Protection na virtuálním počítači s Windows	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	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	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 využitím diagnostiky	Tato šablona umožňuje nasadit virtuální počítač Premium s Windows pomocí několika různých možností pro verzi Windows a nejnovější opravené verze.
Nasazení jednoduchého virtuálního počítače s Windows s monitorováním a diagnostikou	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ů	Tato šablona nasadí a nainstaluje Mongo DB na virtuální počítač s Ubuntu ve dvou samostatných skriptech. Tato šablona je dobrým příkladem, který ukazuje, 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ě, Virtual Network, 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í na:

• Skupiny prostředků – viz příkazy pro nasazení skupin 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í kód JSON.

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

Hodnoty vlastností

virtualMachines/extensions

Název	Description	Hodnota
typ	Typ prostředku	Microsoft.Compute/virtualMachines/extensions
apiVersion	Verze rozhraní API prostředků	'2023-09-01'
name	Název prostředku Podívejte se, jak nastavit názvy a typy pro podřízené prostředky v šablonách JSON ARM.	string (povinné)
location	Umístění prostředku	řetězec
tags	Značky prostředků	Slovník názvů značek a hodnot. Viz Značky v šablonách
properties	Popisuje vlastnosti rozšíření virtuálního počítače.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Název	Description	Hodnota
autoUpgradeMinorVersion	Označuje, jestli by rozšíření mělo 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á platforma rozšíření automaticky upgradovat, pokud je k dispozici novější verze rozšíření.	bool
forceUpdateTag	Způsob, jakým by měla být obslužná rutina rozšíření vynucena k aktualizaci, i když 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 využívána z trezoru klíčů	KeyVaultSecretReference
provisionAfterExtensions	Kolekce názvů rozšíření, po které je potřeba toto rozšíření zřídit.	string[]
vydavatel	Název vydavatele obslužné rutiny rozšíření.	řetězec
nastavení	Veřejná nastavení rozšíření ve formátu JSON
suppressFailures	Označuje, jestli budou potlačena selhání vyplývající z rozšíření (provozní selhání, jako je nepřipojování k virtuálnímu počítači, nebudou potlačeny bez ohledu na tuto hodnotu). Výchozí hodnotou je hodnota 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

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

InstanceViewStatus

Název	Description	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ě upozornění a chybových zpráv.	řetězec
time	Čas stavu.	řetězec

KeyVaultSecretReference

Název	Description	Hodnota
secretUrl	Adresa URL odkazující na tajný kód v Key Vault.	string (povinné)
sourceVault	Relativní adresa URL Key Vault obsahující tajný klíč.	SubResource (povinné)

Dílčí zdroj

Název	Description	Hodnota
id	ID prostředku	řetězec

Šablony pro rychlý start

Následující šablony rychlého startu nasadí tento typ prostředku.

Template (Šablona)	Description
Vytvoření virtuálního počítače s Windows s povoleným antimalwarovým rozšířením	Tato šablona vytvoří virtuální počítač s Windows a nastaví antimalwarovou ochranu.
Server SLUŽBY IIS s využitím rozšíření DSC na virtuálním počítači s Windows	Tato šablona vytvoří virtuální počítač s Windows a nastaví server služby IIS pomocí rozšíření DSC. Všimněte si, že pokud používáte Azure Storage, konfigurační modul DSC musí předat token SAS. Pro odkaz na modul DSC z GitHubu (výchozí v této šabloně) to není potřeba.
Rozšíření ESET pro virtuální počítače	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	Tato šablona vytvoří virtuální počítač s Windows a nastaví zkušební verzi programu McAfee Endpoint Security.
Nasazení virtuálního počítače s Ubuntu s rozšířením OMS	Tato šablona umožňuje nasadit virtuální počítač s Ubuntu s nainstalovaným rozšířením OMS a nasazeným do zadaného pracovního prostoru.
Nasazení virtuálního počítače s Windows s rozšířením OMS	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	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	Tato šablona vytvoří virtuální počítač s Ubuntu a nainstaluje rozšíření CustomScriptu.
Rozšíření oprav operačního systému na virtuálním počítači s Ubuntu	Tato šablona vytvoří virtuální počítač s Ubuntu a nainstaluje rozšíření OSPatching.
Nasazení virtuálního počítače s Windows Premium pomocí diagnostiky	Tato šablona umožňuje nasadit virtuální počítač s Windows Premium pomocí několika různých možností pro verzi Windows s nejnovější opravenou verzí.
Nasazení jednoduchého virtuálního počítače s Windows s monitorováním a diagnostikou	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.
Použití rozšíření skriptů k instalaci Mongo DB na virtuální počítač s Ubuntu	Tato šablona nasadí a nakonfiguruje a nainstaluje Mongo DB na virtuální počítač s Ubuntu ve dvou samostatných skriptech. Tato šablona je dobrým příkladem, který ukazuje, 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ě, Virtual Network, veřejné IP adresy a síťové rozhraní.

Definice prostředku Terraformu (zprostředkovatele AzAPI)

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

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

Hodnoty vlastností

virtualMachines/extensions

Název	Description	Hodnota
typ	Typ prostředku	Microsoft.Compute/virtualMachines/extensions@2023-09-01
name	Název prostředku	string (povinné)
location	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
tags	Značky prostředků	Slovník názvů značek a hodnot.
properties	Popisuje vlastnosti rozšíření virtuálního počítače.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Název	Description	Hodnota
autoUpgradeMinorVersion	Označuje, jestli by rozšíření mělo 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á platforma rozšíření automaticky upgradovat, 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	Rozšíření chrání nastavení, která se předávají odkazem a využívají se z trezoru klíčů.	KeyVaultSecretReference
provisionAfterExtensions	Kolekce názvů rozšíření, po jejichž uplynutí je potřeba toto rozšíření zřídit.	string[]
vydavatel	Název vydavatele obslužné rutiny rozšíření.	řetězec
nastavení	Veřejná nastavení rozšíření ve formátu JSON
suppressFailures	Určuje, jestli se potlačí selhání vyplývající z rozšíření (provozní selhání, jako je nepřipojení k virtuálnímu počítači, nebudou potlačeny bez ohledu na tuto hodnotu). Výchozí hodnotou je hodnota 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

Název	Description	Hodnota
name	Název rozšíření virtuálního počítače.	řetězec
Stavy	Informace o stavu zdroje.	InstanceViewStatus[]
dílčí stav	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

Název	Description	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
time	Čas stavu.	řetězec

KeyVaultSecretReference

Název	Description	Hodnota
adresa URL tajného kódu	Adresa URL odkazující na tajný kód v Key Vault.	string (povinné)
sourceVault	Relativní adresa URL Key Vault obsahující tajný kód.	Dílčí zdroj (povinné)

Dílčí zdroj

Název	Description	Hodnota
id	ID prostředku	řetězec