Microsoft.Compute virtualMachineScaleSets/extensions
Definição de recurso do Bicep
O tipo de recurso virtualMachineScaleSets/extensions pode ser implementado com operações que visam:
- Grupos de recursos – veja comandos de implementação de grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.Compute/virtualMachineScaleSets/extensions, adicione o seguinte Bicep ao seu 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
virtualMachineScaleSets/extensions
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso Veja como definir nomes e tipos para recursos subordinados no Bicep. |
cadeia (obrigatório) |
| principal | No Bicep, pode especificar o recurso principal de um recurso subordinado. Só precisa de adicionar esta propriedade quando o recurso subordinado for declarado fora do recurso principal. Para obter mais informações, veja Recurso subordinado fora do recurso principal. |
Nome simbólico para recurso do tipo: virtualMachineScaleSets |
| propriedades | 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 utilizar uma versão secundária mais recente se uma estiver disponível no momento da implementação. No entanto, depois de implementada, a extensão não atualizará versões secundárias, a menos que seja reimplementada, mesmo com esta propriedade definida como verdadeira. | bool |
| enableAutomaticUpgrade | Indica se a extensão deve ser atualizada automaticamente pela plataforma se existir uma versão mais recente da extensão disponível. | bool |
| forceUpdateTag | Se for fornecido um valor e for diferente do valor anterior, o processador de extensões 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 definição protegida. | Para o Bicep, pode utilizar a função any( ). |
| protectedSettingsFromKeyVault | As definições protegidas por extensões que são transmitidas por referência e consumidas a partir do cofre de chaves | KeyVaultSecretReference |
| provisionAfterExtensions | Coleção de nomes de extensões após o qual esta extensão tem de ser aprovisionada. | cadeia[] |
| publicador | O nome do editor do processador de extensões. | string |
| definições | Definições públicas formatadas por Json para a extensão. | Para o Bicep, pode utilizar a função any( ). |
| suppressFailures | Indica se as falhas decorrentes da extensão serão suprimidas (as falhas operacionais, como não ligar à VM, não serão suprimidas independentemente deste valor). A predefinição é falsa. | bool |
| tipo | Especifica o tipo da extensão; um exemplo é "CustomScriptExtension". | string |
| typeHandlerVersion | Especifica a versão do processador de scripts. | string |
KeyVaultSecretReference
| Nome | Descrição | Valor |
|---|---|---|
| secretUrl | O URL que referencia um segredo numa Key Vault. | cadeia (obrigatório) |
| sourceVault | O URL relativo do Key Vault que contém o segredo. | SubResource (obrigatório) |
Sub-origem
| Nome | Descrição | Valor |
|---|---|---|
| ID | ID do Recurso | string |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
Implementar o Dimensionamento Automático de Darktrace vSensors |
Este modelo permite-lhe implementar automaticamente uma implementação de dimensionamento automático de darktrace vSensors |
| Este modelo desencripta o VMSS do Windows previamente encriptado |
Este modelo desativa a encriptação num Conjunto de Dimensionamento de VMs do Windows em execução |
| Este modelo encripta uma VMSS do Windows em execução |
Este modelo ativa a encriptação num Conjunto de Dimensionamento de VMs do Windows em execução |
| Criar e encriptar uma nova VMSS do Windows com jumpbox |
Este modelo permite-lhe implementar um conjunto de dimensionamento de VMs do Windows simples com a última versão corrigida das versões serverais do Windows. Este modelo também implementa uma jumpbox com um endereço IP público na mesma rede virtual. Pode ligar à jumpbox através deste endereço IP público e, em seguida, ligar a partir daí às VMs no conjunto de dimensionamento através de endereços IP privados. Este modelo ativa a encriptação no Conjunto de Dimensionamento de VMs das VMs do Windows. |
| Implementar um Conjunto de Dimensionamento de VMs windows compatível com lançamento fidedigno |
Este modelo permite-lhe implementar um Conjunto de Dimensionamento de VMs com capacidade de lançamento fidedigno de VMs do Windows com a versão mais recente corrigida do Windows Server 2016, Windows Server 2019 ou Windows Server 2022 Azure Edition. Estas VMs estão atrás de um balanceador de carga com regras NAT para ligações RDP. Se ativar o Secureboot e o vTPM, a extensão do Atestado de Convidado será instalada no VMSS. Esta extensão irá executar o atestado remoto pela cloud. |
Definição de recurso de modelo do ARM
O tipo de recurso virtualMachineScaleSets/extensions pode ser implementado com operações que visam:
- Grupos de recursos – veja comandos de implementação de grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.Compute/virtualMachineScaleSets/extensions, adicione o seguinte JSON ao seu 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
virtualMachineScaleSets/extensions
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.Compute/virtualMachineScaleSets/extensions" |
| apiVersion | A versão da API de recursos | '2023-09-01' |
| name | O nome do recurso Veja como definir nomes e tipos para recursos subordinados em modelos do ARM JSON. |
cadeia (obrigatório) |
| propriedades | 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 utilizar uma versão secundária mais recente se uma estiver disponível no momento da implementação. No entanto, depois de implementada, a extensão não atualizará versões secundárias, a menos que seja reimplementada, mesmo com esta propriedade definida como verdadeira. | bool |
| enableAutomaticUpgrade | Indica se a extensão deve ser atualizada automaticamente pela plataforma se existir uma versão mais recente da extensão disponível. | bool |
| forceUpdateTag | Se for fornecido um valor e for diferente do valor anterior, o processador de extensões 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 definição protegida. | |
| protectedSettingsFromKeyVault | As definições protegidas por extensões que são transmitidas por referência e consumidas a partir do cofre de chaves | KeyVaultSecretReference |
| provisionAfterExtensions | Coleção de nomes de extensões após o qual esta extensão tem de ser aprovisionada. | cadeia[] |
| publicador | O nome do editor do processador de extensões. | string |
| definições | Definições públicas formatadas por Json para a extensão. | |
| suppressFailures | Indica se as falhas decorrentes da extensão serão suprimidas (as falhas operacionais, como não ligar à VM, não serão suprimidas independentemente deste valor). A predefinição é falsa. | bool |
| tipo | Especifica o tipo da extensão; um exemplo é "CustomScriptExtension". | string |
| typeHandlerVersion | Especifica a versão do processador de scripts. | string |
KeyVaultSecretReference
| Nome | Descrição | Valor |
|---|---|---|
| secretUrl | O URL que referencia um segredo numa Key Vault. | cadeia (obrigatório) |
| sourceVault | O URL relativo do Key Vault que contém o segredo. | SubResource (obrigatório) |
Sub-origem
| Nome | Descrição | Valor |
|---|---|---|
| ID | ID do Recurso | string |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
| Implementar vSensors de Dimensionamento Automático de Darktrace |
Este modelo permite-lhe implementar automaticamente uma implementação de dimensionamento automático de darktrace vSensors |
| Este modelo desencripta O VMSS do Windows encriptado anteriormente |
Este modelo desativa a encriptação num Conjunto de Dimensionamento de VMs do Windows em execução |
| Este modelo encripta um VMSS do Windows em execução |
Este modelo ativa a encriptação num Conjunto de Dimensionamento de VMs do Windows em execução |
| Criar e encriptar um novo VMSS do Windows com jumpbox |
Este modelo permite-lhe implementar um conjunto de dimensionamento de VMs do Windows simples com a versão mais recente corrigida das versões do Windows serveral. Este modelo também implementa uma jumpbox com um endereço IP público na mesma rede virtual. Pode ligar à jumpbox através deste endereço IP público e, em seguida, ligar a partir daí às VMs no conjunto de dimensionamento através de endereços IP privados. Este modelo ativa a encriptação no Conjunto de Dimensionamento de VMs de VMs do Windows. |
| Implementar um Conjunto de Dimensionamento de VMs windows com capacidade de lançamento fidedigno |
Este modelo permite-lhe implementar um Conjunto de Dimensionamento de VMs windows com capacidade de lançamento fidedigno através da versão mais recente corrigida do Windows Server 2016, Windows Server 2019 ou Windows Server 2022 Azure Edition. Estas VMs estão protegidas por um balanceador de carga com regras NAT para ligações RDP. Se ativar o Secureboot e o vTPM, a extensão de Atestado de Convidado será instalada no VMSS. Esta extensão executará o atestado remoto pela cloud. |
Definição de recurso terraform (fornecedor AzAPI)
O tipo de recurso virtualMachineScaleSets/extensions pode ser implementado com operações que visam:
- Grupos de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.Compute/virtualMachineScaleSets/extensions, adicione o seguinte Terraform ao seu 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
virtualMachineScaleSets/extensions
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.Compute/virtualMachineScaleSets/extensions@2023-09-01" |
| name | O nome do recurso | cadeia (obrigatório) |
| parent_id | O ID do recurso que é o principal para este recurso. | ID do recurso do tipo: virtualMachineScaleSets |
| propriedades | 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 utilizar uma versão secundária mais recente se estiver disponível no momento da implementação. No entanto, depois de implementada, a extensão não atualizará versões secundárias a menos que sejam reimplementadas, mesmo com esta propriedade definida como verdadeira. | bool |
| enableAutomaticUpgrade | Indica se a extensão deve ser atualizada automaticamente pela plataforma se existir uma versão mais recente da extensão disponível. | bool |
| forceUpdateTag | Se for fornecido um valor e for diferente do valor anterior, o processador de extensões 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 definição protegida. | |
| protectedSettingsFromKeyVault | As definições protegidas por extensões que são transmitidas por referência e consumidas a partir do cofre de chaves | KeyVaultSecretReference |
| provisionAfterExtensions | Coleção de nomes de extensões após o qual esta extensão tem de ser aprovisionada. | string[] |
| publicador | O nome do editor do processador de extensões. | string |
| definições | Definições públicas formatadas pelo Json para a extensão. | |
| suppressFailures | Indica se as falhas decorrentes da extensão serão suprimidas (as falhas operacionais, como não ligar à VM, não serão suprimidas independentemente deste valor). A predefinição é false. | bool |
| tipo | Especifica o tipo da extensão; um exemplo é "CustomScriptExtension". | string |
| typeHandlerVersion | Especifica a versão do processador de scripts. | string |
KeyVaultSecretReference
| Nome | Descrição | Valor |
|---|---|---|
| secretUrl | O URL que referencia um segredo numa Key Vault. | cadeia (obrigatório) |
| sourceVault | O URL relativo do Key Vault que contém o segredo. | Sub-origem (obrigatório) |
Sub-origem
| Nome | Descrição | Valor |
|---|---|---|
| ID | ID do Recurso | string |
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários