Microsoft.Compute virtualMachines/extensions

Определение ресурсов Bicep

Тип ресурса virtualMachines/extensions можно развернуть с помощью операций, целевых:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Compute/virtualMachines/extensions, добавьте следующий Bicep в шаблон.

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'
  }
}

Значения свойств

virtualMachines/extensions

Имя Описание Ценность
имя Имя ресурса

Узнайте, как задать имена и типы дочерних ресурсов в Bicep.
строка (обязательно)
местоположение Расположение ресурса струна
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
родитель В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса.

Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса.
Символьное имя ресурса типа: virtualMachines
свойства Описывает свойства расширения виртуальной машины. VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Имя Описание Ценность
autoUpgradeMinorVersion Указывает, следует ли использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновлять дополнительные версии без повторного развертывания, даже если это свойство не имеет значения true. bool
enableAutomaticUpgrade Указывает, следует ли автоматически обновлять расширение платформой, если доступна более новая версия расширения. bool
forceUpdateTag Как обработчик расширений должен быть вынужден обновляться, даже если конфигурация расширения не изменилась. струна
instanceView Представление экземпляра расширения виртуальной машины. VirtualMachineExtensionInstanceView
protectedSettings Расширение может содержать защищенные параметрыSettings или protectedSettingsFromKeyVault или не иметь защищенных параметров. Для Bicep можно использовать функцию any().
protectedSettingsFromKeyVault Защищенные расширения, передаваемые по ссылке, и используемые из хранилища ключей KeyVaultSecretReference
provisionAfterExtensions Коллекция имен расширений, после которой необходимо подготовить это расширение. string[]
издатель Имя издателя обработчика расширений. струна
Параметры Форматированные общедоступные параметры json для расширения. Для Bicep можно использовать функцию any().
suppressFailures Указывает, будут ли отключены сбои, возникающие из расширения (операционные сбои, такие как отсутствие подключения к виртуальной машине, не будут подавляться независимо от этого значения). Значение по умолчанию — false. bool
тип Указывает тип расширения; примером является CustomScriptExtension. струна
typeHandlerVersion Указывает версию обработчика скрипта. струна

VirtualMachineExtensionInstanceView

Имя Описание Ценность
имя Имя расширения виртуальной машины. струна
Статусы Сведения о состоянии ресурса. InstanceViewStatus[]
вложенные статистические выражения Сведения о состоянии ресурса. InstanceViewStatus[]
тип Указывает тип расширения; примером является CustomScriptExtension. струна
typeHandlerVersion Указывает версию обработчика скрипта. струна

InstanceViewStatus

Имя Описание Ценность
код Код состояния. струна
displayStatus Короткая локализуемая метка для состояния. струна
уровень Код уровня. "Ошибка"
"Info"
Предупреждение
Сообщение Подробное сообщение о состоянии, в том числе для оповещений и сообщений об ошибках. струна
Время Время состояния. струна

KeyVaultSecretReference

Имя Описание Ценность
secretUrl URL-адрес, ссылающийся на секрет в Key Vault. строка (обязательно)
sourceVault Относительный URL-адрес Хранилища ключей, содержащий секрет. subResource (обязательно)

SubResource

Имя Описание Ценность
идентификатор Идентификатор ресурса струна

Шаблоны быстрого запуска

Следующие шаблоны быстрого запуска развертывают этот тип ресурса.

Шаблон Описание
создание виртуальной машины Windows с поддержкой расширения защиты от вредоносных программ

развертывание в Azure
Этот шаблон создает виртуальную машину Windows и настраивает защиту от вредоносных программ
IIS Server с помощью расширения DSC на виртуальной машине Windows

развертывание в Azure
Этот шаблон создает виртуальную машину Windows и настраивает сервер IIS с помощью расширения DSC. Обратите внимание, что модуль конфигурации DSC должен передавать маркер SAS, если вы используете службу хранилища Azure. Для ссылки модуля DSC из GitHub (по умолчанию в этом шаблоне) это не требуется.
расширение виртуальной машины ESET

развертывание в Azure
Создание виртуальной машины с расширением ESET
McAfee Endpoint Security (пробная лицензия) на виртуальной машине Windows

развертывание в Azure
Этот шаблон создает виртуальную машину Windows и настраивает пробную версию McAfee Endpoint Security
развертывание виртуальной машины Ubuntu с помощью расширения OMS

развертывание в Azure
Этот шаблон позволяет развернуть виртуальную машину Ubuntu с установленным расширением OMS и подключиться к указанной рабочей области.
Развертывание виртуальной машины Windows с расширением OMS

развертывание в Azure
Этот шаблон позволяет развернуть виртуальную машину Windows с установленным расширением OMS и подключиться к указанной рабочей области.
пробная версия расширения Symantec Endpoint Protection на виртуальной машине Windows

развертывание в Azure
Этот шаблон создает виртуальную машину Windows и настраивает пробную версию Symantec Endpoint Protection
расширение пользовательского скрипта на виртуальной машине Ubuntu

развертывание в Azure
Этот шаблон создает виртуальную машину Ubuntu и устанавливает расширение CustomScript
расширение исправлений ос на виртуальной машине Ubuntu

развертывание в Azure
Этот шаблон создает виртуальную машину Ubuntu и устанавливает расширение OSPatching
Развертывание виртуальной машины Windows уровня "Премиум" с помощью диагностики

развертывание в Azure
Этот шаблон позволяет развернуть виртуальную машину Windows уровня "Премиум" с помощью нескольких различных вариантов для версии Windows, используя последнюю исправленную версию.
Развертывание простой виртуальной машины Windows с помощью мониторинга и диагностики

развертывание в Azure
Этот шаблон позволяет развернуть простую виртуальную машину Windows вместе с расширением диагностики, которое обеспечивает мониторинг и диагностику виртуальной машины.
Использование расширений скриптов для установки Mongo DB на виртуальной машине Ubuntu

развертывание в Azure
Этот шаблон развертывает настройки и устанавливает Mongo DB на виртуальной машине Ubuntu в двух отдельных сценариях. Этот шаблон является хорошим примером, в котором показано, как выразить зависимости между двумя скриптами, работающими на одной виртуальной машине. Этот шаблон также развертывает учетную запись хранения, виртуальную сеть, общедоступные IP-адреса и сетевой интерфейс.

Определение ресурса шаблона ARM

Тип ресурса virtualMachines/extensions можно развернуть с помощью операций, целевых:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Compute/virtualMachines/extensions, добавьте следующий код JSON в шаблон.

{
  "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"
  }
}

Значения свойств

virtualMachines/extensions

Имя Описание Ценность
тип Тип ресурса "Microsoft.Compute/virtualMachines/extensions"
apiVersion Версия API ресурсов '2024-07-01'
имя Имя ресурса

Узнайте, как задать имена и типы дочерних ресурсов в шаблонах ARM JSON.
строка (обязательно)
местоположение Расположение ресурса струна
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
свойства Описывает свойства расширения виртуальной машины. VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Имя Описание Ценность
autoUpgradeMinorVersion Указывает, следует ли использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновлять дополнительные версии без повторного развертывания, даже если это свойство не имеет значения true. bool
enableAutomaticUpgrade Указывает, следует ли автоматически обновлять расширение платформой, если доступна более новая версия расширения. bool
forceUpdateTag Как обработчик расширений должен быть вынужден обновляться, даже если конфигурация расширения не изменилась. струна
instanceView Представление экземпляра расширения виртуальной машины. VirtualMachineExtensionInstanceView
protectedSettings Расширение может содержать защищенные параметрыSettings или protectedSettingsFromKeyVault или не иметь защищенных параметров.
protectedSettingsFromKeyVault Защищенные расширения, передаваемые по ссылке, и используемые из хранилища ключей KeyVaultSecretReference
provisionAfterExtensions Коллекция имен расширений, после которой необходимо подготовить это расширение. string[]
издатель Имя издателя обработчика расширений. струна
Параметры Форматированные общедоступные параметры json для расширения.
suppressFailures Указывает, будут ли отключены сбои, возникающие из расширения (операционные сбои, такие как отсутствие подключения к виртуальной машине, не будут подавляться независимо от этого значения). Значение по умолчанию — false. bool
тип Указывает тип расширения; примером является CustomScriptExtension. струна
typeHandlerVersion Указывает версию обработчика скрипта. струна

VirtualMachineExtensionInstanceView

Имя Описание Ценность
имя Имя расширения виртуальной машины. струна
Статусы Сведения о состоянии ресурса. InstanceViewStatus[]
вложенные статистические выражения Сведения о состоянии ресурса. InstanceViewStatus[]
тип Указывает тип расширения; примером является CustomScriptExtension. струна
typeHandlerVersion Указывает версию обработчика скрипта. струна

InstanceViewStatus

Имя Описание Ценность
код Код состояния. струна
displayStatus Короткая локализуемая метка для состояния. струна
уровень Код уровня. "Ошибка"
"Info"
Предупреждение
Сообщение Подробное сообщение о состоянии, в том числе для оповещений и сообщений об ошибках. струна
Время Время состояния. струна

KeyVaultSecretReference

Имя Описание Ценность
secretUrl URL-адрес, ссылающийся на секрет в Key Vault. строка (обязательно)
sourceVault Относительный URL-адрес Хранилища ключей, содержащий секрет. subResource (обязательно)

SubResource

Имя Описание Ценность
идентификатор Идентификатор ресурса струна

Шаблоны быстрого запуска

Следующие шаблоны быстрого запуска развертывают этот тип ресурса.

Шаблон Описание
создание виртуальной машины Windows с поддержкой расширения защиты от вредоносных программ

развертывание в Azure
Этот шаблон создает виртуальную машину Windows и настраивает защиту от вредоносных программ
IIS Server с помощью расширения DSC на виртуальной машине Windows

развертывание в Azure
Этот шаблон создает виртуальную машину Windows и настраивает сервер IIS с помощью расширения DSC. Обратите внимание, что модуль конфигурации DSC должен передавать маркер SAS, если вы используете службу хранилища Azure. Для ссылки модуля DSC из GitHub (по умолчанию в этом шаблоне) это не требуется.
расширение виртуальной машины ESET

развертывание в Azure
Создание виртуальной машины с расширением ESET
McAfee Endpoint Security (пробная лицензия) на виртуальной машине Windows

развертывание в Azure
Этот шаблон создает виртуальную машину Windows и настраивает пробную версию McAfee Endpoint Security
развертывание виртуальной машины Ubuntu с помощью расширения OMS

развертывание в Azure
Этот шаблон позволяет развернуть виртуальную машину Ubuntu с установленным расширением OMS и подключиться к указанной рабочей области.
Развертывание виртуальной машины Windows с расширением OMS

развертывание в Azure
Этот шаблон позволяет развернуть виртуальную машину Windows с установленным расширением OMS и подключиться к указанной рабочей области.
пробная версия расширения Symantec Endpoint Protection на виртуальной машине Windows

развертывание в Azure
Этот шаблон создает виртуальную машину Windows и настраивает пробную версию Symantec Endpoint Protection
расширение пользовательского скрипта на виртуальной машине Ubuntu

развертывание в Azure
Этот шаблон создает виртуальную машину Ubuntu и устанавливает расширение CustomScript
расширение исправлений ос на виртуальной машине Ubuntu

развертывание в Azure
Этот шаблон создает виртуальную машину Ubuntu и устанавливает расширение OSPatching
Развертывание виртуальной машины Windows уровня "Премиум" с помощью диагностики

развертывание в Azure
Этот шаблон позволяет развернуть виртуальную машину Windows уровня "Премиум" с помощью нескольких различных вариантов для версии Windows, используя последнюю исправленную версию.
Развертывание простой виртуальной машины Windows с помощью мониторинга и диагностики

развертывание в Azure
Этот шаблон позволяет развернуть простую виртуальную машину Windows вместе с расширением диагностики, которое обеспечивает мониторинг и диагностику виртуальной машины.
Использование расширений скриптов для установки Mongo DB на виртуальной машине Ubuntu

развертывание в Azure
Этот шаблон развертывает настройки и устанавливает Mongo DB на виртуальной машине Ubuntu в двух отдельных сценариях. Этот шаблон является хорошим примером, в котором показано, как выразить зависимости между двумя скриптами, работающими на одной виртуальной машине. Этот шаблон также развертывает учетную запись хранения, виртуальную сеть, общедоступные IP-адреса и сетевой интерфейс.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса virtualMachines/extensions можно развернуть с помощью операций, целевых:

  • групп ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Compute/virtualMachines/extensions, добавьте следующий объект Terraform в шаблон.

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"
    }
  })
}

Значения свойств

virtualMachines/extensions

Имя Описание Ценность
тип Тип ресурса "Microsoft.Compute/virtualMachines/extensions@2024-07-01"
имя Имя ресурса строка (обязательно)
местоположение Расположение ресурса струна
parent_id Идентификатор ресурса, который является родительским для этого ресурса. Идентификатор ресурса типа: virtualMachines
Теги Теги ресурсов Словарь имен и значений тегов.
свойства Описывает свойства расширения виртуальной машины. VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Имя Описание Ценность
autoUpgradeMinorVersion Указывает, следует ли использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновлять дополнительные версии без повторного развертывания, даже если это свойство не имеет значения true. bool
enableAutomaticUpgrade Указывает, следует ли автоматически обновлять расширение платформой, если доступна более новая версия расширения. bool
forceUpdateTag Как обработчик расширений должен быть вынужден обновляться, даже если конфигурация расширения не изменилась. струна
instanceView Представление экземпляра расширения виртуальной машины. VirtualMachineExtensionInstanceView
protectedSettings Расширение может содержать защищенные параметрыSettings или protectedSettingsFromKeyVault или не иметь защищенных параметров.
protectedSettingsFromKeyVault Защищенные расширения, передаваемые по ссылке, и используемые из хранилища ключей KeyVaultSecretReference
provisionAfterExtensions Коллекция имен расширений, после которой необходимо подготовить это расширение. string[]
издатель Имя издателя обработчика расширений. струна
Параметры Форматированные общедоступные параметры json для расширения.
suppressFailures Указывает, будут ли отключены сбои, возникающие из расширения (операционные сбои, такие как отсутствие подключения к виртуальной машине, не будут подавляться независимо от этого значения). Значение по умолчанию — false. bool
тип Указывает тип расширения; примером является CustomScriptExtension. струна
typeHandlerVersion Указывает версию обработчика скрипта. струна

VirtualMachineExtensionInstanceView

Имя Описание Ценность
имя Имя расширения виртуальной машины. струна
Статусы Сведения о состоянии ресурса. InstanceViewStatus[]
вложенные статистические выражения Сведения о состоянии ресурса. InstanceViewStatus[]
тип Указывает тип расширения; примером является CustomScriptExtension. струна
typeHandlerVersion Указывает версию обработчика скрипта. струна

InstanceViewStatus

Имя Описание Ценность
код Код состояния. струна
displayStatus Короткая локализуемая метка для состояния. струна
уровень Код уровня. "Ошибка"
"Сведения"
"Предупреждение"
Сообщение Подробное сообщение о состоянии, в том числе для оповещений и сообщений об ошибках. струна
Время Время состояния. струна

KeyVaultSecretReference

Имя Описание Ценность
secretUrl URL-адрес, ссылающийся на секрет в Key Vault. строка (обязательно)
sourceVault Относительный URL-адрес Хранилища ключей, содержащий секрет. subResource (обязательно)

SubResource

Имя Описание Ценность
идентификатор Идентификатор ресурса струна