Partilhar via


Microsoft.Compute virtualMachineScaleSets/extensions 2023-09-01

Definição de recursos do bíceps

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

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/virtualMachineScaleSets/extensions, adicione o seguinte Bicep ao seu modelo.

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

Valores de propriedade

KeyVaultSecretReference

Designação Descrição Valor
secretUrl O URL que faz referência a um segredo em um Cofre de Chaves. string (obrigatório)
fonteVault O URL relativo do Cofre da Chave que contém o segredo. de Subrecursos (obrigatório)

Microsoft.Compute/virtualMachineScaleSets/extensões

Designação Descrição Valor
Designação O nome do recurso string (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
propriedades Descreve as propriedades de uma extensão de conjunto de escala de máquina virtual. VirtualMachineScaleSetExtensionProperties

Subrecurso

Designação Descrição Valor
ID ID do recurso string

VirtualMachineScaleSetExtensionProperties

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 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
protegido Configurações A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. qualquer
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. qualquer
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

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 VM do Windows com capacidade de inicialização confiável Este modelo permite implantar um Conjunto de VMs do Windows com capacidade de inicialização confiável usando a versão corrigida mais recente 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 o Secureboot e o vTPM, a extensão Guest Attestation será instalada no seu VMSS. Esta extensão realizará o atestado de remoto pela nuvem.

Definição de recurso de modelo ARM

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

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/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

KeyVaultSecretReference

Designação Descrição Valor
secretUrl O URL que faz referência a um segredo em um Cofre de Chaves. string (obrigatório)
fonteVault O URL relativo do Cofre da Chave que contém o segredo. de Subrecursos (obrigatório)

Microsoft.Compute/virtualMachineScaleSets/extensões

Designação Descrição Valor
apiVersion A versão api '2023-09-01'
Designação O nome do recurso string (obrigatório)
propriedades Descreve as propriedades de uma extensão de conjunto de escala de máquina virtual. VirtualMachineScaleSetExtensionProperties
tipo O tipo de recurso 'Microsoft.Compute/virtualMachineScaleSets/extensions'

Subrecurso

Designação Descrição Valor
ID ID do recurso string

VirtualMachineScaleSetExtensionProperties

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 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
protegido Configurações A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. qualquer
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. qualquer
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

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 jumpbox

Implantar no Azure
Este modelo permite que você implante um conjunto de escala de VM simples de VMs do Windows usando a última versão corrigida das versões serveral do Windows. Este modelo também implanta uma jumpbox com um endereço IP público na mesma rede virtual. Você pode se conectar à jumpbox por meio desse endereço IP público e, em seguida, conectar-se a partir daí a VMs na escala definida por meio de endereços IP privados. Este modelo permite a criptografia no Conjunto de Escala de VMs do Windows.
Implantar um conjunto de dimensionamento de VM do Windows com capacidade de inicialização confiável

Implantar no Azure
Este modelo permite implantar um Conjunto de VMs do Windows com capacidade de inicialização confiável usando a versão corrigida mais recente 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 o Secureboot e o vTPM, a extensão Guest Attestation será instalada no seu VMSS. Esta extensão realizará o atestado de remoto pela nuvem.
implantar o Darktrace Autoscaling vSensors

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

Implantar no Azure
Este modelo desativa a criptografia em um Conjunto de Dimensionamento de VM do Windows em execução
Este modelo encripta um VMSS do Windows em execução

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

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso virtualMachineScaleSets/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/virtualMachineScaleSets/extensions, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets/extensions@2023-09-01"
  name = "string"
  body = jsonencode({
    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

KeyVaultSecretReference

Designação Descrição Valor
secretUrl O URL que faz referência a um segredo em um Cofre de Chaves. string (obrigatório)
fonteVault O URL relativo do Cofre da Chave que contém o segredo. de Subrecursos (obrigatório)

Microsoft.Compute/virtualMachineScaleSets/extensões

Designação Descrição Valor
Designação O nome do recurso string (obrigatório)
parent_id A ID do recurso que é o pai para este recurso. ID do recurso do tipo: virtualMachineScaleSets
propriedades Descreve as propriedades de uma extensão de conjunto de escala de máquina virtual. VirtualMachineScaleSetExtensionProperties
tipo O tipo de recurso "Microsoft.Compute/virtualMachineScaleSets/extensions@2023-09-01"

Subrecurso

Designação Descrição Valor
ID ID do recurso string

VirtualMachineScaleSetExtensionProperties

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 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
protegido Configurações A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. qualquer
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. qualquer
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