Microsoft.Compute virtualMachineScaleSets/extensions 2023-07-01

• Актуальная
• 2023-09-01
• 2023-07-01
• 2023-03-01
• 2022-11-01
• 2022-08-01
• 2022-03-01
• 2021-11-01
• 2021-07-01
• 2021-04-01
• 2021-03-01
• 2020-12-01

Определение ресурса Bicep

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

• Группы ресурсов — см. команды развертывания групп ресурсов.

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

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

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

resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets/extensions@2023-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'
  }
}

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

virtualMachineScaleSets/extensions

Имя	Описание	Значение
name	имя ресурса. Узнайте, как задать имена и типы для дочерних ресурсов в Bicep.	string (обязательно)
родитель	В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить только в том случае, если дочерний ресурс объявлен за пределами родительского ресурса. Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса.	Символьное имя ресурса типа: virtualMachineScaleSets
properties	Описывает свойства расширения масштабируемого набора виртуальных машин.	VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

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

KeyVaultSecretReference

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

SubResource

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

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

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

Шаблон	Описание
Развертывание vSensors для автоматического масштабирования Darktrace	Этот шаблон позволяет развернуть автоматическое развертывание darktrace vSensors с автоматическим масштабированием.
Этот шаблон расшифровывает ранее зашифрованные виртуальные машины Windows	Этот шаблон отключает шифрование в работающем масштабируемом наборе виртуальных машин Windows
Этот шаблон шифрует работающий набор виртуальных машин Windows	Этот шаблон включает шифрование в работающем масштабируемом наборе виртуальных машин Windows
Создание и шифрование нового набора виртуальных машин Windows с помощью jumpbox	Этот шаблон позволяет развернуть простой масштабируемый набор виртуальных машин Windows, используя последнюю версию серверных версий Windows с исправлениями. Этот шаблон также развертывает jumpbox с общедоступным IP-адресом в той же виртуальной сети. Вы можете подключиться к jumpbox через этот общедоступный IP-адрес, а затем подключиться оттуда к виртуальным машинам в масштабируемом наборе через частные IP-адреса. Этот шаблон включает шифрование в масштабируемом наборе виртуальных машин Windows.
Развертывание масштабируемого набора виртуальных машин Windows с поддержкой доверенного запуска	Этот шаблон позволяет развернуть масштабируемый набор виртуальных машин Windows с поддержкой доверенного запуска, используя последнюю исправленную версию Windows Server 2016, Windows Server 2019 или Windows Server 2022 Azure Edition. Эти виртуальные машины находятся за подсистемой балансировки нагрузки с правилами NAT для подключений по протоколу RDP. Если вы включите Secureboot и vTPM, на виртуальной машине будет установлено расширение аттестации гостей. Это расширение будет выполнять удаленную аттестацию в облаке.

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

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

• Группы ресурсов — см. команды развертывания группы ресурсов.

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

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

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

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

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

virtualMachineScaleSets/extensions

Имя	Описание	Значение
тип	Тип ресурса	Microsoft.Compute/virtualMachineScaleSets/extensions
версия_API	Версия API ресурсов	'2023-07-01'
name	имя ресурса. Узнайте, как задать имена и типы для дочерних ресурсов в шаблонах JSON ARM.	строка (обязательно)
properties	Описывает свойства расширения масштабируемого набора виртуальных машин.	VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

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

KeyVaultSecretReference

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

SubResource

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

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

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

Шаблон	Описание
Развертывание vSensors для автоматического масштабирования Darktrace	Этот шаблон позволяет развернуть автоматическое развертывание darktrace vSensors с автоматическим масштабированием.
Этот шаблон расшифровывает ранее зашифрованные виртуальные машины Windows	Этот шаблон отключает шифрование в работающем масштабируемом наборе виртуальных машин Windows
Этот шаблон шифрует работающий набор виртуальных машин Windows	Этот шаблон включает шифрование в работающем масштабируемом наборе виртуальных машин Windows
Создание и шифрование нового набора виртуальных машин Windows с помощью jumpbox	Этот шаблон позволяет развернуть простой масштабируемый набор виртуальных машин Windows, используя последнюю версию серверных версий Windows с исправлениями. Этот шаблон также развертывает jumpbox с общедоступным IP-адресом в той же виртуальной сети. Вы можете подключиться к jumpbox через этот общедоступный IP-адрес, а затем подключиться оттуда к виртуальным машинам в масштабируемом наборе через частные IP-адреса. Этот шаблон включает шифрование в масштабируемом наборе виртуальных машин Windows.
Развертывание масштабируемого набора виртуальных машин Windows с поддержкой доверенного запуска	Этот шаблон позволяет развернуть масштабируемый набор виртуальных машин Windows с поддержкой доверенного запуска, используя последнюю исправленную версию Windows Server 2016, Windows Server 2019 или Windows Server 2022 Azure Edition. Эти виртуальные машины находятся за подсистемой балансировки нагрузки с правилами NAT для подключений по протоколу RDP. Если вы включите Secureboot и vTPM, на виртуальной машине будет установлено расширение аттестации гостей. Это расширение будет выполнять удаленную аттестацию в облаке.

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

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

• Группы ресурсов

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

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets/extensions@2023-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"
    }
  })
}

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

virtualMachineScaleSets/extensions

Имя	Описание	Значение
тип	Тип ресурса	"Microsoft.Compute/virtualMachineScaleSets/extensions@2023-07-01"
name	имя ресурса.	строка (обязательно)
parent_id	Идентификатор ресурса, который является родительским для этого ресурса.	Идентификатор ресурса типа virtualMachineScaleSets
properties	Описывает свойства расширения масштабируемого набора виртуальных машин.	VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

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

KeyVaultSecretReference

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

SubResource

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