Microsoft.Compute virtualMachineScaleSets/extensions 2024-07-01

Artículo
08/17/2024

Definición de recursos de Bicep

El tipo de recurso virtualMachineScaleSets/extensions se puede implementar con operaciones destinadas a:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Compute/virtualMachineScaleSets/extensions, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets/extensions@2024-07-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 propiedad

virtualMachineScaleSets/extensions

Nombre	Descripción	Valor
nombre	El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en Bicep.	string (obligatorio)
padre	En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario. Para obtener más información, consulte recurso secundario fuera del recurso primario.	Nombre simbólico del recurso de tipo: virtualMachineScaleSets
Propiedades	Describe las propiedades de una extensión de conjunto de escalado de máquinas virtuales.	VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

Nombre	Descripción	Valor
autoUpgradeMinorVersion	Indica si la extensión debe usar una versión secundaria más reciente si está disponible en el momento de la implementación. Sin embargo, una vez implementada, la extensión no actualizará las versiones secundarias a menos que se vuelva a implementar, incluso con esta propiedad establecida en true.	Bool
enableAutomaticUpgrade	Indica si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente de la extensión disponible.	Bool
forceUpdateTag	Si se proporciona un valor y es diferente del valor anterior, el controlador de extensión se verá obligado a actualizar aunque la configuración de la extensión no haya cambiado.	cuerda
protectedSettings	La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida.	Para Bicep, puede usar la función any() any().
protectedSettingsFromKeyVault	Configuración protegida de extensiones que se pasan por referencia y que se consumen desde el almacén de claves.	keyVaultSecretReference
provisionAfterExtensions	Colección de nombres de extensión después de los cuales se debe aprovisionar esta extensión.	string[]
editor	Nombre del publicador de controladores de extensión.	cuerda
Configuración	Configuración pública con formato JSON para la extensión.	Para Bicep, puede usar la función any() any().
suppressFailures	Indica si los errores derivados de la extensión se suprimirán (los errores operativos, como no conectarse a la máquina virtual, no se suprimirán independientemente de este valor). El valor predeterminado es false.	Bool
tipo	Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension".	cuerda
typeHandlerVersion	Especifica la versión del controlador de script.	cuerda

KeyVaultSecretReference

Nombre	Descripción	Valor
secretUrl	Dirección URL que hace referencia a un secreto en un almacén de claves.	string (obligatorio)
sourceVault	Dirección URL relativa del almacén de claves que contiene el secreto.	subrecurso (obligatorio)

SubResource

Nombre	Descripción	Valor
identificación	Identificador de recurso	cuerda

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla	Descripción
implementación del escalado automático de Darktrace vSensors	Esta plantilla le permite implementar automáticamente una implementación de escalado automático de Darktrace vSensors.
Esta plantilla descifra las máquinas virtuales Windows cifradas anteriormente	Esta plantilla deshabilita el cifrado en un conjunto de escalado de máquinas virtuales Windows en ejecución
Esta plantilla cifra una máquina virtual Windows en ejecución	Esta plantilla habilita el cifrado en un conjunto de escalado de máquinas virtuales Windows en ejecución
Crear y cifrar un nuevo VMSS Windows con jumpbox	Esta plantilla permite implementar un conjunto de escalado de máquinas virtuales Windows simple mediante la versión revisada más reciente de las versiones de Windows serveral. Esta plantilla también implementa un jumpbox con una dirección IP pública en la misma red virtual. Puede conectarse al jumpbox a través de esta dirección IP pública y, a continuación, conectarse desde allí a las máquinas virtuales del conjunto de escalado a través de direcciones IP privadas. Esta plantilla habilita el cifrado en el conjunto de escalado de máquinas virtuales Windows.
Implementación de un conjunto de escalado de máquinas virtuales Windows compatible con el inicio de confianza	Esta plantilla le permite implementar un conjunto de escalado de máquinas virtuales Windows compatible con inicio de confianza mediante la versión revisada más reciente de Windows Server 2016, Windows Server 2019 o Windows Server 2022 Azure Edition. Estas máquinas virtuales están detrás de un equilibrador de carga con reglas NAT para las conexiones RDP. Si habilita Secureboot y vTPM, la extensión de atestación de invitado se instalará en vmSS. Esta extensión realizará atestación remota por la nube.

Definición de recursos de plantilla de ARM

El tipo de recurso virtualMachineScaleSets/extensions se puede implementar con operaciones destinadas a:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Compute/virtualMachineScaleSets/extensions, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Compute/virtualMachineScaleSets/extensions",
  "apiVersion": "2024-07-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 propiedad

virtualMachineScaleSets/extensions

Nombre	Descripción	Valor
tipo	El tipo de recurso	'Microsoft.Compute/virtualMachineScaleSets/extensions'
apiVersion	La versión de la API de recursos	'2024-07-01'
nombre	El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM json.	string (obligatorio)
Propiedades	Describe las propiedades de una extensión de conjunto de escalado de máquinas virtuales.	VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

Nombre	Descripción	Valor
autoUpgradeMinorVersion	Indica si la extensión debe usar una versión secundaria más reciente si está disponible en el momento de la implementación. Sin embargo, una vez implementada, la extensión no actualizará las versiones secundarias a menos que se vuelva a implementar, incluso con esta propiedad establecida en true.	Bool
enableAutomaticUpgrade	Indica si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente de la extensión disponible.	Bool
forceUpdateTag	Si se proporciona un valor y es diferente del valor anterior, el controlador de extensión se verá obligado a actualizar aunque la configuración de la extensión no haya cambiado.	cuerda
protectedSettings	La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida.
protectedSettingsFromKeyVault	Configuración protegida de extensiones que se pasan por referencia y que se consumen desde el almacén de claves.	keyVaultSecretReference
provisionAfterExtensions	Colección de nombres de extensión después de los cuales se debe aprovisionar esta extensión.	string[]
editor	Nombre del publicador de controladores de extensión.	cuerda
Configuración	Configuración pública con formato JSON para la extensión.
suppressFailures	Indica si los errores derivados de la extensión se suprimirán (los errores operativos, como no conectarse a la máquina virtual, no se suprimirán independientemente de este valor). El valor predeterminado es false.	Bool
tipo	Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension".	cuerda
typeHandlerVersion	Especifica la versión del controlador de script.	cuerda

KeyVaultSecretReference

Nombre	Descripción	Valor
secretUrl	Dirección URL que hace referencia a un secreto en un almacén de claves.	string (obligatorio)
sourceVault	Dirección URL relativa del almacén de claves que contiene el secreto.	subrecurso (obligatorio)

SubResource

Nombre	Descripción	Valor
identificación	Identificador de recurso	cuerda

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla	Descripción
implementación del escalado automático de Darktrace vSensors	Esta plantilla le permite implementar automáticamente una implementación de escalado automático de Darktrace vSensors.
Esta plantilla descifra las máquinas virtuales Windows cifradas anteriormente	Esta plantilla deshabilita el cifrado en un conjunto de escalado de máquinas virtuales Windows en ejecución
Esta plantilla cifra una máquina virtual Windows en ejecución	Esta plantilla habilita el cifrado en un conjunto de escalado de máquinas virtuales Windows en ejecución
Crear y cifrar un nuevo VMSS Windows con jumpbox	Esta plantilla permite implementar un conjunto de escalado de máquinas virtuales Windows simple mediante la versión revisada más reciente de las versiones de Windows serveral. Esta plantilla también implementa un jumpbox con una dirección IP pública en la misma red virtual. Puede conectarse al jumpbox a través de esta dirección IP pública y, a continuación, conectarse desde allí a las máquinas virtuales del conjunto de escalado a través de direcciones IP privadas. Esta plantilla habilita el cifrado en el conjunto de escalado de máquinas virtuales Windows.
Implementación de un conjunto de escalado de máquinas virtuales Windows compatible con el inicio de confianza	Esta plantilla le permite implementar un conjunto de escalado de máquinas virtuales Windows compatible con inicio de confianza mediante la versión revisada más reciente de Windows Server 2016, Windows Server 2019 o Windows Server 2022 Azure Edition. Estas máquinas virtuales están detrás de un equilibrador de carga con reglas NAT para las conexiones RDP. Si habilita Secureboot y vTPM, la extensión de atestación de invitado se instalará en vmSS. Esta extensión realizará atestación remota por la nube.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso virtualMachineScaleSets/extensions se puede implementar con operaciones destinadas a:

grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Compute/virtualMachineScaleSets/extensions, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets/extensions@2024-07-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 propiedad

virtualMachineScaleSets/extensions

Nombre	Descripción	Valor
tipo	El tipo de recurso	"Microsoft.Compute/virtualMachineScaleSets/extensions@2024-07-01"
nombre	El nombre del recurso	string (obligatorio)
parent_id	Identificador del recurso que es el elemento primario de este recurso.	Identificador del recurso de tipo: virtualMachineScaleSets
Propiedades	Describe las propiedades de una extensión de conjunto de escalado de máquinas virtuales.	VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

Nombre	Descripción	Valor
autoUpgradeMinorVersion	Indica si la extensión debe usar una versión secundaria más reciente si está disponible en el momento de la implementación. Sin embargo, una vez implementada, la extensión no actualizará las versiones secundarias a menos que se vuelva a implementar, incluso con esta propiedad establecida en true.	Bool
enableAutomaticUpgrade	Indica si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente de la extensión disponible.	Bool
forceUpdateTag	Si se proporciona un valor y es diferente del valor anterior, el controlador de extensión se verá obligado a actualizar aunque la configuración de la extensión no haya cambiado.	cuerda
protectedSettings	La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida.
protectedSettingsFromKeyVault	Configuración protegida de extensiones que se pasan por referencia y que se consumen desde el almacén de claves.	keyVaultSecretReference
provisionAfterExtensions	Colección de nombres de extensión después de los cuales se debe aprovisionar esta extensión.	string[]
editor	Nombre del publicador de controladores de extensión.	cuerda
Configuración	Configuración pública con formato JSON para la extensión.
suppressFailures	Indica si los errores derivados de la extensión se suprimirán (los errores operativos, como no conectarse a la máquina virtual, no se suprimirán independientemente de este valor). El valor predeterminado es false.	Bool
tipo	Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension".	cuerda
typeHandlerVersion	Especifica la versión del controlador de script.	cuerda

KeyVaultSecretReference

Nombre	Descripción	Valor
secretUrl	Dirección URL que hace referencia a un secreto en un almacén de claves.	string (obligatorio)
sourceVault	Dirección URL relativa del almacén de claves que contiene el secreto.	subrecurso (obligatorio)

SubResource

Nombre	Descripción	Valor
identificación	Identificador de recurso	cuerda

Compartir a través de

Microsoft.Compute virtualMachineScaleSets/extensions 2024-07-01

Definición de recursos de Bicep

Formato de recurso

Valores de propiedad

virtualMachineScaleSets/extensions

VirtualMachineScaleSetExtensionProperties

KeyVaultSecretReference

SubResource

Plantillas de inicio rápido

Definición de recursos de plantilla de ARM

Formato de recurso

Valores de propiedad

virtualMachineScaleSets/extensions

VirtualMachineScaleSetExtensionProperties

KeyVaultSecretReference

SubResource

Plantillas de inicio rápido

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Valores de propiedad

virtualMachineScaleSets/extensions

VirtualMachineScaleSetExtensionProperties

KeyVaultSecretReference

SubResource

Comentarios

Recursos adicionales