Microsoft.Compute virtualMachines/extensions

Definición de recursos de Bicep

El tipo de recurso virtualMachines/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/virtualMachines/extensions, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Compute/virtualMachines/extensions@2024-07-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    autoUpgradeMinorVersion: bool
    enableAutomaticUpgrade: bool
    forceUpdateTag: 'string'
    instanceView: {
      name: 'string'
      statuses: [
        {
          code: 'string'
          displayStatus: 'string'
          level: 'string'
          message: 'string'
          time: 'string'
        }
      ]
      substatuses: [
        {
          code: 'string'
          displayStatus: 'string'
          level: 'string'
          message: 'string'
          time: 'string'
        }
      ]
      type: 'string'
      typeHandlerVersion: 'string'
    }
    protectedSettings: any()
    protectedSettingsFromKeyVault: {
      secretUrl: 'string'
      sourceVault: {
        id: 'string'
      }
    }
    provisionAfterExtensions: [
      'string'
    ]
    publisher: 'string'
    settings: any()
    suppressFailures: bool
    type: 'string'
    typeHandlerVersion: 'string'
  }
}

Valores de propiedad

virtualMachines/extensions

VirtualMachineExtensionProperties

VirtualMachineExtensionInstanceView

InstanceViewStatus

KeyVaultSecretReference

SubResource

Plantillas de inicio rápido

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

Plantilla	Descripción
Crear una máquina virtual Windows con la extensión Antimalware habilitada	Esta plantilla crea una máquina virtual Windows y configura la protección contra malware
servidor IIS mediante la extensión DSC en una máquina virtual Windows	Esta plantilla crea una máquina virtual Windows y configura un servidor IIS mediante la extensión DSC. Tenga en cuenta que el módulo de configuración de DSC necesita que se pase un token de SAS si usa Azure Storage. Para el vínculo del módulo DSC desde GitHub (valor predeterminado en esta plantilla), esto no es necesario.
de extensión de máquina virtual ESET	Crea una máquina virtual con la extensión ESET.
McAfee Endpoint Security (licencia de prueba) en máquinas virtuales Windows	Esta plantilla crea una máquina virtual Windows y configura una versión de prueba de McAfee Endpoint Security
Implementación de una máquina virtual Ubuntu con la extensión oms	Esta plantilla le permite implementar una máquina virtual Ubuntu con la extensión oms instalada e incorporada a un área de trabajo especificada.
Implementación de una máquina virtual Windows con la extensión oms	Esta plantilla le permite implementar una máquina virtual Windows con la extensión oms instalada e incorporada a un área de trabajo especificada.
prueba de extensión de Symantec Endpoint Protection en máquinas virtuales Windows	Esta plantilla crea una máquina virtual Windows y configura una versión de prueba de Symantec Endpoint Protection
extensión de script personalizado en una máquina virtual Ubuntu	Esta plantilla crea una máquina virtual Ubuntu e instala la extensión CustomScript.
extensión de aplicación de revisiones del sistema operativo en una máquina virtual Ubuntu	Esta plantilla crea una máquina virtual Ubuntu e instala la extensión OSPatching.
Implementación de una máquina virtual Windows Premium con diagnósticos	Esta plantilla le permite implementar una máquina virtual Windows Premium con algunas opciones diferentes para la versión de Windows, mediante la versión revisada más reciente.
Implementación de una máquina virtual Windows sencilla con de supervisión y diagnóstico	Esta plantilla le permite implementar una máquina virtual Windows sencilla junto con la extensión de diagnóstico que permite la supervisión y el diagnóstico de la máquina virtual.
Uso de extensiones de script para instalar Mongo DB en máquinas virtuales Ubuntu	Esta plantilla implementa Configurar e instalar Mongo DB en una máquina virtual Ubuntu en dos scripts independientes. Esta plantilla es un buen ejemplo que muestra cómo expresar dependencias entre dos scripts que se ejecutan en la misma máquina virtual. Esta plantilla también implementa una cuenta de almacenamiento, una red virtual, direcciones IP públicas y una interfaz de red.

Definición de recursos de plantilla de ARM

El tipo de recurso virtualMachines/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/virtualMachines/extensions, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "apiVersion": "2024-07-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "autoUpgradeMinorVersion": "bool",
    "enableAutomaticUpgrade": "bool",
    "forceUpdateTag": "string",
    "instanceView": {
      "name": "string",
      "statuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "level": "string",
          "message": "string",
          "time": "string"
        }
      ],
      "substatuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "level": "string",
          "message": "string",
          "time": "string"
        }
      ],
      "type": "string",
      "typeHandlerVersion": "string"
    },
    "protectedSettings": {},
    "protectedSettingsFromKeyVault": {
      "secretUrl": "string",
      "sourceVault": {
        "id": "string"
      }
    },
    "provisionAfterExtensions": [ "string" ],
    "publisher": "string",
    "settings": {},
    "suppressFailures": "bool",
    "type": "string",
    "typeHandlerVersion": "string"
  }
}

Valores de propiedad

virtualMachines/extensions

VirtualMachineExtensionProperties

VirtualMachineExtensionInstanceView

InstanceViewStatus

KeyVaultSecretReference

SubResource

Plantillas de inicio rápido

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

Plantilla	Descripción
Crear una máquina virtual Windows con la extensión Antimalware habilitada	Esta plantilla crea una máquina virtual Windows y configura la protección contra malware
servidor IIS mediante la extensión DSC en una máquina virtual Windows	Esta plantilla crea una máquina virtual Windows y configura un servidor IIS mediante la extensión DSC. Tenga en cuenta que el módulo de configuración de DSC necesita que se pase un token de SAS si usa Azure Storage. Para el vínculo del módulo DSC desde GitHub (valor predeterminado en esta plantilla), esto no es necesario.
de extensión de máquina virtual ESET	Crea una máquina virtual con la extensión ESET.
McAfee Endpoint Security (licencia de prueba) en máquinas virtuales Windows	Esta plantilla crea una máquina virtual Windows y configura una versión de prueba de McAfee Endpoint Security
Implementación de una máquina virtual Ubuntu con la extensión oms	Esta plantilla le permite implementar una máquina virtual Ubuntu con la extensión oms instalada e incorporada a un área de trabajo especificada.
Implementación de una máquina virtual Windows con la extensión oms	Esta plantilla le permite implementar una máquina virtual Windows con la extensión oms instalada e incorporada a un área de trabajo especificada.
prueba de extensión de Symantec Endpoint Protection en máquinas virtuales Windows	Esta plantilla crea una máquina virtual Windows y configura una versión de prueba de Symantec Endpoint Protection
extensión de script personalizado en una máquina virtual Ubuntu	Esta plantilla crea una máquina virtual Ubuntu e instala la extensión CustomScript.
extensión de aplicación de revisiones del sistema operativo en una máquina virtual Ubuntu	Esta plantilla crea una máquina virtual Ubuntu e instala la extensión OSPatching.
Implementación de una máquina virtual Windows Premium con diagnósticos	Esta plantilla le permite implementar una máquina virtual Windows Premium con algunas opciones diferentes para la versión de Windows, mediante la versión revisada más reciente.
Implementación de una máquina virtual Windows sencilla con de supervisión y diagnóstico	Esta plantilla le permite implementar una máquina virtual Windows sencilla junto con la extensión de diagnóstico que permite la supervisión y el diagnóstico de la máquina virtual.
Uso de extensiones de script para instalar Mongo DB en máquinas virtuales Ubuntu	Esta plantilla implementa Configurar e instalar Mongo DB en una máquina virtual Ubuntu en dos scripts independientes. Esta plantilla es un buen ejemplo que muestra cómo expresar dependencias entre dos scripts que se ejecutan en la misma máquina virtual. Esta plantilla también implementa una cuenta de almacenamiento, una red virtual, direcciones IP públicas y una interfaz de red.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso virtualMachines/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/virtualMachines/extensions, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachines/extensions@2024-07-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      autoUpgradeMinorVersion = bool
      enableAutomaticUpgrade = bool
      forceUpdateTag = "string"
      instanceView = {
        name = "string"
        statuses = [
          {
            code = "string"
            displayStatus = "string"
            level = "string"
            message = "string"
            time = "string"
          }
        ]
        substatuses = [
          {
            code = "string"
            displayStatus = "string"
            level = "string"
            message = "string"
            time = "string"
          }
        ]
        type = "string"
        typeHandlerVersion = "string"
      }
      protectedSettingsFromKeyVault = {
        secretUrl = "string"
        sourceVault = {
          id = "string"
        }
      }
      provisionAfterExtensions = [
        "string"
      ]
      publisher = "string"
      suppressFailures = bool
      type = "string"
      typeHandlerVersion = "string"
    }
  })
}

Valores de propiedad

virtualMachines/extensions

VirtualMachineExtensionProperties

VirtualMachineExtensionInstanceView

InstanceViewStatus

KeyVaultSecretReference

SubResource