Microsoft.Compute virtualMachineScaleSets/extensions
Definição de recurso do Bicep
O tipo de recurso virtualMachineScaleSets/extensions pode ser implantado com operações direcionadas:
- Grupos de recursos – Consulte comandos de implantação do grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.Compute/virtualMachineScaleSets/extensions, adicione o Bicep a seguir ao modelo.
resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets/extensions@2023-09-01' = {
name: 'string'
parent: resourceSymbolicName
properties: {
autoUpgradeMinorVersion: bool
enableAutomaticUpgrade: bool
forceUpdateTag: '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/extensions
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso Veja como definir nomes e tipos para recursos filho no Bicep. |
cadeia de caracteres (obrigatório) |
| 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 o recurso do tipo: virtualMachineScaleSets |
| properties | Descreve as propriedades de uma extensão de conjunto de dimensionamento de máquinas virtuais. | VirtualMachineScaleSetExtensionProperties |
VirtualMachineScaleSetExtensionProperties
| Nome | 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. Após a implantação, no entanto, a extensão não atualizará as versões secundárias, a menos que seja reimplantada, mesmo com essa propriedade definida como verdadeira. | 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 | Se um valor for fornecido e for diferente do valor anterior, o manipulador de extensão será forçado a atualizar mesmo que a configuração da extensão não tenha sido alterada. | string |
| protectedSettings | 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 protegeram 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 os quais essa extensão precisa ser provisionada. | string[] |
| publicador | O nome do editor do manipulador de extensão. | string |
| configurações | Configurações públicas formatadas em Json para a extensão. | Para o Bicep, você pode usar a função any(). |
| suppressFailures | 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 |
KeyVaultSecretReference
| Nome | Descrição | Valor |
|---|---|---|
| secretUrl | A URL que faz referência a um segredo em um Key Vault. | cadeia de caracteres (obrigatório) |
| sourceVault | A URL relativa do Key Vault que contém o segredo. | SubResource (obrigatório) |
SubResource
| Nome | 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 |
|---|---|
Implantar o Dimensionamento Automático do Darktrace vSensors |
Este modelo permite implantar automaticamente uma implantação de dimensionamento automático de vSensors do Darktrace |
| Este modelo descriptografa VMSS do Windows criptografada anteriormente |
Este modelo desabilita a criptografia em um conjunto de dimensionamento de VMs do Windows em execução |
| Este modelo criptografa uma VMSS do Windows em execução |
Este modelo habilita a criptografia em um Conjunto de Dimensionamento de VMs do Windows em execução |
| Criar e criptografar um novo VMSS do Windows com jumpbox |
Este modelo permite implantar um conjunto de dimensionamento de VMs simples de VMs do Windows usando a última versão corrigida das versões serveral do Windows. Esse modelo também implanta um jumpbox com um endereço IP público na mesma rede virtual. Você pode se conectar ao jumpbox por meio desse endereço IP público e, em seguida, conectar-se de lá a VMs no conjunto de dimensionamento por meio de endereços IP privados. Este modelo habilita a criptografia no Conjunto de Dimensionamento de VMs do Windows. |
| Implantar um conjunto de dimensionamento de VMs do Windows com capacidade de inicialização confiável |
Este modelo permite que você implante um conjunto de dimensionamento de VMs com capacidade de inicialização confiável de VMs do Windows usando a versão mais recente corrigida do Windows Server 2016, Windows Server 2019 ou Windows Server 2022 Azure Edition. Essas VMs estão atrás de um balanceador de carga com regras NAT para conexões RDP. Se você habilitar Secureboot e vTPM, a extensão Atestado de Convidado será instalada em seu VMSS. Essa extensão executará o atestado remoto pela nuvem. |
Definição de recurso de modelo do ARM
O tipo de recurso virtualMachineScaleSets/extensions pode ser implantado com operações direcionadas:
- Grupos de recursos – Consulte comandos de implantação do grupo de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.Compute/virtualMachineScaleSets/extensions, adicione o JSON a seguir ao modelo.
{
"type": "Microsoft.Compute/virtualMachineScaleSets/extensions",
"apiVersion": "2023-09-01",
"name": "string",
"properties": {
"autoUpgradeMinorVersion": "bool",
"enableAutomaticUpgrade": "bool",
"forceUpdateTag": "string",
"protectedSettings": {},
"protectedSettingsFromKeyVault": {
"secretUrl": "string",
"sourceVault": {
"id": "string"
}
},
"provisionAfterExtensions": [ "string" ],
"publisher": "string",
"settings": {},
"suppressFailures": "bool",
"type": "string",
"typeHandlerVersion": "string"
}
}
Valores de propriedade
virtualMachines/extensions
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | 'Microsoft.Compute/virtualMachineScaleSets/extensions' |
| apiVersion | A versão da API do recurso | '2023-09-01' |
| name | O nome do recurso Veja como definir nomes e tipos para recursos filho em modelos do ARM JSON. |
cadeia de caracteres (obrigatório) |
| properties | Descreve as propriedades de uma extensão de conjunto de dimensionamento de máquinas virtuais. | VirtualMachineScaleSetExtensionProperties |
VirtualMachineScaleSetExtensionProperties
| Nome | 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. Após a implantação, no entanto, a extensão não atualizará as versões secundárias, a menos que seja reimplantada, mesmo com essa propriedade definida como verdadeira. | 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 | Se um valor for fornecido e for diferente do valor anterior, o manipulador de extensão será forçado a atualizar mesmo que a configuração da extensão não tenha sido alterada. | string |
| protectedSettings | A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. | |
| protectedSettingsFromKeyVault | As configurações protegidas por extensõ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 os quais essa extensão precisa ser provisionada. | string[] |
| publicador | O nome do editor do manipulador de extensão. | string |
| configurações | Configurações públicas formatadas em Json para a extensão. | |
| suppressFailures | 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 |
KeyVaultSecretReference
| Nome | Descrição | Valor |
|---|---|---|
| secretUrl | A URL que faz referência a um segredo em um Key Vault. | cadeia de caracteres (obrigatório) |
| sourceVault | A URL relativa do Key Vault que contém o segredo. | SubResource (obrigatório) |
SubResource
| Nome | 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 |
|---|---|
| Implantar o Dimensionamento Automático do Darktrace vSensors |
Este modelo permite implantar automaticamente uma implantação de dimensionamento automático de vSensors do Darktrace |
| Este modelo descriptografa VMSS do Windows criptografado anteriormente |
Este modelo desabilita a criptografia em um Conjunto de Dimensionamento de VMs do Windows em execução |
| Este modelo criptografa um VMSS do Windows em execução |
Este modelo habilita a criptografia em um Conjunto de Dimensionamento de VMs do Windows em execução |
| Criar e criptografar um novo VMSS do Windows com jumpbox |
Esse modelo permite implantar um conjunto de dimensionamento de VMs simples de VMs do Windows usando a última versão corrigida das versões serveral do Windows. Esse modelo também implanta um jumpbox com um endereço IP público na mesma rede virtual. Você pode se conectar ao jumpbox por meio desse endereço IP público e, em seguida, conectar-se de lá a VMs no conjunto de dimensionamento por meio de endereços IP privados. Esse modelo habilita a criptografia no Conjunto de Dimensionamento de VMs do Windows. |
| Implantar um Conjunto de Dimensionamento de VMs do Windows com capacidade de inicialização confiável |
Este modelo permite implantar um conjunto de dimensionamento de VMs com capacidade de inicialização confiável de VMs do Windows usando a versão mais recente corrigida do Windows Server 2016, Windows Server 2019 ou Windows Server 2022 Azure Edition. Essas VMs estão por trás de um balanceador de carga com regras NAT para conexões RDP. Se você habilitar Secureboot e vTPM, a extensão atestado de convidado será instalada em seu VMSS. Essa extensão executará o atestado remoto pela nuvem. |
Definição de recurso do Terraform (provedor AzAPI)
O tipo de recurso virtualMachineScaleSets/extensions pode ser implantado com operações direcionadas:
- Grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.Compute/virtualMachineScaleSets/extensions, adicione o Terraform a seguir ao modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/virtualMachineScaleSets/extensions@2023-09-01"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
autoUpgradeMinorVersion = bool
enableAutomaticUpgrade = bool
forceUpdateTag = "string"
protectedSettingsFromKeyVault = {
secretUrl = "string"
sourceVault = {
id = "string"
}
}
provisionAfterExtensions = [
"string"
]
publisher = "string"
suppressFailures = bool
type = "string"
typeHandlerVersion = "string"
}
})
}
Valores de propriedade
virtualMachines/extensions
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.Compute/virtualMachineScaleSets/extensions@2023-09-01" |
| name | O nome do recurso | cadeia de caracteres (obrigatório) |
| parent_id | A ID do recurso que é o pai desse recurso. | ID do recurso do tipo: virtualMachineScaleSets |
| properties | Descreve as propriedades de uma extensão de conjunto de dimensionamento de máquinas virtuais. | VirtualMachineScaleSetExtensionProperties |
VirtualMachineScaleSetExtensionProperties
| Nome | 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. Após a implantação, no entanto, a extensão não atualizará as versões secundárias, a menos que seja reimplantada, mesmo com essa propriedade definida como verdadeira. | 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 | Se um valor for fornecido e for diferente do valor anterior, o manipulador de extensão será forçado a atualizar mesmo que a configuração da extensão não tenha sido alterada. | string |
| protectedSettings | A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. | |
| protectedSettingsFromKeyVault | As extensões protegeram 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 os quais essa extensão precisa ser provisionada. | string[] |
| publicador | O nome do editor do manipulador de extensão. | string |
| configurações | Configurações públicas formatadas em Json para a extensão. | |
| suppressFailures | 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 |
KeyVaultSecretReference
| Nome | Descrição | Valor |
|---|---|---|
| secretUrl | A URL que faz referência a um segredo em um Key Vault. | cadeia de caracteres (obrigatório) |
| sourceVault | A URL relativa do Key Vault que contém o segredo. | SubResource (obrigatório) |
SubResource
| Nome | Descrição | Valor |
|---|---|---|
| id | ID do recurso | string |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de