Microsoft.Compute virtualMachines/extensions 2023-09-01
Definizione di risorsa Bicep
Il tipo di risorsa virtualMachines/extensions può essere distribuito con operazioni destinate a:
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@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'
}
}
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
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 |
Questo modello crea una macchina virtuale Windows e configura la protezione antimalware |
server IIS usando l'estensione DSC in una macchina virtuale Windows |
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 |
Crea una macchina virtuale con estensione ESET |
McAfee Endpoint Security (licenza di valutazione) nella macchina virtuale Windows |
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 |
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 |
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 |
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 |
Questo modello crea una macchina virtuale Ubuntu e installa l'estensione CustomScript |
'estensione patch del sistema operativo in una macchina virtuale Ubuntu |
Questo modello crea una macchina virtuale Ubuntu e installa l'estensione OSPatching |
Distribuire una macchina virtuale Windows Premium con di diagnostica |
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 |
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 |
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:
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": "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"
}
}
Valori delle proprietà
virtualMachines/extensions
Nome | Descrizione | Valore |
---|---|---|
digitare | Tipo di risorsa | 'Microsoft.Compute/virtualMachines/extensions' |
apiVersion | Versione dell'API della risorsa | '2023-09-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
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 |
Questo modello crea una macchina virtuale Windows e configura la protezione antimalware |
server IIS usando l'estensione DSC in una macchina virtuale Windows |
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 |
Crea una macchina virtuale con estensione ESET |
McAfee Endpoint Security (licenza di valutazione) nella macchina virtuale Windows |
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 |
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 |
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 |
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 |
Questo modello crea una macchina virtuale Ubuntu e installa l'estensione CustomScript |
'estensione patch del sistema operativo in una macchina virtuale Ubuntu |
Questo modello crea una macchina virtuale Ubuntu e installa l'estensione OSPatching |
Distribuire una macchina virtuale Windows Premium con di diagnostica |
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 |
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 |
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@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"
}
})
}
Valori delle proprietà
virtualMachines/extensions
Nome | Descrizione | Valore |
---|---|---|
digitare | Tipo di risorsa | "Microsoft.Compute/virtualMachines/extensions@2023-09-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
Sottorisorsa
Nome | Descrizione | Valore |
---|---|---|
Id | ID risorsa | corda |