Microsoft.Compute virtualMachineScaleSets/extensions

Definicja zasobu Bicep

Typ zasobu virtualMachineScaleSets/extensions można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Compute/virtualMachineScaleSets/extensions, dodaj następujący kod Bicep do szablonu.

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

Wartości właściwości

virtualMachineScaleSets/extensions

Nazwa Opis Wartość
name Nazwa zasobu

Zobacz, jak ustawić nazwy i typy dla zasobów podrzędnych w aplikacji Bicep.
ciąg (wymagany)
Nadrzędny W pliku Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.

Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.
Nazwa symboliczna zasobu typu: virtualMachineScaleSets
properties Opisuje właściwości rozszerzenia zestawu skalowania maszyn wirtualnych. VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

Nazwa Opis Wartość
autoUpgradeMinorVersion Wskazuje, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie będzie jednak uaktualniać wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true. bool
enableAutomaticUpgrade Wskazuje, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli dostępna jest nowsza wersja rozszerzenia. bool
forceUpdateTag Jeśli podano wartość i różni się od poprzedniej wartości, program obsługi rozszerzeń zostanie zmuszony do aktualizacji, nawet jeśli konfiguracja rozszerzenia nie uległa zmianie. ciąg
protectedSettings Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione. W przypadku Bicep można użyć funkcji any().
protectedSettingsFromKeyVault Rozszerzenia chronione ustawienia, które są przekazywane przez odwołanie i używane z magazynu kluczy KeyVaultSecretReference
provisionAfterExtensions Kolekcja nazw rozszerzeń, po których należy aprowizować to rozszerzenie. ciąg[]
publisher Nazwa wydawcy programu obsługi rozszerzeń. ciąg
ustawienia Ustawienia publiczne w formacie Json dla rozszerzenia. W przypadku Bicep można użyć funkcji any().
suppressFailures Wskazuje, czy błędy wynikające z rozszerzenia zostaną pominięte (błędy operacyjne, takie jak brak połączenia z maszyną wirtualną, nie zostaną pominięte niezależnie od tej wartości). Wartością domyślną jest false. bool
typ Określa typ rozszerzenia; przykładem jest "CustomScriptExtension". ciąg
typeHandlerVersion Określa wersję programu obsługi skryptów. ciąg

KeyVaultSecretReference

Nazwa Opis Wartość
secretUrl Adres URL odwołujące się do wpisu tajnego w Key Vault. ciąg (wymagany)
sourceVault Względny adres URL Key Vault zawierający wpis tajny. SubResource (wymagane)

Podźródło

Nazwa Opis Wartość
identyfikator Identyfikator zasobu ciąg

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template Opis
Wdrażanie automatycznego skalowania w trybie darktrace vSensor

Wdróż na platformie Azure
Ten szablon umożliwia wdrażanie automatycznego skalowania wdrożenia modułów vSensorów Darktrace
Ten szablon odszyfrowuje wcześniej zaszyfrowane maszyny wirtualne z systemem Windows

Wdróż na platformie Azure
Ten szablon wyłącza szyfrowanie w uruchomionym zestawie skalowania maszyn wirtualnych z systemem Windows
Ten szablon szyfruje uruchomioną maszynę wirtualną z systemem Windows

Wdróż na platformie Azure
Ten szablon umożliwia szyfrowanie w uruchomionym zestawie skalowania maszyn wirtualnych z systemem Windows
Tworzenie i szyfrowanie nowego systemu Windows VMSS za pomocą serwera przesiadkowego

Wdróż na platformie Azure
Ten szablon umożliwia wdrożenie prostego zestawu skalowania maszyn wirtualnych z systemem Windows przy użyciu najnowszej poprawkowej wersji serwera systemu Windows. Ten szablon wdraża również skrzynkę przesiadkową z publicznym adresem IP w tej samej sieci wirtualnej. Możesz nawiązać połączenie z serwerem przesiadkowym za pośrednictwem tego publicznego adresu IP, a następnie połączyć się stamtąd z maszynami wirtualnymi w zestawie skalowania za pośrednictwem prywatnych adresów IP. Ten szablon umożliwia szyfrowanie w zestawie skalowania maszyn wirtualnych z systemem Windows.
Wdrażanie zaufanego zestawu skalowania maszyn wirtualnych z systemem Windows z obsługą uruchamiania

Wdróż na platformie Azure
Ten szablon umożliwia wdrożenie zaufanego zestawu skalowania maszyn wirtualnych z obsługą uruchamiania maszyn wirtualnych z systemem Windows przy użyciu najnowszej poprawkowej wersji Windows Server 2016, Windows Server 2019 lub Windows Server 2022 Azure Edition. Te maszyny wirtualne znajdują się za modułem równoważenia obciążenia z regułami translatora adresów sieciowych dla połączeń RDP. Jeśli włączysz funkcję Secureboot i vTPM, rozszerzenie zaświadczania gościa zostanie zainstalowane w usłudze VMSS. To rozszerzenie będzie wykonywać zdalne zaświadczanie przez chmurę.

Definicja zasobu szablonu usługi ARM

Typ zasobu virtualMachineScaleSets/extensions można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Compute/virtualMachineScaleSets/extensions, dodaj następujący kod JSON do szablonu.

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

Wartości właściwości

virtualMachineScaleSets/extensions

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Compute/virtualMachineScaleSets/extensions"
apiVersion Wersja interfejsu API zasobów '2023-09-01'
name Nazwa zasobu

Zobacz, jak ustawiać nazwy i typy dla zasobów podrzędnych w szablonach usługi ARM JSON.
ciąg (wymagany)
properties Opisuje właściwości rozszerzenia zestawu skalowania maszyn wirtualnych. VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

Nazwa Opis Wartość
autoUpgradeMinorVersion Wskazuje, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie będzie jednak uaktualniać wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true. bool
enableAutomaticUpgrade Wskazuje, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli dostępna jest nowsza wersja rozszerzenia. bool
forceUpdateTag Jeśli podano wartość i różni się od poprzedniej wartości, program obsługi rozszerzeń zostanie zmuszony do aktualizacji, nawet jeśli konfiguracja rozszerzenia nie uległa zmianie. ciąg
protectedSettings Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione.
protectedSettingsFromKeyVault Rozszerzenia chronione ustawienia, które są przekazywane przez odwołanie i używane z magazynu kluczy KeyVaultSecretReference
provisionAfterExtensions Kolekcja nazw rozszerzeń, po których należy aprowizować to rozszerzenie. ciąg[]
publisher Nazwa wydawcy programu obsługi rozszerzeń. ciąg
ustawienia Ustawienia publiczne w formacie Json dla rozszerzenia.
suppressFailures Wskazuje, czy błędy wynikające z rozszerzenia zostaną pominięte (błędy operacyjne, takie jak brak połączenia z maszyną wirtualną, nie zostaną pominięte niezależnie od tej wartości). Wartością domyślną jest false. bool
typ Określa typ rozszerzenia; przykładem jest "CustomScriptExtension". ciąg
typeHandlerVersion Określa wersję programu obsługi skryptów. ciąg

KeyVaultSecretReference

Nazwa Opis Wartość
secretUrl Adres URL odwołujące się do wpisu tajnego w Key Vault. ciąg (wymagany)
sourceVault Względny adres URL Key Vault zawierający wpis tajny. SubResource (wymagane)

Podźródło

Nazwa Opis Wartość
identyfikator Identyfikator zasobu ciąg

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Template Opis
Wdrażanie automatycznego skalowania w trybie darktrace vSensor

Wdróż na platformie Azure
Ten szablon umożliwia wdrażanie automatycznego skalowania wdrożenia modułów vSensorów Darktrace
Ten szablon odszyfrowuje wcześniej zaszyfrowane maszyny wirtualne z systemem Windows

Wdróż na platformie Azure
Ten szablon wyłącza szyfrowanie w uruchomionym zestawie skalowania maszyn wirtualnych z systemem Windows
Ten szablon szyfruje uruchomioną maszynę wirtualną z systemem Windows

Wdróż na platformie Azure
Ten szablon umożliwia szyfrowanie w uruchomionym zestawie skalowania maszyn wirtualnych z systemem Windows
Tworzenie i szyfrowanie nowego systemu Windows VMSS za pomocą serwera przesiadkowego

Wdróż na platformie Azure
Ten szablon umożliwia wdrożenie prostego zestawu skalowania maszyn wirtualnych z systemem Windows przy użyciu najnowszej poprawkowej wersji serwera systemu Windows. Ten szablon wdraża również skrzynkę przesiadkową z publicznym adresem IP w tej samej sieci wirtualnej. Możesz nawiązać połączenie z serwerem przesiadkowym za pośrednictwem tego publicznego adresu IP, a następnie połączyć się stamtąd z maszynami wirtualnymi w zestawie skalowania za pośrednictwem prywatnych adresów IP. Ten szablon umożliwia szyfrowanie w zestawie skalowania maszyn wirtualnych z systemem Windows.
Wdrażanie zaufanego zestawu skalowania maszyn wirtualnych z systemem Windows z obsługą uruchamiania

Wdróż na platformie Azure
Ten szablon umożliwia wdrożenie zaufanego zestawu skalowania maszyn wirtualnych z obsługą uruchamiania maszyn wirtualnych z systemem Windows przy użyciu najnowszej poprawkowej wersji Windows Server 2016, Windows Server 2019 lub Windows Server 2022 Azure Edition. Te maszyny wirtualne znajdują się za modułem równoważenia obciążenia z regułami translatora adresów sieciowych dla połączeń RDP. Jeśli włączysz funkcję Secureboot i vTPM, rozszerzenie zaświadczania gościa zostanie zainstalowane w usłudze VMSS. To rozszerzenie będzie wykonywać zdalne zaświadczanie przez chmurę.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu virtualMachineScaleSets/extensions można wdrożyć przy użyciu operacji docelowych:

  • Grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Compute/virtualMachineScaleSets/extensions, dodaj następujące narzędzie Terraform do szablonu.

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

Wartości właściwości

virtualMachineScaleSets/extensions

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Compute/virtualMachineScaleSets/extensions@2023-09-01"
name Nazwa zasobu ciąg (wymagany)
parent_id Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: virtualMachineScaleSets
properties Opisuje właściwości rozszerzenia zestawu skalowania maszyn wirtualnych. VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

Nazwa Opis Wartość
autoUpgradeMinorVersion Wskazuje, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie będzie jednak uaktualniać wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true. bool
enableAutomaticUpgrade Wskazuje, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli dostępna jest nowsza wersja rozszerzenia. bool
forceUpdateTag Jeśli podano wartość i różni się od poprzedniej wartości, program obsługi rozszerzeń zostanie zmuszony do aktualizacji, nawet jeśli konfiguracja rozszerzenia nie uległa zmianie. ciąg
protectedSettings Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione.
protectedSettingsFromKeyVault Rozszerzenia chronione ustawienia, które są przekazywane przez odwołanie i używane z magazynu kluczy KeyVaultSecretReference
provisionAfterExtensions Kolekcja nazw rozszerzeń, po których należy aprowizować to rozszerzenie. ciąg[]
publisher Nazwa wydawcy programu obsługi rozszerzeń. ciąg
ustawienia Ustawienia publiczne w formacie Json dla rozszerzenia.
suppressFailures Wskazuje, czy błędy wynikające z rozszerzenia zostaną pominięte (błędy operacyjne, takie jak brak połączenia z maszyną wirtualną, nie zostaną pominięte niezależnie od tej wartości). Wartością domyślną jest false. bool
typ Określa typ rozszerzenia; przykładem jest "CustomScriptExtension". ciąg
typeHandlerVersion Określa wersję programu obsługi skryptów. ciąg

KeyVaultSecretReference

Nazwa Opis Wartość
secretUrl Adres URL odwołujące się do wpisu tajnego w Key Vault. ciąg (wymagany)
sourceVault Względny adres URL Key Vault zawierający wpis tajny. SubResource (wymagane)

Podźródło

Nazwa Opis Wartość
identyfikator Identyfikator zasobu ciąg