Condividi tramite

Microsoft.Compute virtualMachines/extensions

  • Articolo

Definizione di risorsa Bicep

Il tipo di risorsa virtualMachines/extensions può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Compute/virtualMachines/extensions, aggiungere il bicep seguente al modello.

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

Valori delle proprietà

virtualMachines/extensions

Nome Descrizione Valore
nome Nome della risorsa

Vedere come impostare nomi e tipi per le risorse figlio in Bicep.		 stringa (obbligatorio)
ubicazione Percorso risorsa corda
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
genitore In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.		 Nome simbolico per la risorsa di tipo: virtualMachines
proprietà Descrive le proprietà di un'estensione macchina virtuale. VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Nome Descrizione Valore
autoUpgradeMinorVersion Indica se l'estensione deve usare una versione secondaria più recente, se disponibile in fase di distribuzione. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie a meno che non venga ridistribuibile, anche con questa proprietà impostata su true. Bool
enableAutomaticUpgrade Indica se l'estensione deve essere aggiornata automaticamente dalla piattaforma se è disponibile una versione più recente dell'estensione. Bool
forceUpdateTag Come deve essere forzato l'aggiornamento del gestore di estensioni anche se la configurazione dell'estensione non è stata modificata. corda
instanceView Visualizzazione dell'istanza dell'estensione della macchina virtuale. VirtualMachineExtensionInstanceView
protectedSettings L'estensione può contenere protectedSettings o protectedSettingsFromKeyVault o nessuna impostazione protetta. Per Bicep, è possibile usare la funzione any() .
protectedSettingsFromKeyVault Impostazioni protette delle estensioni passate per riferimento e utilizzate dall'insieme di credenziali delle chiavi KeyVaultSecretReference
provisionAfterExtensions Raccolta di nomi di estensione dopo i quali è necessario effettuare il provisioning di questa estensione. string[]
editore Nome del server di pubblicazione del gestore dell'estensione. corda
Impostazioni Impostazioni pubbliche in formato JSON per l'estensione. Per Bicep, è possibile usare la funzione any() .
suppressFailures Indica se gli errori derivanti dall'estensione verranno eliminati (gli errori operativi, ad esempio la mancata connessione alla macchina virtuale, non verranno eliminati indipendentemente da questo valore). Il valore predefinito è false. Bool
digitare Specifica il tipo di estensione; un esempio è "CustomScriptExtension". corda
typeHandlerVersion Specifica la versione del gestore di script. corda

VirtualMachineExtensionInstanceView

Nome Descrizione Valore
nome Nome dell'estensione della macchina virtuale. corda
Stati Informazioni sullo stato della risorsa. InstanceViewStatus[]
substatuses Informazioni sullo stato della risorsa. InstanceViewStatus[]
digitare Specifica il tipo di estensione; un esempio è "CustomScriptExtension". corda
typeHandlerVersion Specifica la versione del gestore di script. corda

InstanceViewStatus

Nome Descrizione Valore
codice Codice di stato. corda
displayStatus Etichetta localizzabile breve per lo stato. corda
livello Codice a livello. 'Error'
'Info'
'Avviso'
Messaggio Messaggio di stato dettagliato, inclusi gli avvisi e i messaggi di errore. corda
Ore Ora dello stato. corda

KeyVaultSecretReference

Nome Descrizione Valore
secretUrl URL che fa riferimento a un segreto in un insieme di credenziali delle chiavi. stringa (obbligatorio)
sourceVault URL relativo dell'insieme di credenziali delle chiavi contenente il segreto. SubResource (obbligatorio)

Sottorisorsa

Nome Descrizione Valore
Id ID risorsa corda

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Sagoma Descrizione
Creare una macchina virtuale Windows con l'estensione antimalware abilitata

Distribuire in Azure 		Questo modello crea una macchina virtuale Windows e configura la protezione antimalware
server IIS usando l'estensione DSC in una macchina virtuale Windows

Distribuire in Azure 		Questo modello crea una macchina virtuale Windows e configura un server IIS usando l'estensione DSC. Si noti che il modulo di configurazione DSC richiede che venga passato un token di firma di accesso condiviso se si usa Archiviazione di Azure. Per il collegamento al modulo DSC da GitHub (impostazione predefinita in questo modello), non è necessario.
estensione macchina virtuale ESET

Distribuire in Azure 		Crea una macchina virtuale con estensione ESET
McAfee Endpoint Security (licenza di valutazione) nella macchina virtuale Windows

Distribuire in Azure 		Questo modello crea una macchina virtuale Windows e configura una versione di valutazione di McAfee Endpoint Security
Distribuire una macchina virtuale Ubuntu con l'estensione OMS

Distribuire in Azure 		Questo modello consente di distribuire una macchina virtuale Ubuntu con l'estensione OMS installata e di cui è stato eseguito l'onboarding in un'area di lavoro specificata
Distribuire una macchina virtuale Windows con l'estensione OMS

Distribuire in Azure 		Questo modello consente di distribuire una macchina virtuale Windows con l'estensione OMS installata e di cui è stato eseguito l'onboarding in un'area di lavoro specificata
versione di valutazione dell'estensione Symantec Endpoint Protection nella macchina virtuale Windows

Distribuire in Azure 		Questo modello crea una macchina virtuale Windows e configura una versione di valutazione di Symantec Endpoint Protection
'estensione script personalizzato in una macchina virtuale Ubuntu

Distribuire in Azure 		Questo modello crea una macchina virtuale Ubuntu e installa l'estensione CustomScript
'estensione patch del sistema operativo in una macchina virtuale Ubuntu

Distribuire in Azure 		Questo modello crea una macchina virtuale Ubuntu e installa l'estensione OSPatching
Distribuire una macchina virtuale Windows Premium con di diagnostica

Distribuire in Azure 		Questo modello consente di distribuire una macchina virtuale Windows Premium usando alcune opzioni diverse per la versione di Windows, usando la versione più recente con patch.
Distribuire una macchina virtuale Windows semplice con monitoraggio e diagnostica

Distribuire in Azure 		Questo modello consente di distribuire una semplice macchina virtuale Windows insieme all'estensione di diagnostica che consente il monitoraggio e la diagnostica per la macchina virtuale
Usare le estensioni di script per installare Mongo DB in una macchina virtuale Ubuntu

Distribuire in Azure 		Questo modello distribuisce Configura e installa Mongo DB in una macchina virtuale Ubuntu in due script separati. Questo modello è un buon esempio che illustra come esprimere le dipendenze tra due script in esecuzione nella stessa macchina virtuale. Questo modello distribuisce anche un account di archiviazione, una rete virtuale, indirizzi IP pubblici e un'interfaccia di rete.

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa virtualMachines/extensions può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Compute/virtualMachines/extensions, aggiungere il codice JSON seguente al modello.

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

Valori delle proprietà

virtualMachines/extensions

Nome Descrizione Valore
digitare Tipo di risorsa 'Microsoft.Compute/virtualMachines/extensions'
apiVersion Versione dell'API della risorsa '2024-07-01'
nome Nome della risorsa

Vedere come impostare nomi e tipi per le risorse figlio in modelli DI Resource Manager JSON.		 stringa (obbligatorio)
ubicazione Percorso risorsa corda
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
proprietà Descrive le proprietà di un'estensione macchina virtuale. VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Nome Descrizione Valore
autoUpgradeMinorVersion Indica se l'estensione deve usare una versione secondaria più recente, se disponibile in fase di distribuzione. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie a meno che non venga ridistribuibile, anche con questa proprietà impostata su true. Bool
enableAutomaticUpgrade Indica se l'estensione deve essere aggiornata automaticamente dalla piattaforma se è disponibile una versione più recente dell'estensione. Bool
forceUpdateTag Come deve essere forzato l'aggiornamento del gestore di estensioni anche se la configurazione dell'estensione non è stata modificata. corda
instanceView Visualizzazione dell'istanza dell'estensione della macchina virtuale. VirtualMachineExtensionInstanceView
protectedSettings L'estensione può contenere protectedSettings o protectedSettingsFromKeyVault o nessuna impostazione protetta.
protectedSettingsFromKeyVault Impostazioni protette delle estensioni passate per riferimento e utilizzate dall'insieme di credenziali delle chiavi KeyVaultSecretReference
provisionAfterExtensions Raccolta di nomi di estensione dopo i quali è necessario effettuare il provisioning di questa estensione. string[]
editore Nome del server di pubblicazione del gestore dell'estensione. corda
Impostazioni Impostazioni pubbliche in formato JSON per l'estensione.
suppressFailures Indica se gli errori derivanti dall'estensione verranno eliminati (gli errori operativi, ad esempio la mancata connessione alla macchina virtuale, non verranno eliminati indipendentemente da questo valore). Il valore predefinito è false. Bool
digitare Specifica il tipo di estensione; un esempio è "CustomScriptExtension". corda
typeHandlerVersion Specifica la versione del gestore di script. corda

VirtualMachineExtensionInstanceView

Nome Descrizione Valore
nome Nome dell'estensione della macchina virtuale. corda
Stati Informazioni sullo stato della risorsa. InstanceViewStatus[]
substatuses Informazioni sullo stato della risorsa. InstanceViewStatus[]
digitare Specifica il tipo di estensione; un esempio è "CustomScriptExtension". corda
typeHandlerVersion Specifica la versione del gestore di script. corda

InstanceViewStatus

Nome Descrizione Valore
codice Codice di stato. corda
displayStatus Etichetta localizzabile breve per lo stato. corda
livello Codice a livello. 'Error'
'Info'
'Avviso'
Messaggio Messaggio di stato dettagliato, inclusi gli avvisi e i messaggi di errore. corda
Ore Ora dello stato. corda

KeyVaultSecretReference

Nome Descrizione Valore
secretUrl URL che fa riferimento a un segreto in un insieme di credenziali delle chiavi. stringa (obbligatorio)
sourceVault URL relativo dell'insieme di credenziali delle chiavi contenente il segreto. SubResource (obbligatorio)

Sottorisorsa

Nome Descrizione Valore
Id ID risorsa corda

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Sagoma Descrizione
Creare una macchina virtuale Windows con l'estensione antimalware abilitata

Distribuire in Azure 		Questo modello crea una macchina virtuale Windows e configura la protezione antimalware
server IIS usando l'estensione DSC in una macchina virtuale Windows

Distribuire in Azure 		Questo modello crea una macchina virtuale Windows e configura un server IIS usando l'estensione DSC. Si noti che il modulo di configurazione DSC richiede che venga passato un token di firma di accesso condiviso se si usa Archiviazione di Azure. Per il collegamento al modulo DSC da GitHub (impostazione predefinita in questo modello), non è necessario.
estensione macchina virtuale ESET

Distribuire in Azure 		Crea una macchina virtuale con estensione ESET
McAfee Endpoint Security (licenza di valutazione) nella macchina virtuale Windows

Distribuire in Azure 		Questo modello crea una macchina virtuale Windows e configura una versione di valutazione di McAfee Endpoint Security
Distribuire una macchina virtuale Ubuntu con l'estensione OMS

Distribuire in Azure 		Questo modello consente di distribuire una macchina virtuale Ubuntu con l'estensione OMS installata e di cui è stato eseguito l'onboarding in un'area di lavoro specificata
Distribuire una macchina virtuale Windows con l'estensione OMS

Distribuire in Azure 		Questo modello consente di distribuire una macchina virtuale Windows con l'estensione OMS installata e di cui è stato eseguito l'onboarding in un'area di lavoro specificata
versione di valutazione dell'estensione Symantec Endpoint Protection nella macchina virtuale Windows

Distribuire in Azure 		Questo modello crea una macchina virtuale Windows e configura una versione di valutazione di Symantec Endpoint Protection
'estensione script personalizzato in una macchina virtuale Ubuntu

Distribuire in Azure 		Questo modello crea una macchina virtuale Ubuntu e installa l'estensione CustomScript
'estensione patch del sistema operativo in una macchina virtuale Ubuntu

Distribuire in Azure 		Questo modello crea una macchina virtuale Ubuntu e installa l'estensione OSPatching
Distribuire una macchina virtuale Windows Premium con di diagnostica

Distribuire in Azure 		Questo modello consente di distribuire una macchina virtuale Windows Premium usando alcune opzioni diverse per la versione di Windows, usando la versione più recente con patch.
Distribuire una macchina virtuale Windows semplice con monitoraggio e diagnostica

Distribuire in Azure 		Questo modello consente di distribuire una semplice macchina virtuale Windows insieme all'estensione di diagnostica che consente il monitoraggio e la diagnostica per la macchina virtuale
Usare le estensioni di script per installare Mongo DB in una macchina virtuale Ubuntu

Distribuire in Azure 		Questo modello distribuisce Configura e installa Mongo DB in una macchina virtuale Ubuntu in due script separati. Questo modello è un buon esempio che illustra come esprimere le dipendenze tra due script in esecuzione nella stessa macchina virtuale. Questo modello distribuisce anche un account di archiviazione, una rete virtuale, indirizzi IP pubblici e un'interfaccia di rete.

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa virtualMachines/extensions può essere distribuito con operazioni destinate a:

  • gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Compute/virtualMachines/extensions, aggiungere il file Terraform seguente al modello.

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

Valori delle proprietà

virtualMachines/extensions

Nome Descrizione Valore
digitare Tipo di risorsa "Microsoft.Compute/virtualMachines/extensions@2024-07-01"
nome Nome della risorsa stringa (obbligatorio)
ubicazione Percorso risorsa corda
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: virtualMachines
Tag Tag delle risorse Dizionario di nomi e valori di tag.
proprietà Descrive le proprietà di un'estensione macchina virtuale. VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Nome Descrizione Valore
autoUpgradeMinorVersion Indica se l'estensione deve usare una versione secondaria più recente, se disponibile in fase di distribuzione. Dopo la distribuzione, tuttavia, l'estensione non aggiornerà le versioni secondarie a meno che non venga ridistribuibile, anche con questa proprietà impostata su true. Bool
enableAutomaticUpgrade Indica se l'estensione deve essere aggiornata automaticamente dalla piattaforma se è disponibile una versione più recente dell'estensione. Bool
forceUpdateTag Come deve essere forzato l'aggiornamento del gestore di estensioni anche se la configurazione dell'estensione non è stata modificata. corda
instanceView Visualizzazione dell'istanza dell'estensione della macchina virtuale. VirtualMachineExtensionInstanceView
protectedSettings L'estensione può contenere protectedSettings o protectedSettingsFromKeyVault o nessuna impostazione protetta.
protectedSettingsFromKeyVault Impostazioni protette delle estensioni passate per riferimento e utilizzate dall'insieme di credenziali delle chiavi KeyVaultSecretReference
provisionAfterExtensions Raccolta di nomi di estensione dopo i quali è necessario effettuare il provisioning di questa estensione. string[]
editore Nome del server di pubblicazione del gestore dell'estensione. corda
Impostazioni Impostazioni pubbliche in formato JSON per l'estensione.
suppressFailures Indica se gli errori derivanti dall'estensione verranno eliminati (gli errori operativi, ad esempio la mancata connessione alla macchina virtuale, non verranno eliminati indipendentemente da questo valore). Il valore predefinito è false. Bool
digitare Specifica il tipo di estensione; un esempio è "CustomScriptExtension". corda
typeHandlerVersion Specifica la versione del gestore di script. corda

VirtualMachineExtensionInstanceView

Nome Descrizione Valore
nome Nome dell'estensione della macchina virtuale. corda
Stati Informazioni sullo stato della risorsa. InstanceViewStatus[]
substatuses Informazioni sullo stato della risorsa. InstanceViewStatus[]
digitare Specifica il tipo di estensione; un esempio è "CustomScriptExtension". corda
typeHandlerVersion Specifica la versione del gestore di script. corda

InstanceViewStatus

Nome Descrizione Valore
codice Codice di stato. corda
displayStatus Etichetta localizzabile breve per lo stato. corda
livello Codice a livello. "Errore"
"Info"
"Avviso"
Messaggio Messaggio di stato dettagliato, inclusi gli avvisi e i messaggi di errore. corda
Ore Ora dello stato. corda

KeyVaultSecretReference

Nome Descrizione Valore
secretUrl URL che fa riferimento a un segreto in un insieme di credenziali delle chiavi. stringa (obbligatorio)
sourceVault URL relativo dell'insieme di credenziali delle chiavi contenente il segreto. SubResource (obbligatorio)

Sottorisorsa

Nome Descrizione Valore
Id ID risorsa corda