Microsoft.Compute virtualMachineScaleSets/extensions 2023-09-01

• neueste
• 2024-07-01
• 2024-03-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
• 2020-06-01
• 2019-12-01
• 2019-07-01
• 2019-03-01
• 2018-10-01
• 2018-06-01
• 2018-04-01
• 2017-12-01
• 2017-03-30

Bicep-Ressourcendefinition

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

• Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle

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-09-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    autoUpgradeMinorVersion: bool
    enableAutomaticUpgrade: bool
    forceUpdateTag: 'string'
    protectedSettings: any(Azure.Bicep.Types.Concrete.AnyType)
    protectedSettingsFromKeyVault: {
      secretUrl: 'string'
      sourceVault: {
        id: 'string'
      }
    }
    provisionAfterExtensions: [
      'string'
    ]
    publisher: 'string'
    settings: any(Azure.Bicep.Types.Concrete.AnyType)
    suppressFailures: bool
    type: 'string'
    typeHandlerVersion: 'string'
  }
}

Eigenschaftswerte

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)

Microsoft.Compute/virtualMachineScaleSets/extensions

Name	Beschreibung	Wert
Name	Der Ressourcenname	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

Unterressource

Name	Beschreibung	Wert
id	Ressourcen-ID	Schnur

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.	jegliche
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.	jegliche
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

Schnellstartbeispiele

Die folgenden Schnellstartbeispiele stellen diesen Ressourcentyp bereit.

Bicep-Datei

Beschreibung

Bereitstellen eines vertrauenswürdigen Start-fähigen Windows-VM-Skalierungssatzes

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:

• Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle

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

Eigenschaftswerte

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)

Microsoft.Compute/virtualMachineScaleSets/extensions

Name	Beschreibung	Wert
apiVersion	Die API-Version	'2023-09-01'
Name	Der Ressourcenname	Zeichenfolge (erforderlich)
Eigenschaften	Beschreibt die Eigenschaften einer Skalierungssatzerweiterung für virtuelle Computer.	VirtualMachineScaleSetExtensionProperties
Art	Der Ressourcentyp	"Microsoft.Compute/virtualMachineScaleSets/extensions"

Unterressource

Name	Beschreibung	Wert
id	Ressourcen-ID	Schnur

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.	jegliche
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.	jegliche
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

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone	Beschreibung
Erstellen und Verschlüsseln einer neuen Windows-VMSS mit Jumpbox-	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	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.
Bereitstellen der automatischen Skalierung von Darktrace vSensors	Mit dieser Vorlage können Sie eine automatische Skalierungsbereitstellung von Darktrace vSensors bereitstellen.
Diese Vorlage entschlüsselt zuvor verschlüsselte Windows VMSS-	Diese Vorlage deaktiviert die Verschlüsselung für einen ausgeführten Windows-VM-Skalierungssatz.
Diese Vorlage verschlüsselt eine ausgeführte Windows VMSS-	Diese Vorlage aktiviert die Verschlüsselung für einen ausgeführten Windows-VM-Skalierungssatz.

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-09-01"
  name = "string"
  body = jsonencode({
    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

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)

Microsoft.Compute/virtualMachineScaleSets/extensions

Name	Beschreibung	Wert
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
Art	Der Ressourcentyp	"Microsoft.Compute/virtualMachineScaleSets/extensions@2023-09-01"

Unterressource

Name	Beschreibung	Wert
id	Ressourcen-ID	Schnur

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.	jegliche
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.	jegliche
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