pulumi-azure-native-kotlin/com.pulumi.azurenative.automation.kotlin/SoftwareUpdateConfigurationByNameArgs

SoftwareUpdateConfigurationByNameArgs

data class SoftwareUpdateConfigurationByNameArgs(val automationAccountName: Output<String>? = null, val error: Output<ErrorResponseArgs>? = null, val resourceGroupName: Output<String>? = null, val scheduleInfo: Output<SUCSchedulePropertiesArgs>? = null, val softwareUpdateConfigurationName: Output<String>? = null, val tasks: Output<SoftwareUpdateConfigurationTasksArgs>? = null, val updateConfiguration: Output<UpdateConfigurationArgs>? = null) : ConvertibleToJava<SoftwareUpdateConfigurationByNameArgs>

Software update configuration properties. Uses Azure REST API version 2023-05-15-preview. In version 2.x of the Azure Native provider, it used API version 2019-06-01. Other available API versions: 2017-05-15-preview, 2019-06-01, 2024-10-23. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native automation [ApiVersion]. See the ../../../version-guide/#accessing-any-api-version-via-local-packages for details.

Example Usage

Create software update configuration

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
    var softwareUpdateConfigurationByName = new AzureNative.Automation.SoftwareUpdateConfigurationByName("softwareUpdateConfigurationByName", new()
    {
        AutomationAccountName = "myaccount",
        ResourceGroupName = "mygroup",
        ScheduleInfo = new AzureNative.Automation.Inputs.SUCSchedulePropertiesArgs
        {
            AdvancedSchedule = new AzureNative.Automation.Inputs.AdvancedScheduleArgs
            {
                WeekDays = new[]
                {
                    "Monday",
                    "Thursday",
                },
            },
            ExpiryTime = "2018-11-09T11:22:57+00:00",
            Frequency = AzureNative.Automation.ScheduleFrequency.Hour,
            Interval = 1,
            StartTime = "2017-10-19T12:22:57+00:00",
            TimeZone = "America/Los_Angeles",
        },
        SoftwareUpdateConfigurationName = "testpatch",
        Tasks = new AzureNative.Automation.Inputs.SoftwareUpdateConfigurationTasksArgs
        {
            PostTask = new AzureNative.Automation.Inputs.TaskPropertiesArgs
            {
                Source = "GetCache",
            },
            PreTask = new AzureNative.Automation.Inputs.TaskPropertiesArgs
            {
                Parameters =
                {
                    { "COMPUTERNAME", "Computer1" },
                },
                Source = "HelloWorld",
            },
        },
        UpdateConfiguration = new AzureNative.Automation.Inputs.UpdateConfigurationArgs
        {
            AzureVirtualMachines = new[]
            {
                "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01",
                "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02",
                "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03",
            },
            Duration = "PT2H0M",
            NonAzureComputerNames = new[]
            {
                "box1.contoso.com",
                "box2.contoso.com",
            },
            OperatingSystem = AzureNative.Automation.OperatingSystemType.Windows,
            Targets = new AzureNative.Automation.Inputs.TargetPropertiesArgs
            {
                AzureQueries = new[]
                {
                    new AzureNative.Automation.Inputs.AzureQueryPropertiesArgs
                    {
                        Locations = new[]
                        {
                            "Japan East",
                            "UK South",
                        },
                        Scope = new[]
                        {
                            "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources",
                            "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067",
                        },
                        TagSettings = new AzureNative.Automation.Inputs.TagSettingsPropertiesArgs
                        {
                            FilterOperator = AzureNative.Automation.TagOperators.All,
                            Tags =
                            {
                                { "tag1", new[]
                                {
                                    "tag1Value1",
                                    "tag1Value2",
                                    "tag1Value3",
                                } },
                                { "tag2", new[]
                                {
                                    "tag2Value1",
                                    "tag2Value2",
                                    "tag2Value3",
                                } },
                            },
                        },
                    },
                },
                NonAzureQueries = new[]
                {
                    new AzureNative.Automation.Inputs.NonAzureQueryPropertiesArgs
                    {
                        FunctionAlias = "SavedSearch1",
                        WorkspaceId = "WorkspaceId1",
                    },
                    new AzureNative.Automation.Inputs.NonAzureQueryPropertiesArgs
                    {
                        FunctionAlias = "SavedSearch2",
                        WorkspaceId = "WorkspaceId2",
                    },
                },
            },
            Windows = new AzureNative.Automation.Inputs.WindowsPropertiesArgs
            {
                ExcludedKbNumbers = new[]
                {
                    "168934",
                    "168973",
                },
                IncludedUpdateClassifications = AzureNative.Automation.WindowsUpdateClasses.Critical,
                RebootSetting = "IfRequired",
            },
        },
    });
});
Content copied to clipboard
package main
import (
	automation "github.com/pulumi/pulumi-azure-native-sdk/automation/v3"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := automation.NewSoftwareUpdateConfigurationByName(ctx, "softwareUpdateConfigurationByName", &automation.SoftwareUpdateConfigurationByNameArgs{
			AutomationAccountName: pulumi.String("myaccount"),
			ResourceGroupName:     pulumi.String("mygroup"),
			ScheduleInfo: &automation.SUCSchedulePropertiesArgs{
				AdvancedSchedule: &automation.AdvancedScheduleArgs{
					WeekDays: pulumi.StringArray{
						pulumi.String("Monday"),
						pulumi.String("Thursday"),
					},
				},
				ExpiryTime: pulumi.String("2018-11-09T11:22:57+00:00"),
				Frequency:  pulumi.String(automation.ScheduleFrequencyHour),
				Interval:   pulumi.Float64(1),
				StartTime:  pulumi.String("2017-10-19T12:22:57+00:00"),
				TimeZone:   pulumi.String("America/Los_Angeles"),
			},
			SoftwareUpdateConfigurationName: pulumi.String("testpatch"),
			Tasks: &automation.SoftwareUpdateConfigurationTasksArgs{
				PostTask: &automation.TaskPropertiesArgs{
					Source: pulumi.String("GetCache"),
				},
				PreTask: &automation.TaskPropertiesArgs{
					Parameters: pulumi.StringMap{
						"COMPUTERNAME": pulumi.String("Computer1"),
					},
					Source: pulumi.String("HelloWorld"),
				},
			},
			UpdateConfiguration: &automation.UpdateConfigurationArgs{
				AzureVirtualMachines: pulumi.StringArray{
					pulumi.String("/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01"),
					pulumi.String("/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02"),
					pulumi.String("/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03"),
				},
				Duration: pulumi.String("PT2H0M"),
				NonAzureComputerNames: pulumi.StringArray{
					pulumi.String("box1.contoso.com"),
					pulumi.String("box2.contoso.com"),
				},
				OperatingSystem: automation.OperatingSystemTypeWindows,
				Targets: &automation.TargetPropertiesArgs{
					AzureQueries: automation.AzureQueryPropertiesArray{
						&automation.AzureQueryPropertiesArgs{
							Locations: pulumi.StringArray{
								pulumi.String("Japan East"),
								pulumi.String("UK South"),
							},
							Scope: pulumi.StringArray{
								pulumi.String("/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources"),
								pulumi.String("/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067"),
							},
							TagSettings: &automation.TagSettingsPropertiesArgs{
								FilterOperator: automation.TagOperatorsAll,
								Tags: pulumi.StringArrayMap{
									"tag1": pulumi.StringArray{
										pulumi.String("tag1Value1"),
										pulumi.String("tag1Value2"),
										pulumi.String("tag1Value3"),
									},
									"tag2": pulumi.StringArray{
										pulumi.String("tag2Value1"),
										pulumi.String("tag2Value2"),
										pulumi.String("tag2Value3"),
									},
								},
							},
						},
					},
					NonAzureQueries: automation.NonAzureQueryPropertiesArray{
						&automation.NonAzureQueryPropertiesArgs{
							FunctionAlias: pulumi.String("SavedSearch1"),
							WorkspaceId:   pulumi.String("WorkspaceId1"),
						},
						&automation.NonAzureQueryPropertiesArgs{
							FunctionAlias: pulumi.String("SavedSearch2"),
							WorkspaceId:   pulumi.String("WorkspaceId2"),
						},
					},
				},
				Windows: &automation.WindowsPropertiesArgs{
					ExcludedKbNumbers: pulumi.StringArray{
						pulumi.String("168934"),
						pulumi.String("168973"),
					},
					IncludedUpdateClassifications: pulumi.String(automation.WindowsUpdateClassesCritical),
					RebootSetting:                 pulumi.String("IfRequired"),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.automation.SoftwareUpdateConfigurationByName;
import com.pulumi.azurenative.automation.SoftwareUpdateConfigurationByNameArgs;
import com.pulumi.azurenative.automation.inputs.SUCSchedulePropertiesArgs;
import com.pulumi.azurenative.automation.inputs.AdvancedScheduleArgs;
import com.pulumi.azurenative.automation.inputs.SoftwareUpdateConfigurationTasksArgs;
import com.pulumi.azurenative.automation.inputs.TaskPropertiesArgs;
import com.pulumi.azurenative.automation.inputs.UpdateConfigurationArgs;
import com.pulumi.azurenative.automation.inputs.TargetPropertiesArgs;
import com.pulumi.azurenative.automation.inputs.WindowsPropertiesArgs;
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 softwareUpdateConfigurationByName = new SoftwareUpdateConfigurationByName("softwareUpdateConfigurationByName", SoftwareUpdateConfigurationByNameArgs.builder()
            .automationAccountName("myaccount")
            .resourceGroupName("mygroup")
            .scheduleInfo(SUCSchedulePropertiesArgs.builder()
                .advancedSchedule(AdvancedScheduleArgs.builder()
                    .weekDays(
                        "Monday",
                        "Thursday")
                    .build())
                .expiryTime("2018-11-09T11:22:57+00:00")
                .frequency("Hour")
                .interval(1.0)
                .startTime("2017-10-19T12:22:57+00:00")
                .timeZone("America/Los_Angeles")
                .build())
            .softwareUpdateConfigurationName("testpatch")
            .tasks(SoftwareUpdateConfigurationTasksArgs.builder()
                .postTask(TaskPropertiesArgs.builder()
                    .source("GetCache")
                    .build())
                .preTask(TaskPropertiesArgs.builder()
                    .parameters(Map.of("COMPUTERNAME", "Computer1"))
                    .source("HelloWorld")
                    .build())
                .build())
            .updateConfiguration(UpdateConfigurationArgs.builder()
                .azureVirtualMachines(
                    "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01",
                    "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02",
                    "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03")
                .duration("PT2H0M")
                .nonAzureComputerNames(
                    "box1.contoso.com",
                    "box2.contoso.com")
                .operatingSystem("Windows")
                .targets(TargetPropertiesArgs.builder()
                    .azureQueries(AzureQueryPropertiesArgs.builder()
                        .locations(
                            "Japan East",
                            "UK South")
                        .scope(
                            "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources",
                            "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067")
                        .tagSettings(TagSettingsPropertiesArgs.builder()
                            .filterOperator("All")
                            .tags(Map.ofEntries(
                                Map.entry("tag1",
                                    "tag1Value1",
                                    "tag1Value2",
                                    "tag1Value3"),
                                Map.entry("tag2",
                                    "tag2Value1",
                                    "tag2Value2",
                                    "tag2Value3")
                            ))
                            .build())
                        .build())
                    .nonAzureQueries(
                        NonAzureQueryPropertiesArgs.builder()
                            .functionAlias("SavedSearch1")
                            .workspaceId("WorkspaceId1")
                            .build(),
                        NonAzureQueryPropertiesArgs.builder()
                            .functionAlias("SavedSearch2")
                            .workspaceId("WorkspaceId2")
                            .build())
                    .build())
                .windows(WindowsPropertiesArgs.builder()
                    .excludedKbNumbers(
                        "168934",
                        "168973")
                    .includedUpdateClassifications("Critical")
                    .rebootSetting("IfRequired")
                    .build())
                .build())
            .build());
    }
}
Content copied to clipboard

Import

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

$ pulumi import azure-native:automation:SoftwareUpdateConfigurationByName testpatch /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurations/{softwareUpdateConfigurationName}
Content copied to clipboard

Constructors

Link copied to clipboard
constructor(automationAccountName: Output<String>? = null, error: Output<ErrorResponseArgs>? = null, resourceGroupName: Output<String>? = null, scheduleInfo: Output<SUCSchedulePropertiesArgs>? = null, softwareUpdateConfigurationName: Output<String>? = null, tasks: Output<SoftwareUpdateConfigurationTasksArgs>? = null, updateConfiguration: Output<UpdateConfigurationArgs>? = null)

Properties

Link copied to clipboard
val automationAccountName: Output<String>? = null

The name of the automation account.

Link copied to clipboard
val error: Output<ErrorResponseArgs>? = null

Details of provisioning error

Link copied to clipboard
val resourceGroupName: Output<String>? = null

Name of an Azure Resource group.

Link copied to clipboard
val scheduleInfo: Output<SUCSchedulePropertiesArgs>? = null

Schedule information for the Software update configuration

Link copied to clipboard
val softwareUpdateConfigurationName: Output<String>? = null

The name of the software update configuration to be created.

Link copied to clipboard
val tasks: Output<SoftwareUpdateConfigurationTasksArgs>? = null

Tasks information for the Software update configuration.

Link copied to clipboard
val updateConfiguration: Output<UpdateConfigurationArgs>? = null

update specific properties for the Software update configuration

Functions

Link copied to clipboard
open override fun toJava(): SoftwareUpdateConfigurationByNameArgs