pulumi-azure-native-kotlin/com.pulumi.azurenative.hybridcompute.kotlin/MachineExtension

MachineExtension

class MachineExtension : KotlinCustomResource

Describes a Machine Extension. Uses Azure REST API version 2024-07-10. In version 2.x of the Azure Native provider, it used API version 2022-12-27. Other available API versions: 2020-08-15-preview, 2021-01-28-preview, 2021-03-25-preview, 2021-04-22-preview, 2021-05-17-preview, 2021-05-20, 2021-06-10-preview, 2021-12-10-preview, 2022-03-10, 2022-05-10-preview, 2022-08-11-preview, 2022-11-10, 2022-12-27, 2022-12-27-preview, 2023-03-15-preview, 2023-06-20-preview, 2023-10-03-preview, 2024-03-31-preview, 2024-05-20-preview, 2024-07-31-preview, 2024-09-10-preview, 2024-11-10-preview, 2025-01-13, 2025-02-19-preview. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native hybridcompute [ApiVersion]. See the ../../../version-guide/#accessing-any-api-version-via-local-packages for details.

Example Usage

Create or Update a Machine Extension

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
    var machineExtension = new AzureNative.HybridCompute.MachineExtension("machineExtension", new()
    {
        ExtensionName = "CustomScriptExtension",
        Location = "eastus2euap",
        MachineName = "myMachine",
        Properties = new AzureNative.HybridCompute.Inputs.MachineExtensionPropertiesArgs
        {
            Publisher = "Microsoft.Compute",
            Settings = new Dictionary<string, object?>
            {
                ["commandToExecute"] = "powershell.exe -c \"Get-Process | Where-Object { $_.CPU -gt 10000 }\"",
            },
            Type = "CustomScriptExtension",
            TypeHandlerVersion = "1.10",
        },
        ResourceGroupName = "myResourceGroup",
    });
});

package main
import (
	hybridcompute "github.com/pulumi/pulumi-azure-native-sdk/hybridcompute/v3"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := hybridcompute.NewMachineExtension(ctx, "machineExtension", &hybridcompute.MachineExtensionArgs{
			ExtensionName: pulumi.String("CustomScriptExtension"),
			Location:      pulumi.String("eastus2euap"),
			MachineName:   pulumi.String("myMachine"),
			Properties: &hybridcompute.MachineExtensionPropertiesArgs{
				Publisher: pulumi.String("Microsoft.Compute"),
				Settings: pulumi.Any(map[string]interface{}{
					"commandToExecute": "powershell.exe -c \"Get-Process | Where-Object { $_.CPU -gt 10000 }\"",
				}),
				Type:               pulumi.String("CustomScriptExtension"),
				TypeHandlerVersion: pulumi.String("1.10"),
			},
			ResourceGroupName: pulumi.String("myResourceGroup"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.hybridcompute.MachineExtension;
import com.pulumi.azurenative.hybridcompute.MachineExtensionArgs;
import com.pulumi.azurenative.hybridcompute.inputs.MachineExtensionPropertiesArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var machineExtension = new MachineExtension("machineExtension", MachineExtensionArgs.builder()
            .extensionName("CustomScriptExtension")
            .location("eastus2euap")
            .machineName("myMachine")
            .properties(MachineExtensionPropertiesArgs.builder()
                .publisher("Microsoft.Compute")
                .settings(Map.of("commandToExecute", "powershell.exe -c \"Get-Process | Where-Object { $_.CPU -gt 10000 }\""))
                .type("CustomScriptExtension")
                .typeHandlerVersion("1.10")
                .build())
            .resourceGroupName("myResourceGroup")
            .build());
    }
}

Import

An existing resource can be imported using its type token, name, and identifier, e.g.

$ pulumi import azure-native:hybridcompute:MachineExtension CustomScriptExtension /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines/{machineName}/extensions/{extensionName}