Поделиться через


Microsoft.Compute virtualMachineScaleSets/расширения, 2017-03-30

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

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

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

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

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

resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets/extensions@2017-03-30' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    autoUpgradeMinorVersion: bool
    forceUpdateTag: 'string'
    protectedSettings: any(...)
    publisher: 'string'
    settings: any(...)
    type: 'string'
    typeHandlerVersion: 'string'
  }
}

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

Microsoft.Compute/virtualMachineScaleSets/extensions

Имя Описание Ценность
имя Имя ресурса строка (обязательно)
родитель В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса.

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

VirtualMachineScaleSetExtensionProperties

Имя Описание Ценность
автоматическое обновление минорной версии Указывает, следует ли использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновлять дополнительные версии без повторного развертывания, даже если это свойство не имеет значения true. булевая переменная (bool)
forceUpdateTag Если задано значение и отличается от предыдущего значения, обработчик расширений будет вынужден обновляться, даже если конфигурация расширения не изменилась. струна
protectedSettings Расширение может содержать защищенные параметрыSettings или protectedSettingsFromKeyVault или не иметь защищенных параметров. любой
издатель Имя издателя обработчика расширений. струна
Параметры Форматированные общедоступные параметры json для расширения. любой
тип Указывает тип расширения; примером является CustomScriptExtension. струна
версияТипаОбработчика Указывает версию обработчика скрипта. струна

Примеры использования

Примеры быстрого запуска Azure

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

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

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

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

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

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

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

{
  "type": "Microsoft.Compute/virtualMachineScaleSets/extensions",
  "apiVersion": "2017-03-30",
  "name": "string",
  "properties": {
    "autoUpgradeMinorVersion": "bool",
    "forceUpdateTag": "string",
    "protectedSettings": {},
    "publisher": "string",
    "settings": {},
    "type": "string",
    "typeHandlerVersion": "string"
  }
}

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

Microsoft.Compute/virtualMachineScaleSets/extensions

Имя Описание Ценность
apiVersion Версия API '2017-03-30'
имя Имя ресурса строка (обязательно)
свойства Описывает свойства расширения масштабируемого набора виртуальных машин. VirtualMachineScaleSetExtensionProperties
тип Тип ресурса "Microsoft.Compute/virtualMachineScaleSets/extensions"

VirtualMachineScaleSetExtensionProperties

Имя Описание Ценность
автоматическое обновление минорной версии Указывает, следует ли использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновлять дополнительные версии без повторного развертывания, даже если это свойство не имеет значения true. булевая переменная (bool)
forceUpdateTag Если задано значение и отличается от предыдущего значения, обработчик расширений будет вынужден обновляться, даже если конфигурация расширения не изменилась. струна
protectedSettings Расширение может содержать защищенные параметрыSettings или protectedSettingsFromKeyVault или не иметь защищенных параметров. любой
издатель Имя издателя обработчика расширений. струна
Параметры Форматированные общедоступные параметры json для расширения. любой
тип Указывает тип расширения; примером является CustomScriptExtension. струна
версияТипаОбработчика Указывает версию обработчика скрипта. струна

Примеры использования

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

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

Шаблон Описание
создание и шифрование новой виртуальной машины Windows с помощью

развертывание в Azure
Этот шаблон позволяет развернуть простой масштабируемый набор виртуальных машин Windows с помощью последней исправленной версии серверных версий Windows. Этот шаблон также развертывает прыжки с общедоступным IP-адресом в той же виртуальной сети. С помощью этого общедоступного IP-адреса можно подключиться к виртуальным машинам в масштабируемом наборе с помощью частных IP-адресов. Этот шаблон включает шифрование в масштабируемом наборе виртуальных машин Windows.
Развертывание доверенного запуска с поддержкой масштабируемого набора виртуальных машин Windows

развертывание в Azure
Этот шаблон позволяет развернуть доверенный масштабируемый набор виртуальных машин Windows с поддержкой доверенного запуска с помощью последней исправленной версии Windows Server 2016, Windows Server 2019 или Windows Server 2022 Azure Edition. Эти виртуальные машины находятся за подсистемой балансировки нагрузки с правилами NAT для подключений RDP. Если включить Secureboot и vTPM, расширение аттестации гостей будет установлено на vmSS. Это расширение будет выполнять удаленное аттестации в облаке.
Развертывание vSensors autotrace autoscaling

развертывание в Azure
Этот шаблон позволяет развертывать автоматическое развертывание vSensors Darktrace vSensors автоматически.
этот шаблон расшифровывает ранее зашифрованные виртуальных машин Windows

развертывание в Azure
Этот шаблон отключает шифрование в работающем масштабируемом наборе виртуальных машин Windows
Этот шаблон шифрует запущенные виртуальных машин Windows

развертывание в Azure
Этот шаблон включает шифрование в работающем масштабируемом наборе виртуальных машин Windows

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

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

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

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets/extensions@2017-03-30"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      autoUpgradeMinorVersion = bool
      forceUpdateTag = "string"
      protectedSettings = ?
      publisher = "string"
      settings = ?
      type = "string"
      typeHandlerVersion = "string"
    }
  }
}

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

Microsoft.Compute/virtualMachineScaleSets/extensions

Имя Описание Ценность
имя Имя ресурса строка (обязательно)
parent_id Идентификатор ресурса, который является родительским для этого ресурса. Идентификатор ресурса типа: virtualMachineScaleSets
свойства Описывает свойства расширения масштабируемого набора виртуальных машин. VirtualMachineScaleSetExtensionProperties
тип Тип ресурса "Microsoft.Compute/virtualMachineScaleSets/extensions@2017-03-30"

VirtualMachineScaleSetExtensionProperties

Имя Описание Ценность
автоматическое обновление минорной версии Указывает, следует ли использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновлять дополнительные версии без повторного развертывания, даже если это свойство не имеет значения true. булевая переменная (bool)
forceUpdateTag Если задано значение и отличается от предыдущего значения, обработчик расширений будет вынужден обновляться, даже если конфигурация расширения не изменилась. струна
protectedSettings Расширение может содержать защищенные параметрыSettings или protectedSettingsFromKeyVault или не иметь защищенных параметров. любой
издатель Имя издателя обработчика расширений. струна
Параметры Форматированные общедоступные параметры json для расширения. любой
тип Указывает тип расширения; примером является CustomScriptExtension. струна
версияТипаОбработчика Указывает версию обработчика скрипта. струна

Примеры использования

Примеры Terraform

Простой пример развертывания расширения для масштабируемого набора виртуальных машин.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "virtualNetwork" {
  type      = "Microsoft.Network/virtualNetworks@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      addressSpace = {
        addressPrefixes = [
          "10.0.0.0/16",
        ]
      }
      dhcpOptions = {
        dnsServers = [
        ]
      }
      subnets = [
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
  lifecycle {
    ignore_changes = [body.properties.subnets]
  }
}

resource "azapi_resource" "subnet" {
  type      = "Microsoft.Network/virtualNetworks/subnets@2022-07-01"
  parent_id = azapi_resource.virtualNetwork.id
  name      = "internal"
  body = {
    properties = {
      addressPrefix = "10.0.2.0/24"
      delegations = [
      ]
      privateEndpointNetworkPolicies    = "Enabled"
      privateLinkServiceNetworkPolicies = "Enabled"
      serviceEndpointPolicies = [
      ]
      serviceEndpoints = [
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "virtualMachineScaleSet" {
  type      = "Microsoft.Compute/virtualMachineScaleSets@2023-03-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      additionalCapabilities = {
      }
      doNotRunExtensionsOnOverprovisionedVMs = false
      orchestrationMode                      = "Uniform"
      overprovision                          = true
      scaleInPolicy = {
        forceDeletion = false
        rules = [
          "Default",
        ]
      }
      singlePlacementGroup = true
      upgradePolicy = {
        mode = "Manual"
      }
      virtualMachineProfile = {
        diagnosticsProfile = {
          bootDiagnostics = {
            enabled    = false
            storageUri = ""
          }
        }
        extensionProfile = {
          extensionsTimeBudget = "PT1H30M"
        }
        networkProfile = {
          networkInterfaceConfigurations = [
            {
              name = "example"
              properties = {
                dnsSettings = {
                  dnsServers = [
                  ]
                }
                enableAcceleratedNetworking = false
                enableIPForwarding          = false
                ipConfigurations = [
                  {
                    name = "internal"
                    properties = {
                      applicationGatewayBackendAddressPools = [
                      ]
                      applicationSecurityGroups = [
                      ]
                      loadBalancerBackendAddressPools = [
                      ]
                      loadBalancerInboundNatPools = [
                      ]
                      primary                 = true
                      privateIPAddressVersion = "IPv4"
                      subnet = {
                        id = azapi_resource.subnet.id
                      }
                    }
                  },
                ]
                primary = true
              }
            },
          ]
        }
        osProfile = {
          adminUsername      = "adminuser"
          computerNamePrefix = var.resource_name
          linuxConfiguration = {
            disablePasswordAuthentication = true
            provisionVMAgent              = true
            ssh = {
              publicKeys = [
                {
                  keyData = "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC+wWK73dCr+jgQOAxNsHAnNNNMEMWOHYEccp6wJm2gotpr9katuF/ZAdou5AaW1C61slRkHRkpRRX9FA9CYBiitZgvCCz+3nWNN7l/Up54Zps/pHWGZLHNJZRYyAB6j5yVLMVHIHriY49d/GZTZVNB8GoJv9Gakwc/fuEZYYl4YDFiGMBP///TzlI4jhiJzjKnEvqPFki5p2ZRJqcbCiF4pJrxUQR/RXqVFQdbRLZgYfJ8xGB878RENq3yQ39d8dVOkq4edbkzwcUmwwwkYVPIoDGsYLaRHnG+To7FvMeyO7xDVQkMKzopTQV8AuKpyvpqu0a9pWOMaiCyDytO7GGN [email protected]"
                  path    = "/home/adminuser/.ssh/authorized_keys"
                },
              ]
            }
          }
          secrets = [
          ]
        }
        priority = "Regular"
        storageProfile = {
          dataDisks = [
          ]
          imageReference = {
            offer     = "UbuntuServer"
            publisher = "Canonical"
            sku       = "16.04-LTS"
            version   = "latest"
          }
          osDisk = {
            caching      = "ReadWrite"
            createOption = "FromImage"
            managedDisk = {
              storageAccountType = "Standard_LRS"
            }
            osType                  = "Linux"
            writeAcceleratorEnabled = false
          }
        }
      }
    }
    sku = {
      capacity = 1
      name     = "Standard_F2"
      tier     = "Standard"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "extension" {
  type      = "Microsoft.Compute/virtualMachineScaleSets/extensions@2023-03-01"
  parent_id = azapi_resource.virtualMachineScaleSet.id
  name      = var.resource_name
  body = {
    properties = {
      autoUpgradeMinorVersion = true
      enableAutomaticUpgrade  = false
      provisionAfterExtensions = [
      ]
      publisher = "Microsoft.Azure.Extensions"
      settings = {
        commandToExecute = "echo $HOSTNAME"
      }
      suppressFailures   = false
      type               = "CustomScript"
      typeHandlerVersion = "2.0"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}