Compartilhar via

Microsoft.Compute virtualMachineScaleSets/extensions 2021-11-01

  • Artigo

Definição de recurso do Bicep

O tipo de recurso virtualMachineScaleSets/extensions pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Compute/virtualMachineScaleSets/extensions, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets/extensions@2021-11-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    autoUpgradeMinorVersion: bool
    enableAutomaticUpgrade: bool
    forceUpdateTag: 'string'
    protectedSettings: any(Azure.Bicep.Types.Concrete.AnyType)
    protectedSettingsFromKeyVault: any(Azure.Bicep.Types.Concrete.AnyType)
    provisionAfterExtensions: [
      'string'
    ]
    publisher: 'string'
    settings: any(Azure.Bicep.Types.Concrete.AnyType)
    suppressFailures: bool
    type: 'string'
    typeHandlerVersion: 'string'
  }
}

Valores de propriedade

Microsoft.Compute/virtualMachineScaleSets/extensions

Nome Descrição Valor
nome O nome do recurso 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 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 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 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 de extensão não tenha sido alterada. corda
protectedSettings A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. qualquer
protectedSettingsFromKeyVault As configurações protegidas de extensões que são passadas por referência e consumidas do cofre de chaves qualquer
provisionAfterExtensions Coleção de nomes de extensão após o qual essa extensão precisa ser provisionada. string[]
editor O nome do editor do manipulador de extensão. corda
Configurações Configurações públicas formatadas em Json para a extensão. qualquer
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". corda
typeHandlerVersion Especifica a versão do manipulador de script. corda

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
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 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 o Secureboot e o vTPM, a extensão atestado de convidado será instalada em seu VMSS. Essa extensão executará de 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:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de 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": "2021-11-01",
  "name": "string",
  "properties": {
    "autoUpgradeMinorVersion": "bool",
    "enableAutomaticUpgrade": "bool",
    "forceUpdateTag": "string",
    "protectedSettings": {},
    "protectedSettingsFromKeyVault": {},
    "provisionAfterExtensions": [ "string" ],
    "publisher": "string",
    "settings": {},
    "suppressFailures": "bool",
    "type": "string",
    "typeHandlerVersion": "string"
  }
}

Valores de propriedade

Microsoft.Compute/virtualMachineScaleSets/extensions

Nome Descrição Valor
apiVersion A versão da API '2021-11-01'
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Descreve as propriedades de uma extensão de conjunto de dimensionamento de máquinas virtuais. VirtualMachineScaleSetExtensionProperties
tipo O tipo de recurso 'Microsoft.Compute/virtualMachineScaleSets/extensions'

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. 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 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 de extensão não tenha sido alterada. corda
protectedSettings A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. qualquer
protectedSettingsFromKeyVault As configurações protegidas de extensões que são passadas por referência e consumidas do cofre de chaves qualquer
provisionAfterExtensions Coleção de nomes de extensão após o qual essa extensão precisa ser provisionada. string[]
editor O nome do editor do manipulador de extensão. corda
Configurações Configurações públicas formatadas em Json para a extensão. qualquer
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". corda
typeHandlerVersion Especifica a versão do manipulador de script. corda

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Criar e criptografar um novo VMSS do Windows com o jumpbox

Implantar no Azure 		Esse modelo permite implantar um conjunto de dimensionamento de VM simples de VMs do Windows usando a versão mais recente corrigida das versões do Windows serveral. 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 a ela 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

Implantar no Azure 		Este modelo permite implantar um conjunto de dimensionamento de VMs com capacidade de inicialização confiável de VMs 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 o Secureboot e o vTPM, a extensão atestado de convidado será instalada em seu VMSS. Essa extensão executará de atestado remoto pela nuvem.
implantar o dimensionamento automático do Darktrace vSensors

Implantar no Azure 		Este modelo permite que você implante uma implantação de dimensionamento automático automaticamente de vSensors do Darktrace
Este modelo descriptografa o Windows VMSS criptografado anteriormente

Implantar no Azure 		Este modelo desabilita a criptografia em um Conjunto de Dimensionamento de VMs do Windows em execução
Este modelo criptografa um do Windows VMSS em execução

Implantar no Azure 		Este modelo habilita a criptografia em um Conjunto de Dimensionamento de VMs do Windows em execução

Definição de recurso do Terraform (provedor de 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 de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Compute/virtualMachineScaleSets/extensions, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets/extensions@2021-11-01"
  name = "string"
  body = jsonencode({
    properties = {
      autoUpgradeMinorVersion = bool
      enableAutomaticUpgrade = bool
      forceUpdateTag = "string"
      protectedSettings = ?
      protectedSettingsFromKeyVault = ?
      provisionAfterExtensions = [
        "string"
      ]
      publisher = "string"
      settings = ?
      suppressFailures = bool
      type = "string"
      typeHandlerVersion = "string"
    }
  })
}

Valores de propriedade

Microsoft.Compute/virtualMachineScaleSets/extensions

Nome Descrição Valor
nome 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
Propriedades Descreve as propriedades de uma extensão de conjunto de dimensionamento de máquinas virtuais. VirtualMachineScaleSetExtensionProperties
tipo O tipo de recurso "Microsoft.Compute/virtualMachineScaleSets/extensions@2021-11-01"

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. 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 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 de extensão não tenha sido alterada. corda
protectedSettings A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. qualquer
protectedSettingsFromKeyVault As configurações protegidas de extensões que são passadas por referência e consumidas do cofre de chaves qualquer
provisionAfterExtensions Coleção de nomes de extensão após o qual essa extensão precisa ser provisionada. string[]
editor O nome do editor do manipulador de extensão. corda
Configurações Configurações públicas formatadas em Json para a extensão. qualquer
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". corda
typeHandlerVersion Especifica a versão do manipulador de script. corda