Microsoft.Compute virtualMachines/extensões
Definição de recursos do bíceps
O tipo de recurso virtualMachines/extensions pode ser implantado com operações que visam:
- Grupos de recursos - Consulte comandos de implantação de grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.Compute/virtualMachines/extensions, adicione o seguinte Bicep ao seu modelo.
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'
}
}
Valores de propriedade
virtualMachines/extensões
| Designação | Descrição | Valor |
|---|---|---|
| Designação | O nome do recurso Veja como definir nomes e tipos para recursos filho no Bicep. |
string (obrigatório) |
| Localização | Localização do recurso | string |
| Etiquetas | Tags de recursos | Dicionário de nomes e valores de tags. Consulte Tags em modelos |
| pai | No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai. Para obter mais informações, consulte recurso filho fora do recurso pai. |
Nome simbólico para recurso do tipo: virtualMachines |
| propriedades | Descreve as propriedades de uma extensão de máquina virtual. | VirtualMachineExtensionProperties |
VirtualMachineExtensionProperties
| Designação | Descrição | Valor |
|---|---|---|
| autoUpgradeMinorVersion | Indica se a extensão deve usar uma versão secundária mais recente, se uma estiver disponível no momento da implantação. Uma vez implantada, no entanto, a extensão não atualizará versões secundárias, a menos que seja reimplantada, mesmo com essa propriedade definida como true. | Bool |
| enableAutomaticUpgrade | Indica se a extensão deve ser atualizada automaticamente pela plataforma se houver uma versão mais recente da extensão disponível. | Bool |
| forceUpdateTag | Como o manipulador de extensão deve ser forçado a atualizar mesmo que a configuração da extensão não tenha sido alterada. | string |
| instânciaVer | A exibição da instância de extensão de máquina virtual. | VirtualMachineExtensionInstanceView |
| protegido Configurações | A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. | Para o Bicep, você pode usar a função any(). |
| protectedSettingsFromKeyVault | As extensões protegem as configurações que são passadas por referência e consumidas do cofre de chaves | KeyVaultSecretReference |
| provisionAfterExtensions | Coleção de nomes de extensão após a qual essa extensão precisa ser provisionada. | string[] |
| editora | O nome do editor do manipulador de extensão. | string |
| Configurações | Json formatou configurações públicas para a extensão. | Para o Bicep, você pode usar a função any(). |
| suprimirFalhas | Indica se as falhas decorrentes da extensão serão suprimidas (Falhas operacionais, como não se conectar à VM, não serão suprimidas, independentemente desse valor). O padrão é false. | Bool |
| tipo | Especifica o tipo da extensão; um exemplo é "CustomScriptExtension". | string |
| typeHandlerVersion | Especifica a versão do manipulador de script. | string |
VirtualMachineExtensionInstanceView
InstanceViewStatus
| Designação | Descrição | Valor |
|---|---|---|
| código | O código de status. | string |
| displayStatus | O rótulo curto localizável para o status. | string |
| nível | O código de nível. | 'Erro' 'Informações' 'Atenção' |
| Mensagem | A mensagem de status detalhada, inclusive para alertas e mensagens de erro. | string |
| Hora | A hora do status. | string |
KeyVaultSecretReference
Subrecurso
| Designação | Descrição | Valor |
|---|---|---|
| ID | ID do recurso | string |
Modelos de início rápido
Os modelos de início rápido a seguir implantam esse tipo de recurso.
| Modelo | Descrição |
|---|---|
Criar uma VM do Windows com a extensão Antimalware ativada
|
Este modelo cria uma VM do Windows e configura a proteção Antimalware |
|
servidor IIS usando a extensão DSC em um de VM do Windows
|
Este modelo cria uma VM do Windows e configura um servidor IIS usando a extensão DSC. Observe que o módulo de configuração DSC precisa de um token SAS para ser passado se você estiver usando o Armazenamento do Azure. Para o link do módulo DSC do GitHub (padrão neste modelo), isso não é necessário. |
|
Extensão ESET VM
|
Cria uma VM com extensão ESET |
|
McAfee Endpoint Security (licença de avaliação) no Windows VM
|
Este modelo cria uma VM do Windows e configura uma versão de avaliação do McAfee Endpoint Security |
|
Implantar uma VM do Ubuntu com a extensão OMS
|
Este modelo permite que você implante uma VM do Ubuntu com a extensão OMS instalada e integrada a um espaço de trabalho especificado |
|
implantar uma VM do Windows com a extensão OMS
|
Este modelo permite implantar uma VM do Windows com a extensão do OMS instalada e integrada a um espaço de trabalho especificado |
|
versão de avaliação da extensão do Symantec Endpoint Protection no Windows VM
|
Este modelo cria uma VM do Windows e configura uma versão de avaliação do Symantec Endpoint Protection |
|
extensão de script personalizado em um Ubuntu VM
|
Este modelo cria uma VM Ubuntu e instala a extensão CustomScript |
|
extensão de aplicação de patches do sistema operacional em um de VM do Ubuntu
|
Este modelo cria uma VM Ubuntu e instala a extensão OSPatching |
|
implantar uma VM Premium do Windows com de diagnóstico
|
Este modelo permite que você implante uma VM Premium do Windows usando algumas opções diferentes para a versão do Windows, usando a versão corrigida mais recente. |
|
Implante uma VM simples do Windows com monitoramento e diagnóstico
|
Este modelo permite implantar uma VM simples do Windows junto com a extensão de diagnóstico que permite o monitoramento e o diagnóstico para a VM |
|
Use extensões de script para instalar o Mongo DB no Ubuntu VM
|
Este modelo implanta Configura e Instala o Mongo DB em uma Máquina Virtual Ubuntu em dois scripts separados. Este modelo é um bom exemplo que mostra como expressar dependências entre dois scripts em execução na mesma máquina virtual. Este modelo também implanta uma Conta de Armazenamento, Rede Virtual, Endereços IP Públicos e uma Interface de Rede. |
Definição de recurso de modelo ARM
O tipo de recurso virtualMachines/extensions pode ser implantado com operações que visam:
- Grupos de recursos - Consulte comandos de implantação de grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.Compute/virtualMachines/extensions, adicione o seguinte JSON ao seu modelo.
{
"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"
}
}
Valores de propriedade
virtualMachines/extensões
| Designação | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | 'Microsoft.Compute/virtualMachines/extensions' |
| apiVersion | A versão da api de recursos | '2024-07-01' |
| Designação | O nome do recurso Veja como definir nomes e tipos para recursos filho em modelos JSON ARM. |
string (obrigatório) |
| Localização | Localização do recurso | string |
| Etiquetas | Tags de recursos | Dicionário de nomes e valores de tags. Consulte Tags em modelos |
| propriedades | Descreve as propriedades de uma extensão de máquina virtual. | VirtualMachineExtensionProperties |
VirtualMachineExtensionProperties
VirtualMachineExtensionInstanceView
InstanceViewStatus
| Designação | Descrição | Valor |
|---|---|---|
| código | O código de status. | string |
| displayStatus | O rótulo curto localizável para o status. | string |
| nível | O código de nível. | 'Erro' 'Informações' 'Atenção' |
| Mensagem | A mensagem de status detalhada, inclusive para alertas e mensagens de erro. | string |
| Hora | A hora do status. | string |
KeyVaultSecretReference
Subrecurso
| Designação | Descrição | Valor |
|---|---|---|
| ID | ID do recurso | string |
Modelos de início rápido
Os modelos de início rápido a seguir implantam esse tipo de recurso.
| Modelo | Descrição |
|---|---|
|
Criar uma VM do Windows com a extensão Antimalware ativada
|
Este modelo cria uma VM do Windows e configura a proteção Antimalware |
|
servidor IIS usando a extensão DSC em um de VM do Windows
|
Este modelo cria uma VM do Windows e configura um servidor IIS usando a extensão DSC. Observe que o módulo de configuração DSC precisa de um token SAS para ser passado se você estiver usando o Armazenamento do Azure. Para o link do módulo DSC do GitHub (padrão neste modelo), isso não é necessário. |
|
Extensão ESET VM
|
Cria uma VM com extensão ESET |
|
McAfee Endpoint Security (licença de avaliação) no Windows VM
|
Este modelo cria uma VM do Windows e configura uma versão de avaliação do McAfee Endpoint Security |
|
Implantar uma VM do Ubuntu com a extensão OMS
|
Este modelo permite que você implante uma VM do Ubuntu com a extensão OMS instalada e integrada a um espaço de trabalho especificado |
|
implantar uma VM do Windows com a extensão OMS
|
Este modelo permite implantar uma VM do Windows com a extensão do OMS instalada e integrada a um espaço de trabalho especificado |
|
versão de avaliação da extensão do Symantec Endpoint Protection no Windows VM
|
Este modelo cria uma VM do Windows e configura uma versão de avaliação do Symantec Endpoint Protection |
|
extensão de script personalizado em um Ubuntu VM
|
Este modelo cria uma VM Ubuntu e instala a extensão CustomScript |
|
extensão de aplicação de patches do sistema operacional em um de VM do Ubuntu
|
Este modelo cria uma VM Ubuntu e instala a extensão OSPatching |
|
implantar uma VM Premium do Windows com de diagnóstico
|
Este modelo permite que você implante uma VM Premium do Windows usando algumas opções diferentes para a versão do Windows, usando a versão corrigida mais recente. |
|
Implante uma VM simples do Windows com monitoramento e diagnóstico
|
Este modelo permite implantar uma VM simples do Windows junto com a extensão de diagnóstico que permite o monitoramento e o diagnóstico para a VM |
|
Use extensões de script para instalar o Mongo DB no Ubuntu VM
|
Este modelo implanta Configura e Instala o Mongo DB em uma Máquina Virtual Ubuntu em dois scripts separados. Este modelo é um bom exemplo que mostra como expressar dependências entre dois scripts em execução na mesma máquina virtual. Este modelo também implanta uma Conta de Armazenamento, Rede Virtual, Endereços IP Públicos e uma Interface de Rede. |
Definição de recursos Terraform (provedor AzAPI)
O tipo de recurso virtualMachines/extensions pode ser implantado com operações que visam:
- Grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.Compute/virtualMachines/extensions, adicione o seguinte Terraform ao seu modelo.
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"
}
})
}
Valores de propriedade
virtualMachines/extensões
| Designação | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.Compute/virtualMachines/extensions@2024-07-01" |
| Designação | O nome do recurso | string (obrigatório) |
| Localização | Localização do recurso | string |
| parent_id | A ID do recurso que é o pai para este recurso. | ID do recurso do tipo: virtualMachines |
| Etiquetas | Tags de recursos | Dicionário de nomes e valores de tags. |
| propriedades | Descreve as propriedades de uma extensão de máquina virtual. | VirtualMachineExtensionProperties |
VirtualMachineExtensionProperties
VirtualMachineExtensionInstanceView
InstanceViewStatus
| Designação | Descrição | Valor |
|---|---|---|
| código | O código de status. | string |
| displayStatus | O rótulo curto localizável para o status. | string |
| nível | O código de nível. | "Erro" "Informações" "Atenção" |
| Mensagem | A mensagem de status detalhada, inclusive para alertas e mensagens de erro. | string |
| Hora | A hora do status. | string |
KeyVaultSecretReference
Subrecurso
| Designação | Descrição | Valor |
|---|---|---|
| ID | ID do recurso | string |