1. Packages
  2. Azure Classic
  3. API Docs
  4. compute
  5. VirtualMachineScaleSetExtension

We recommend using Azure Native.

Viewing docs for Azure v4.42.0 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
azure logo

We recommend using Azure Native.

Viewing docs for Azure v4.42.0 (Older version)
published on Monday, Mar 9, 2026 by Pulumi

    Manages an Extension for a Virtual Machine Scale Set.

    NOTE: This resource is not intended to be used with the azure.compute.ScaleSet resource - instead it’s intended for this to be used with the azure.compute.LinuxVirtualMachineScaleSet and azure.compute.WindowsVirtualMachineScaleSet resources.

    Example Usage

    using System.Collections.Generic;
    using System.Text.Json;
    using Pulumi;
    using Azure = Pulumi.Azure;
    
    class MyStack : Stack
    {
        public MyStack()
        {
            var exampleLinuxVirtualMachineScaleSet = new Azure.Compute.LinuxVirtualMachineScaleSet("exampleLinuxVirtualMachineScaleSet", new Azure.Compute.LinuxVirtualMachineScaleSetArgs
            {
            });
            //...
            var exampleVirtualMachineScaleSetExtension = new Azure.Compute.VirtualMachineScaleSetExtension("exampleVirtualMachineScaleSetExtension", new Azure.Compute.VirtualMachineScaleSetExtensionArgs
            {
                VirtualMachineScaleSetId = exampleLinuxVirtualMachineScaleSet.Id,
                Publisher = "Microsoft.Azure.Extensions",
                Type = "CustomScript",
                TypeHandlerVersion = "2.0",
                Settings = JsonSerializer.Serialize(new Dictionary<string, object?>
                {
                    { "commandToExecute", "echo $HOSTNAME" },
                }),
            });
        }
    
    }
    
    package main
    
    import (
    	"encoding/json"
    	"fmt"
    
    	"github.com/pulumi/pulumi-azure/sdk/v4/go/azure/compute"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		exampleLinuxVirtualMachineScaleSet, err := compute.NewLinuxVirtualMachineScaleSet(ctx, "exampleLinuxVirtualMachineScaleSet", nil)
    		if err != nil {
    			return err
    		}
    		tmpJSON0, err := json.Marshal(map[string]interface{}{
    			"commandToExecute": fmt.Sprintf("%v%v%v", "echo ", "$", "HOSTNAME"),
    		})
    		if err != nil {
    			return err
    		}
    		json0 := string(tmpJSON0)
    		_, err = compute.NewVirtualMachineScaleSetExtension(ctx, "exampleVirtualMachineScaleSetExtension", &compute.VirtualMachineScaleSetExtensionArgs{
    			VirtualMachineScaleSetId: exampleLinuxVirtualMachineScaleSet.ID(),
    			Publisher:                pulumi.String("Microsoft.Azure.Extensions"),
    			Type:                     pulumi.String("CustomScript"),
    			TypeHandlerVersion:       pulumi.String("2.0"),
    			Settings:                 pulumi.String(json0),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    

    Example coming soon!

    import * as pulumi from "@pulumi/pulumi";
    import * as azure from "@pulumi/azure";
    
    const exampleLinuxVirtualMachineScaleSet = new azure.compute.LinuxVirtualMachineScaleSet("exampleLinuxVirtualMachineScaleSet", {});
    //...
    const exampleVirtualMachineScaleSetExtension = new azure.compute.VirtualMachineScaleSetExtension("exampleVirtualMachineScaleSetExtension", {
        virtualMachineScaleSetId: exampleLinuxVirtualMachineScaleSet.id,
        publisher: "Microsoft.Azure.Extensions",
        type: "CustomScript",
        typeHandlerVersion: "2.0",
        settings: JSON.stringify({
            commandToExecute: `echo $HOSTNAME`,
        }),
    });
    
    import pulumi
    import json
    import pulumi_azure as azure
    
    example_linux_virtual_machine_scale_set = azure.compute.LinuxVirtualMachineScaleSet("exampleLinuxVirtualMachineScaleSet")
    #...
    example_virtual_machine_scale_set_extension = azure.compute.VirtualMachineScaleSetExtension("exampleVirtualMachineScaleSetExtension",
        virtual_machine_scale_set_id=example_linux_virtual_machine_scale_set.id,
        publisher="Microsoft.Azure.Extensions",
        type="CustomScript",
        type_handler_version="2.0",
        settings=json.dumps({
            "commandToExecute": "echo $HOSTNAME",
        }))
    

    Example coming soon!

    Create VirtualMachineScaleSetExtension Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new VirtualMachineScaleSetExtension(name: string, args: VirtualMachineScaleSetExtensionArgs, opts?: CustomResourceOptions);
    @overload
    def VirtualMachineScaleSetExtension(resource_name: str,
                                        args: VirtualMachineScaleSetExtensionArgs,
                                        opts: Optional[ResourceOptions] = None)
    
    @overload
    def VirtualMachineScaleSetExtension(resource_name: str,
                                        opts: Optional[ResourceOptions] = None,
                                        publisher: Optional[str] = None,
                                        type: Optional[str] = None,
                                        type_handler_version: Optional[str] = None,
                                        virtual_machine_scale_set_id: Optional[str] = None,
                                        auto_upgrade_minor_version: Optional[bool] = None,
                                        automatic_upgrade_enabled: Optional[bool] = None,
                                        force_update_tag: Optional[str] = None,
                                        name: Optional[str] = None,
                                        protected_settings: Optional[str] = None,
                                        provision_after_extensions: Optional[Sequence[str]] = None,
                                        settings: Optional[str] = None)
    func NewVirtualMachineScaleSetExtension(ctx *Context, name string, args VirtualMachineScaleSetExtensionArgs, opts ...ResourceOption) (*VirtualMachineScaleSetExtension, error)
    public VirtualMachineScaleSetExtension(string name, VirtualMachineScaleSetExtensionArgs args, CustomResourceOptions? opts = null)
    public VirtualMachineScaleSetExtension(String name, VirtualMachineScaleSetExtensionArgs args)
    public VirtualMachineScaleSetExtension(String name, VirtualMachineScaleSetExtensionArgs args, CustomResourceOptions options)
    
    type: azure:compute:VirtualMachineScaleSetExtension
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args VirtualMachineScaleSetExtensionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args VirtualMachineScaleSetExtensionArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args VirtualMachineScaleSetExtensionArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args VirtualMachineScaleSetExtensionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args VirtualMachineScaleSetExtensionArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var virtualMachineScaleSetExtensionResource = new Azure.Compute.VirtualMachineScaleSetExtension("virtualMachineScaleSetExtensionResource", new()
    {
        Publisher = "string",
        Type = "string",
        TypeHandlerVersion = "string",
        VirtualMachineScaleSetId = "string",
        AutoUpgradeMinorVersion = false,
        AutomaticUpgradeEnabled = false,
        ForceUpdateTag = "string",
        Name = "string",
        ProtectedSettings = "string",
        ProvisionAfterExtensions = new[]
        {
            "string",
        },
        Settings = "string",
    });
    
    example, err := compute.NewVirtualMachineScaleSetExtension(ctx, "virtualMachineScaleSetExtensionResource", &compute.VirtualMachineScaleSetExtensionArgs{
    	Publisher:                pulumi.String("string"),
    	Type:                     pulumi.String("string"),
    	TypeHandlerVersion:       pulumi.String("string"),
    	VirtualMachineScaleSetId: pulumi.String("string"),
    	AutoUpgradeMinorVersion:  pulumi.Bool(false),
    	AutomaticUpgradeEnabled:  pulumi.Bool(false),
    	ForceUpdateTag:           pulumi.String("string"),
    	Name:                     pulumi.String("string"),
    	ProtectedSettings:        pulumi.String("string"),
    	ProvisionAfterExtensions: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	Settings: pulumi.String("string"),
    })
    
    var virtualMachineScaleSetExtensionResource = new VirtualMachineScaleSetExtension("virtualMachineScaleSetExtensionResource", VirtualMachineScaleSetExtensionArgs.builder()
        .publisher("string")
        .type("string")
        .typeHandlerVersion("string")
        .virtualMachineScaleSetId("string")
        .autoUpgradeMinorVersion(false)
        .automaticUpgradeEnabled(false)
        .forceUpdateTag("string")
        .name("string")
        .protectedSettings("string")
        .provisionAfterExtensions("string")
        .settings("string")
        .build());
    
    virtual_machine_scale_set_extension_resource = azure.compute.VirtualMachineScaleSetExtension("virtualMachineScaleSetExtensionResource",
        publisher="string",
        type="string",
        type_handler_version="string",
        virtual_machine_scale_set_id="string",
        auto_upgrade_minor_version=False,
        automatic_upgrade_enabled=False,
        force_update_tag="string",
        name="string",
        protected_settings="string",
        provision_after_extensions=["string"],
        settings="string")
    
    const virtualMachineScaleSetExtensionResource = new azure.compute.VirtualMachineScaleSetExtension("virtualMachineScaleSetExtensionResource", {
        publisher: "string",
        type: "string",
        typeHandlerVersion: "string",
        virtualMachineScaleSetId: "string",
        autoUpgradeMinorVersion: false,
        automaticUpgradeEnabled: false,
        forceUpdateTag: "string",
        name: "string",
        protectedSettings: "string",
        provisionAfterExtensions: ["string"],
        settings: "string",
    });
    
    type: azure:compute:VirtualMachineScaleSetExtension
    properties:
        autoUpgradeMinorVersion: false
        automaticUpgradeEnabled: false
        forceUpdateTag: string
        name: string
        protectedSettings: string
        provisionAfterExtensions:
            - string
        publisher: string
        settings: string
        type: string
        typeHandlerVersion: string
        virtualMachineScaleSetId: string
    

    VirtualMachineScaleSetExtension Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The VirtualMachineScaleSetExtension resource accepts the following input properties:

    Publisher string
    Specifies the Publisher of the Extension. Changing this forces a new resource to be created.
    Type string
    Specifies the Type of the Extension. Changing this forces a new resource to be created.
    TypeHandlerVersion string
    Specifies the version of the extension to use, available versions can be found using the Azure CLI.
    VirtualMachineScaleSetId string
    The ID of the Virtual Machine Scale Set. Changing this forces a new resource to be created.
    AutoUpgradeMinorVersion bool
    Should the latest version of the Extension be used at Deployment Time, if one is available? This won't auto-update the extension on existing installation. Defaults to true.
    AutomaticUpgradeEnabled bool
    Should the Extension be automatically updated whenever the Publisher releases a new version of this VM Extension? Defaults to false.
    ForceUpdateTag string
    A value which, when different to the previous value can be used to force-run the Extension even if the Extension Configuration hasn't changed.
    Name string
    The name for the Virtual Machine Scale Set Extension. Changing this forces a new resource to be created.
    ProtectedSettings string
    A JSON String which specifies Sensitive Settings (such as Passwords) for the Extension.
    ProvisionAfterExtensions List<string>
    An ordered list of Extension names which this should be provisioned after.
    Settings string
    A JSON String which specifies Settings for the Extension.
    Publisher string
    Specifies the Publisher of the Extension. Changing this forces a new resource to be created.
    Type string
    Specifies the Type of the Extension. Changing this forces a new resource to be created.
    TypeHandlerVersion string
    Specifies the version of the extension to use, available versions can be found using the Azure CLI.
    VirtualMachineScaleSetId string
    The ID of the Virtual Machine Scale Set. Changing this forces a new resource to be created.
    AutoUpgradeMinorVersion bool
    Should the latest version of the Extension be used at Deployment Time, if one is available? This won't auto-update the extension on existing installation. Defaults to true.
    AutomaticUpgradeEnabled bool
    Should the Extension be automatically updated whenever the Publisher releases a new version of this VM Extension? Defaults to false.
    ForceUpdateTag string
    A value which, when different to the previous value can be used to force-run the Extension even if the Extension Configuration hasn't changed.
    Name string
    The name for the Virtual Machine Scale Set Extension. Changing this forces a new resource to be created.
    ProtectedSettings string
    A JSON String which specifies Sensitive Settings (such as Passwords) for the Extension.
    ProvisionAfterExtensions []string
    An ordered list of Extension names which this should be provisioned after.
    Settings string
    A JSON String which specifies Settings for the Extension.
    publisher String
    Specifies the Publisher of the Extension. Changing this forces a new resource to be created.
    type String
    Specifies the Type of the Extension. Changing this forces a new resource to be created.
    typeHandlerVersion String
    Specifies the version of the extension to use, available versions can be found using the Azure CLI.
    virtualMachineScaleSetId String
    The ID of the Virtual Machine Scale Set. Changing this forces a new resource to be created.
    autoUpgradeMinorVersion Boolean
    Should the latest version of the Extension be used at Deployment Time, if one is available? This won't auto-update the extension on existing installation. Defaults to true.
    automaticUpgradeEnabled Boolean
    Should the Extension be automatically updated whenever the Publisher releases a new version of this VM Extension? Defaults to false.
    forceUpdateTag String
    A value which, when different to the previous value can be used to force-run the Extension even if the Extension Configuration hasn't changed.
    name String
    The name for the Virtual Machine Scale Set Extension. Changing this forces a new resource to be created.
    protectedSettings String
    A JSON String which specifies Sensitive Settings (such as Passwords) for the Extension.
    provisionAfterExtensions List<String>
    An ordered list of Extension names which this should be provisioned after.
    settings String
    A JSON String which specifies Settings for the Extension.
    publisher string
    Specifies the Publisher of the Extension. Changing this forces a new resource to be created.
    type string
    Specifies the Type of the Extension. Changing this forces a new resource to be created.
    typeHandlerVersion string
    Specifies the version of the extension to use, available versions can be found using the Azure CLI.
    virtualMachineScaleSetId string
    The ID of the Virtual Machine Scale Set. Changing this forces a new resource to be created.
    autoUpgradeMinorVersion boolean
    Should the latest version of the Extension be used at Deployment Time, if one is available? This won't auto-update the extension on existing installation. Defaults to true.
    automaticUpgradeEnabled boolean
    Should the Extension be automatically updated whenever the Publisher releases a new version of this VM Extension? Defaults to false.
    forceUpdateTag string
    A value which, when different to the previous value can be used to force-run the Extension even if the Extension Configuration hasn't changed.
    name string
    The name for the Virtual Machine Scale Set Extension. Changing this forces a new resource to be created.
    protectedSettings string
    A JSON String which specifies Sensitive Settings (such as Passwords) for the Extension.
    provisionAfterExtensions string[]
    An ordered list of Extension names which this should be provisioned after.
    settings string
    A JSON String which specifies Settings for the Extension.
    publisher str
    Specifies the Publisher of the Extension. Changing this forces a new resource to be created.
    type str
    Specifies the Type of the Extension. Changing this forces a new resource to be created.
    type_handler_version str
    Specifies the version of the extension to use, available versions can be found using the Azure CLI.
    virtual_machine_scale_set_id str
    The ID of the Virtual Machine Scale Set. Changing this forces a new resource to be created.
    auto_upgrade_minor_version bool
    Should the latest version of the Extension be used at Deployment Time, if one is available? This won't auto-update the extension on existing installation. Defaults to true.
    automatic_upgrade_enabled bool
    Should the Extension be automatically updated whenever the Publisher releases a new version of this VM Extension? Defaults to false.
    force_update_tag str
    A value which, when different to the previous value can be used to force-run the Extension even if the Extension Configuration hasn't changed.
    name str
    The name for the Virtual Machine Scale Set Extension. Changing this forces a new resource to be created.
    protected_settings str
    A JSON String which specifies Sensitive Settings (such as Passwords) for the Extension.
    provision_after_extensions Sequence[str]
    An ordered list of Extension names which this should be provisioned after.
    settings str
    A JSON String which specifies Settings for the Extension.
    publisher String
    Specifies the Publisher of the Extension. Changing this forces a new resource to be created.
    type String
    Specifies the Type of the Extension. Changing this forces a new resource to be created.
    typeHandlerVersion String
    Specifies the version of the extension to use, available versions can be found using the Azure CLI.
    virtualMachineScaleSetId String
    The ID of the Virtual Machine Scale Set. Changing this forces a new resource to be created.
    autoUpgradeMinorVersion Boolean
    Should the latest version of the Extension be used at Deployment Time, if one is available? This won't auto-update the extension on existing installation. Defaults to true.
    automaticUpgradeEnabled Boolean
    Should the Extension be automatically updated whenever the Publisher releases a new version of this VM Extension? Defaults to false.
    forceUpdateTag String
    A value which, when different to the previous value can be used to force-run the Extension even if the Extension Configuration hasn't changed.
    name String
    The name for the Virtual Machine Scale Set Extension. Changing this forces a new resource to be created.
    protectedSettings String
    A JSON String which specifies Sensitive Settings (such as Passwords) for the Extension.
    provisionAfterExtensions List<String>
    An ordered list of Extension names which this should be provisioned after.
    settings String
    A JSON String which specifies Settings for the Extension.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the VirtualMachineScaleSetExtension resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing VirtualMachineScaleSetExtension Resource

    Get an existing VirtualMachineScaleSetExtension resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: VirtualMachineScaleSetExtensionState, opts?: CustomResourceOptions): VirtualMachineScaleSetExtension
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            auto_upgrade_minor_version: Optional[bool] = None,
            automatic_upgrade_enabled: Optional[bool] = None,
            force_update_tag: Optional[str] = None,
            name: Optional[str] = None,
            protected_settings: Optional[str] = None,
            provision_after_extensions: Optional[Sequence[str]] = None,
            publisher: Optional[str] = None,
            settings: Optional[str] = None,
            type: Optional[str] = None,
            type_handler_version: Optional[str] = None,
            virtual_machine_scale_set_id: Optional[str] = None) -> VirtualMachineScaleSetExtension
    func GetVirtualMachineScaleSetExtension(ctx *Context, name string, id IDInput, state *VirtualMachineScaleSetExtensionState, opts ...ResourceOption) (*VirtualMachineScaleSetExtension, error)
    public static VirtualMachineScaleSetExtension Get(string name, Input<string> id, VirtualMachineScaleSetExtensionState? state, CustomResourceOptions? opts = null)
    public static VirtualMachineScaleSetExtension get(String name, Output<String> id, VirtualMachineScaleSetExtensionState state, CustomResourceOptions options)
    resources:  _:    type: azure:compute:VirtualMachineScaleSetExtension    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AutoUpgradeMinorVersion bool
    Should the latest version of the Extension be used at Deployment Time, if one is available? This won't auto-update the extension on existing installation. Defaults to true.
    AutomaticUpgradeEnabled bool
    Should the Extension be automatically updated whenever the Publisher releases a new version of this VM Extension? Defaults to false.
    ForceUpdateTag string
    A value which, when different to the previous value can be used to force-run the Extension even if the Extension Configuration hasn't changed.
    Name string
    The name for the Virtual Machine Scale Set Extension. Changing this forces a new resource to be created.
    ProtectedSettings string
    A JSON String which specifies Sensitive Settings (such as Passwords) for the Extension.
    ProvisionAfterExtensions List<string>
    An ordered list of Extension names which this should be provisioned after.
    Publisher string
    Specifies the Publisher of the Extension. Changing this forces a new resource to be created.
    Settings string
    A JSON String which specifies Settings for the Extension.
    Type string
    Specifies the Type of the Extension. Changing this forces a new resource to be created.
    TypeHandlerVersion string
    Specifies the version of the extension to use, available versions can be found using the Azure CLI.
    VirtualMachineScaleSetId string
    The ID of the Virtual Machine Scale Set. Changing this forces a new resource to be created.
    AutoUpgradeMinorVersion bool
    Should the latest version of the Extension be used at Deployment Time, if one is available? This won't auto-update the extension on existing installation. Defaults to true.
    AutomaticUpgradeEnabled bool
    Should the Extension be automatically updated whenever the Publisher releases a new version of this VM Extension? Defaults to false.
    ForceUpdateTag string
    A value which, when different to the previous value can be used to force-run the Extension even if the Extension Configuration hasn't changed.
    Name string
    The name for the Virtual Machine Scale Set Extension. Changing this forces a new resource to be created.
    ProtectedSettings string
    A JSON String which specifies Sensitive Settings (such as Passwords) for the Extension.
    ProvisionAfterExtensions []string
    An ordered list of Extension names which this should be provisioned after.
    Publisher string
    Specifies the Publisher of the Extension. Changing this forces a new resource to be created.
    Settings string
    A JSON String which specifies Settings for the Extension.
    Type string
    Specifies the Type of the Extension. Changing this forces a new resource to be created.
    TypeHandlerVersion string
    Specifies the version of the extension to use, available versions can be found using the Azure CLI.
    VirtualMachineScaleSetId string
    The ID of the Virtual Machine Scale Set. Changing this forces a new resource to be created.
    autoUpgradeMinorVersion Boolean
    Should the latest version of the Extension be used at Deployment Time, if one is available? This won't auto-update the extension on existing installation. Defaults to true.
    automaticUpgradeEnabled Boolean
    Should the Extension be automatically updated whenever the Publisher releases a new version of this VM Extension? Defaults to false.
    forceUpdateTag String
    A value which, when different to the previous value can be used to force-run the Extension even if the Extension Configuration hasn't changed.
    name String
    The name for the Virtual Machine Scale Set Extension. Changing this forces a new resource to be created.
    protectedSettings String
    A JSON String which specifies Sensitive Settings (such as Passwords) for the Extension.
    provisionAfterExtensions List<String>
    An ordered list of Extension names which this should be provisioned after.
    publisher String
    Specifies the Publisher of the Extension. Changing this forces a new resource to be created.
    settings String
    A JSON String which specifies Settings for the Extension.
    type String
    Specifies the Type of the Extension. Changing this forces a new resource to be created.
    typeHandlerVersion String
    Specifies the version of the extension to use, available versions can be found using the Azure CLI.
    virtualMachineScaleSetId String
    The ID of the Virtual Machine Scale Set. Changing this forces a new resource to be created.
    autoUpgradeMinorVersion boolean
    Should the latest version of the Extension be used at Deployment Time, if one is available? This won't auto-update the extension on existing installation. Defaults to true.
    automaticUpgradeEnabled boolean
    Should the Extension be automatically updated whenever the Publisher releases a new version of this VM Extension? Defaults to false.
    forceUpdateTag string
    A value which, when different to the previous value can be used to force-run the Extension even if the Extension Configuration hasn't changed.
    name string
    The name for the Virtual Machine Scale Set Extension. Changing this forces a new resource to be created.
    protectedSettings string
    A JSON String which specifies Sensitive Settings (such as Passwords) for the Extension.
    provisionAfterExtensions string[]
    An ordered list of Extension names which this should be provisioned after.
    publisher string
    Specifies the Publisher of the Extension. Changing this forces a new resource to be created.
    settings string
    A JSON String which specifies Settings for the Extension.
    type string
    Specifies the Type of the Extension. Changing this forces a new resource to be created.
    typeHandlerVersion string
    Specifies the version of the extension to use, available versions can be found using the Azure CLI.
    virtualMachineScaleSetId string
    The ID of the Virtual Machine Scale Set. Changing this forces a new resource to be created.
    auto_upgrade_minor_version bool
    Should the latest version of the Extension be used at Deployment Time, if one is available? This won't auto-update the extension on existing installation. Defaults to true.
    automatic_upgrade_enabled bool
    Should the Extension be automatically updated whenever the Publisher releases a new version of this VM Extension? Defaults to false.
    force_update_tag str
    A value which, when different to the previous value can be used to force-run the Extension even if the Extension Configuration hasn't changed.
    name str
    The name for the Virtual Machine Scale Set Extension. Changing this forces a new resource to be created.
    protected_settings str
    A JSON String which specifies Sensitive Settings (such as Passwords) for the Extension.
    provision_after_extensions Sequence[str]
    An ordered list of Extension names which this should be provisioned after.
    publisher str
    Specifies the Publisher of the Extension. Changing this forces a new resource to be created.
    settings str
    A JSON String which specifies Settings for the Extension.
    type str
    Specifies the Type of the Extension. Changing this forces a new resource to be created.
    type_handler_version str
    Specifies the version of the extension to use, available versions can be found using the Azure CLI.
    virtual_machine_scale_set_id str
    The ID of the Virtual Machine Scale Set. Changing this forces a new resource to be created.
    autoUpgradeMinorVersion Boolean
    Should the latest version of the Extension be used at Deployment Time, if one is available? This won't auto-update the extension on existing installation. Defaults to true.
    automaticUpgradeEnabled Boolean
    Should the Extension be automatically updated whenever the Publisher releases a new version of this VM Extension? Defaults to false.
    forceUpdateTag String
    A value which, when different to the previous value can be used to force-run the Extension even if the Extension Configuration hasn't changed.
    name String
    The name for the Virtual Machine Scale Set Extension. Changing this forces a new resource to be created.
    protectedSettings String
    A JSON String which specifies Sensitive Settings (such as Passwords) for the Extension.
    provisionAfterExtensions List<String>
    An ordered list of Extension names which this should be provisioned after.
    publisher String
    Specifies the Publisher of the Extension. Changing this forces a new resource to be created.
    settings String
    A JSON String which specifies Settings for the Extension.
    type String
    Specifies the Type of the Extension. Changing this forces a new resource to be created.
    typeHandlerVersion String
    Specifies the version of the extension to use, available versions can be found using the Azure CLI.
    virtualMachineScaleSetId String
    The ID of the Virtual Machine Scale Set. Changing this forces a new resource to be created.

    Import

    Virtual Machine Scale Set Extensions can be imported using the resource id, e.g.

     $ pulumi import azure:compute/virtualMachineScaleSetExtension:VirtualMachineScaleSetExtension test /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.Compute/virtualMachineScaleSets/scaleSet1/extensions/extension1
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    Azure Classic pulumi/pulumi-azure
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the azurerm Terraform Provider.
    azure logo

    We recommend using Azure Native.

    Viewing docs for Azure v4.42.0 (Older version)
    published on Monday, Mar 9, 2026 by Pulumi
      Try Pulumi Cloud free. Your team will thank you.