Freigeben über

Microsoft.Compute virtualMachineScaleSets/extensions 2023-07-01

  • Artikel

Bicep-Ressourcendefinition

Der Ressourcentyp "virtualMachineScaleSets/extensions" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Compute/virtualMachineScaleSets/Extensions-Ressource zu erstellen, fügen Sie der Vorlage die folgende Bicep hinzu.

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

Eigenschaftswerte

virtualMachineScaleSets/Extensions

Name Beschreibung Wert
Name Der Ressourcenname

Erfahren Sie, wie Sie Namen und Typen für untergeordnete Ressourcen in Bicep-festlegen.		 Zeichenfolge (erforderlich)
Elternteil In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.		 Symbolischer Name für Die Ressource des Typs: virtualMachineScaleSets
Eigenschaften Beschreibt die Eigenschaften einer Skalierungssatzerweiterung für virtuelle Computer. VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

Name Beschreibung Wert
autoUpgradeMinorVersion Gibt an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zur Bereitstellungszeit verfügbar ist. Nach der Bereitstellung aktualisiert die Erweiterung jedoch keine Nebenversionen, es sei denn, sie werden erneut bereitgestellt, auch wenn diese Eigenschaft auf "true" festgelegt ist. Bool
enableAutomaticUpgrade Gibt an, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version der Erweiterung verfügbar ist. Bool
forceUpdateTag Wenn ein Wert bereitgestellt wird und sich vom vorherigen Wert unterscheidet, wird der Erweiterungshandler gezwungen, zu aktualisieren, auch wenn sich die Erweiterungskonfiguration nicht geändert hat. Schnur
protectedSettings Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder gar keine geschützten Einstellungen enthalten. Für Bicep können Sie die any()-Funktion verwenden.
protectedSettingsFromKeyVault Die durch Verweis übergebenen Erweiterungen geschützten Einstellungen und vom Key Vault genutzt werden KeyVaultSecretReference
provisionAfterExtensions Sammlung von Erweiterungsnamen, nach denen diese Erweiterung bereitgestellt werden muss. string[]
Verlag Der Name des Herausgebers des Erweiterungshandlers. Schnur
Einstellungen Json formatierte öffentliche Einstellungen für die Erweiterung. Für Bicep können Sie die any()-Funktion verwenden.
suppressFailures Gibt an, ob Fehler, die aus der Erweiterung stammen, unterdrückt werden (Betriebsfehler, z. B. keine Verbindung mit dem virtuellen Computer, werden unabhängig von diesem Wert nicht unterdrückt). Der Standardwert ist "false". Bool
Art Gibt den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension". Schnur
typeHandlerVersion Gibt die Version des Skripthandlers an. Schnur

KeyVaultSecretReference

Name Beschreibung Wert
secretUrl Die URL, die auf einen geheimen Schlüssel in einem Key Vault verweist. Zeichenfolge (erforderlich)
sourceVault Die relative URL des Schlüsseltresors, der den geheimen Schlüssel enthält. SubResource- (erforderlich)

Unterressource

Name Beschreibung Wert
id Ressourcen-ID Schnur

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone Beschreibung
Bereitstellen der automatischen Skalierung von Darktrace vSensors

Bereitstellen in Azure 		Mit dieser Vorlage können Sie eine automatische Skalierungsbereitstellung von Darktrace vSensors bereitstellen.
Diese Vorlage entschlüsselt zuvor verschlüsselte Windows VMSS-

Bereitstellen in Azure 		Diese Vorlage deaktiviert die Verschlüsselung für einen ausgeführten Windows-VM-Skalierungssatz.
Diese Vorlage verschlüsselt eine ausgeführte Windows VMSS-

Bereitstellen in Azure 		Diese Vorlage aktiviert die Verschlüsselung für einen ausgeführten Windows-VM-Skalierungssatz.
Erstellen und Verschlüsseln einer neuen Windows-VMSS mit Jumpbox-

Bereitstellen in Azure 		Mit dieser Vorlage können Sie einen einfachen VM Scale Set von Windows-VMs mithilfe der letzten gepatchten Version von serveralen Windows-Versionen bereitstellen. Diese Vorlage stellt auch einen Jumpbox mit einer öffentlichen IP-Adresse im selben virtuellen Netzwerk bereit. Sie können über diese öffentliche IP-Adresse eine Verbindung mit dem Jumpbox herstellen und dann über private IP-Adressen eine Verbindung mit virtuellen Computern herstellen. Diese Vorlage aktiviert die Verschlüsselung für den VM-Skalierungssatz von Windows-VMs.
Bereitstellen eines vertrauenswürdigen Start-fähigen Windows-VM-Skalierungssatzes

Bereitstellen in Azure 		Diese Vorlage ermöglicht Ihnen die Bereitstellung eines vertrauenswürdigen Launchfähigen VM-Skalierungssatzes von Windows-VMs mit der neuesten gepatchten Version von Windows Server 2016, Windows Server 2019 oder Windows Server 2022 Azure Edition. Diese virtuellen Computer befinden sich hinter einem Lastenausgleichsmodul mit NAT-Regeln für RDP-Verbindungen. Wenn Sie Secureboot und vTPM aktivieren, wird die Erweiterung für den Gastnachweis auf Ihrem VMSS installiert. Diese Erweiterung führt remote Nachweis von der Cloud aus.

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "virtualMachineScaleSets/extensions" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Ressource "Microsoft.Compute/virtualMachineScaleSets/extensions" zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

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

Eigenschaftswerte

virtualMachineScaleSets/Extensions

Name Beschreibung Wert
Art Der Ressourcentyp "Microsoft.Compute/virtualMachineScaleSets/extensions"
apiVersion Die Ressourcen-API-Version '2023-07-01'
Name Der Ressourcenname

Erfahren Sie, wie Sie Namen und Typen für untergeordnete Ressourcen in JSON ARM-Vorlagenfestlegen.		 Zeichenfolge (erforderlich)
Eigenschaften Beschreibt die Eigenschaften einer Skalierungssatzerweiterung für virtuelle Computer. VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

Name Beschreibung Wert
autoUpgradeMinorVersion Gibt an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zur Bereitstellungszeit verfügbar ist. Nach der Bereitstellung aktualisiert die Erweiterung jedoch keine Nebenversionen, es sei denn, sie werden erneut bereitgestellt, auch wenn diese Eigenschaft auf "true" festgelegt ist. Bool
enableAutomaticUpgrade Gibt an, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version der Erweiterung verfügbar ist. Bool
forceUpdateTag Wenn ein Wert bereitgestellt wird und sich vom vorherigen Wert unterscheidet, wird der Erweiterungshandler gezwungen, zu aktualisieren, auch wenn sich die Erweiterungskonfiguration nicht geändert hat. Schnur
protectedSettings Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder gar keine geschützten Einstellungen enthalten.
protectedSettingsFromKeyVault Die durch Verweis übergebenen Erweiterungen geschützten Einstellungen und vom Key Vault genutzt werden KeyVaultSecretReference
provisionAfterExtensions Sammlung von Erweiterungsnamen, nach denen diese Erweiterung bereitgestellt werden muss. string[]
Verlag Der Name des Herausgebers des Erweiterungshandlers. Schnur
Einstellungen Json formatierte öffentliche Einstellungen für die Erweiterung.
suppressFailures Gibt an, ob Fehler, die aus der Erweiterung stammen, unterdrückt werden (Betriebsfehler, z. B. keine Verbindung mit dem virtuellen Computer, werden unabhängig von diesem Wert nicht unterdrückt). Der Standardwert ist "false". Bool
Art Gibt den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension". Schnur
typeHandlerVersion Gibt die Version des Skripthandlers an. Schnur

KeyVaultSecretReference

Name Beschreibung Wert
secretUrl Die URL, die auf einen geheimen Schlüssel in einem Key Vault verweist. Zeichenfolge (erforderlich)
sourceVault Die relative URL des Schlüsseltresors, der den geheimen Schlüssel enthält. SubResource- (erforderlich)

Unterressource

Name Beschreibung Wert
id Ressourcen-ID Schnur

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone Beschreibung
Bereitstellen der automatischen Skalierung von Darktrace vSensors

Bereitstellen in Azure 		Mit dieser Vorlage können Sie eine automatische Skalierungsbereitstellung von Darktrace vSensors bereitstellen.
Diese Vorlage entschlüsselt zuvor verschlüsselte Windows VMSS-

Bereitstellen in Azure 		Diese Vorlage deaktiviert die Verschlüsselung für einen ausgeführten Windows-VM-Skalierungssatz.
Diese Vorlage verschlüsselt eine ausgeführte Windows VMSS-

Bereitstellen in Azure 		Diese Vorlage aktiviert die Verschlüsselung für einen ausgeführten Windows-VM-Skalierungssatz.
Erstellen und Verschlüsseln einer neuen Windows-VMSS mit Jumpbox-

Bereitstellen in Azure 		Mit dieser Vorlage können Sie einen einfachen VM Scale Set von Windows-VMs mithilfe der letzten gepatchten Version von serveralen Windows-Versionen bereitstellen. Diese Vorlage stellt auch einen Jumpbox mit einer öffentlichen IP-Adresse im selben virtuellen Netzwerk bereit. Sie können über diese öffentliche IP-Adresse eine Verbindung mit dem Jumpbox herstellen und dann über private IP-Adressen eine Verbindung mit virtuellen Computern herstellen. Diese Vorlage aktiviert die Verschlüsselung für den VM-Skalierungssatz von Windows-VMs.
Bereitstellen eines vertrauenswürdigen Start-fähigen Windows-VM-Skalierungssatzes

Bereitstellen in Azure 		Diese Vorlage ermöglicht Ihnen die Bereitstellung eines vertrauenswürdigen Launchfähigen VM-Skalierungssatzes von Windows-VMs mit der neuesten gepatchten Version von Windows Server 2016, Windows Server 2019 oder Windows Server 2022 Azure Edition. Diese virtuellen Computer befinden sich hinter einem Lastenausgleichsmodul mit NAT-Regeln für RDP-Verbindungen. Wenn Sie Secureboot und vTPM aktivieren, wird die Erweiterung für den Gastnachweis auf Ihrem VMSS installiert. Diese Erweiterung führt remote Nachweis von der Cloud aus.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "virtualMachineScaleSets/extensions" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Ressource "Microsoft.Compute/virtualMachineScaleSets/extensions" zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

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

Eigenschaftswerte

virtualMachineScaleSets/Extensions

Name Beschreibung Wert
Art Der Ressourcentyp "Microsoft.Compute/virtualMachineScaleSets/extensions@2023-07-01"
Name Der Ressourcenname Zeichenfolge (erforderlich)
parent_id Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource des Typs: virtualMachineScaleSets
Eigenschaften Beschreibt die Eigenschaften einer Skalierungssatzerweiterung für virtuelle Computer. VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

Name Beschreibung Wert
autoUpgradeMinorVersion Gibt an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zur Bereitstellungszeit verfügbar ist. Nach der Bereitstellung aktualisiert die Erweiterung jedoch keine Nebenversionen, es sei denn, sie werden erneut bereitgestellt, auch wenn diese Eigenschaft auf "true" festgelegt ist. Bool
enableAutomaticUpgrade Gibt an, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version der Erweiterung verfügbar ist. Bool
forceUpdateTag Wenn ein Wert bereitgestellt wird und sich vom vorherigen Wert unterscheidet, wird der Erweiterungshandler gezwungen, zu aktualisieren, auch wenn sich die Erweiterungskonfiguration nicht geändert hat. Schnur
protectedSettings Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder gar keine geschützten Einstellungen enthalten.
protectedSettingsFromKeyVault Die durch Verweis übergebenen Erweiterungen geschützten Einstellungen und vom Key Vault genutzt werden KeyVaultSecretReference
provisionAfterExtensions Sammlung von Erweiterungsnamen, nach denen diese Erweiterung bereitgestellt werden muss. string[]
Verlag Der Name des Herausgebers des Erweiterungshandlers. Schnur
Einstellungen Json formatierte öffentliche Einstellungen für die Erweiterung.
suppressFailures Gibt an, ob Fehler, die aus der Erweiterung stammen, unterdrückt werden (Betriebsfehler, z. B. keine Verbindung mit dem virtuellen Computer, werden unabhängig von diesem Wert nicht unterdrückt). Der Standardwert ist "false". Bool
Art Gibt den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension". Schnur
typeHandlerVersion Gibt die Version des Skripthandlers an. Schnur

KeyVaultSecretReference

Name Beschreibung Wert
secretUrl Die URL, die auf einen geheimen Schlüssel in einem Key Vault verweist. Zeichenfolge (erforderlich)
sourceVault Die relative URL des Schlüsseltresors, der den geheimen Schlüssel enthält. SubResource- (erforderlich)

Unterressource

Name Beschreibung Wert
id Ressourcen-ID Schnur