Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Azure Classic
  3. API Docs
  4. automation
  5. SoftwareUpdateConfiguration

We recommend using Azure Native.

Azure v6.22.0 published on Tuesday, Apr 1, 2025 by Pulumi
pulumi/pulumi-azure

azure.automation.SoftwareUpdateConfiguration

Explore with Pulumi AI

We recommend using Azure Native.

Azure v6.22.0 published on Tuesday, Apr 1, 2025 by Pulumi
pulumi/pulumi-azure

Manages an Automation Software Update Configuration.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";

const example = new azure.core.ResourceGroup("example", {
    name: "example-rg",
    location: "East US",
});
const exampleAccount = new azure.automation.Account("example", {
    name: "example",
    location: example.location,
    resourceGroupName: example.name,
    skuName: "Basic",
});
const exampleRunBook = new azure.automation.RunBook("example", {
    name: "Get-AzureVMTutorial",
    location: example.location,
    resourceGroupName: example.name,
    automationAccountName: exampleAccount.name,
    logVerbose: true,
    logProgress: true,
    description: "This is a example runbook for terraform acceptance example",
    runbookType: "Python3",
    content: `# Some example content
# for Terraform acceptance example
`,
    tags: {
        ENV: "runbook_test",
    },
});
const exampleSoftwareUpdateConfiguration = new azure.automation.SoftwareUpdateConfiguration("example", {
    name: "example",
    automationAccountId: exampleAccount.id,
    linux: {
        classificationsIncludeds: "Security",
        excludedPackages: ["apt"],
        includedPackages: ["vim"],
        reboot: "IfRequired",
    },
    preTask: {
        source: exampleRunBook.name,
        parameters: {
            COMPUTER_NAME: "Foo",
        },
    },
    duration: "PT2H2M2S",
});
Copy
import pulumi
import pulumi_azure as azure

example = azure.core.ResourceGroup("example",
    name="example-rg",
    location="East US")
example_account = azure.automation.Account("example",
    name="example",
    location=example.location,
    resource_group_name=example.name,
    sku_name="Basic")
example_run_book = azure.automation.RunBook("example",
    name="Get-AzureVMTutorial",
    location=example.location,
    resource_group_name=example.name,
    automation_account_name=example_account.name,
    log_verbose=True,
    log_progress=True,
    description="This is a example runbook for terraform acceptance example",
    runbook_type="Python3",
    content="""# Some example content
# for Terraform acceptance example
""",
    tags={
        "ENV": "runbook_test",
    })
example_software_update_configuration = azure.automation.SoftwareUpdateConfiguration("example",
    name="example",
    automation_account_id=example_account.id,
    linux={
        "classifications_includeds": "Security",
        "excluded_packages": ["apt"],
        "included_packages": ["vim"],
        "reboot": "IfRequired",
    },
    pre_task={
        "source": example_run_book.name,
        "parameters": {
            "COMPUTER_NAME": "Foo",
        },
    },
    duration="PT2H2M2S")
Copy
package main

import (
	"github.com/pulumi/pulumi-azure/sdk/v6/go/azure/automation"
	"github.com/pulumi/pulumi-azure/sdk/v6/go/azure/core"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := core.NewResourceGroup(ctx, "example", &core.ResourceGroupArgs{
			Name:     pulumi.String("example-rg"),
			Location: pulumi.String("East US"),
		})
		if err != nil {
			return err
		}
		exampleAccount, err := automation.NewAccount(ctx, "example", &automation.AccountArgs{
			Name:              pulumi.String("example"),
			Location:          example.Location,
			ResourceGroupName: example.Name,
			SkuName:           pulumi.String("Basic"),
		})
		if err != nil {
			return err
		}
		exampleRunBook, err := automation.NewRunBook(ctx, "example", &automation.RunBookArgs{
			Name:                  pulumi.String("Get-AzureVMTutorial"),
			Location:              example.Location,
			ResourceGroupName:     example.Name,
			AutomationAccountName: exampleAccount.Name,
			LogVerbose:            pulumi.Bool(true),
			LogProgress:           pulumi.Bool(true),
			Description:           pulumi.String("This is a example runbook for terraform acceptance example"),
			RunbookType:           pulumi.String("Python3"),
			Content:               pulumi.String("# Some example content\n# for Terraform acceptance example\n"),
			Tags: pulumi.StringMap{
				"ENV": pulumi.String("runbook_test"),
			},
		})
		if err != nil {
			return err
		}
		_, err = automation.NewSoftwareUpdateConfiguration(ctx, "example", &automation.SoftwareUpdateConfigurationArgs{
			Name:                pulumi.String("example"),
			AutomationAccountId: exampleAccount.ID(),
			Linux: &automation.SoftwareUpdateConfigurationLinuxArgs{
				ClassificationsIncludeds: pulumi.StringArray("Security"),
				ExcludedPackages: pulumi.StringArray{
					pulumi.String("apt"),
				},
				IncludedPackages: pulumi.StringArray{
					pulumi.String("vim"),
				},
				Reboot: pulumi.String("IfRequired"),
			},
			PreTask: &automation.SoftwareUpdateConfigurationPreTaskArgs{
				Source: exampleRunBook.Name,
				Parameters: pulumi.StringMap{
					"COMPUTER_NAME": pulumi.String("Foo"),
				},
			},
			Duration: pulumi.String("PT2H2M2S"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Azure = Pulumi.Azure;

return await Deployment.RunAsync(() => 
{
    var example = new Azure.Core.ResourceGroup("example", new()
    {
        Name = "example-rg",
        Location = "East US",
    });

    var exampleAccount = new Azure.Automation.Account("example", new()
    {
        Name = "example",
        Location = example.Location,
        ResourceGroupName = example.Name,
        SkuName = "Basic",
    });

    var exampleRunBook = new Azure.Automation.RunBook("example", new()
    {
        Name = "Get-AzureVMTutorial",
        Location = example.Location,
        ResourceGroupName = example.Name,
        AutomationAccountName = exampleAccount.Name,
        LogVerbose = true,
        LogProgress = true,
        Description = "This is a example runbook for terraform acceptance example",
        RunbookType = "Python3",
        Content = @"# Some example content
# for Terraform acceptance example
",
        Tags = 
        {
            { "ENV", "runbook_test" },
        },
    });

    var exampleSoftwareUpdateConfiguration = new Azure.Automation.SoftwareUpdateConfiguration("example", new()
    {
        Name = "example",
        AutomationAccountId = exampleAccount.Id,
        Linux = new Azure.Automation.Inputs.SoftwareUpdateConfigurationLinuxArgs
        {
            ClassificationsIncludeds = "Security",
            ExcludedPackages = new[]
            {
                "apt",
            },
            IncludedPackages = new[]
            {
                "vim",
            },
            Reboot = "IfRequired",
        },
        PreTask = new Azure.Automation.Inputs.SoftwareUpdateConfigurationPreTaskArgs
        {
            Source = exampleRunBook.Name,
            Parameters = 
            {
                { "COMPUTER_NAME", "Foo" },
            },
        },
        Duration = "PT2H2M2S",
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azure.core.ResourceGroup;
import com.pulumi.azure.core.ResourceGroupArgs;
import com.pulumi.azure.automation.Account;
import com.pulumi.azure.automation.AccountArgs;
import com.pulumi.azure.automation.RunBook;
import com.pulumi.azure.automation.RunBookArgs;
import com.pulumi.azure.automation.SoftwareUpdateConfiguration;
import com.pulumi.azure.automation.SoftwareUpdateConfigurationArgs;
import com.pulumi.azure.automation.inputs.SoftwareUpdateConfigurationLinuxArgs;
import com.pulumi.azure.automation.inputs.SoftwareUpdateConfigurationPreTaskArgs;
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 example = new ResourceGroup("example", ResourceGroupArgs.builder()
            .name("example-rg")
            .location("East US")
            .build());

        var exampleAccount = new Account("exampleAccount", AccountArgs.builder()
            .name("example")
            .location(example.location())
            .resourceGroupName(example.name())
            .skuName("Basic")
            .build());

        var exampleRunBook = new RunBook("exampleRunBook", RunBookArgs.builder()
            .name("Get-AzureVMTutorial")
            .location(example.location())
            .resourceGroupName(example.name())
            .automationAccountName(exampleAccount.name())
            .logVerbose("true")
            .logProgress("true")
            .description("This is a example runbook for terraform acceptance example")
            .runbookType("Python3")
            .content("""
# Some example content
# for Terraform acceptance example
            """)
            .tags(Map.of("ENV", "runbook_test"))
            .build());

        var exampleSoftwareUpdateConfiguration = new SoftwareUpdateConfiguration("exampleSoftwareUpdateConfiguration", SoftwareUpdateConfigurationArgs.builder()
            .name("example")
            .automationAccountId(exampleAccount.id())
            .linux(SoftwareUpdateConfigurationLinuxArgs.builder()
                .classificationsIncludeds("Security")
                .excludedPackages("apt")
                .includedPackages("vim")
                .reboot("IfRequired")
                .build())
            .preTask(SoftwareUpdateConfigurationPreTaskArgs.builder()
                .source(exampleRunBook.name())
                .parameters(Map.of("COMPUTER_NAME", "Foo"))
                .build())
            .duration("PT2H2M2S")
            .build());

    }
}
Copy
resources:
  example:
    type: azure:core:ResourceGroup
    properties:
      name: example-rg
      location: East US
  exampleAccount:
    type: azure:automation:Account
    name: example
    properties:
      name: example
      location: ${example.location}
      resourceGroupName: ${example.name}
      skuName: Basic
  exampleRunBook:
    type: azure:automation:RunBook
    name: example
    properties:
      name: Get-AzureVMTutorial
      location: ${example.location}
      resourceGroupName: ${example.name}
      automationAccountName: ${exampleAccount.name}
      logVerbose: 'true'
      logProgress: 'true'
      description: This is a example runbook for terraform acceptance example
      runbookType: Python3
      content: |
        # Some example content
        # for Terraform acceptance example        
      tags:
        ENV: runbook_test
  exampleSoftwareUpdateConfiguration:
    type: azure:automation:SoftwareUpdateConfiguration
    name: example
    properties:
      name: example
      automationAccountId: ${exampleAccount.id}
      linux:
        classificationsIncludeds: Security
        excludedPackages:
          - apt
        includedPackages:
          - vim
        reboot: IfRequired
      preTask:
        source: ${exampleRunBook.name}
        parameters:
          COMPUTER_NAME: Foo
      duration: PT2H2M2S
Copy

Create SoftwareUpdateConfiguration Resource

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

Constructor syntax

new SoftwareUpdateConfiguration(name: string, args: SoftwareUpdateConfigurationArgs, opts?: CustomResourceOptions);
@overload
def SoftwareUpdateConfiguration(resource_name: str,
                                args: SoftwareUpdateConfigurationArgs,
                                opts: Optional[ResourceOptions] = None)

@overload
def SoftwareUpdateConfiguration(resource_name: str,
                                opts: Optional[ResourceOptions] = None,
                                automation_account_id: Optional[str] = None,
                                schedule: Optional[SoftwareUpdateConfigurationScheduleArgs] = None,
                                duration: Optional[str] = None,
                                linux: Optional[SoftwareUpdateConfigurationLinuxArgs] = None,
                                name: Optional[str] = None,
                                non_azure_computer_names: Optional[Sequence[str]] = None,
                                post_task: Optional[SoftwareUpdateConfigurationPostTaskArgs] = None,
                                pre_task: Optional[SoftwareUpdateConfigurationPreTaskArgs] = None,
                                target: Optional[SoftwareUpdateConfigurationTargetArgs] = None,
                                virtual_machine_ids: Optional[Sequence[str]] = None,
                                windows: Optional[SoftwareUpdateConfigurationWindowsArgs] = None)
func NewSoftwareUpdateConfiguration(ctx *Context, name string, args SoftwareUpdateConfigurationArgs, opts ...ResourceOption) (*SoftwareUpdateConfiguration, error)
public SoftwareUpdateConfiguration(string name, SoftwareUpdateConfigurationArgs args, CustomResourceOptions? opts = null)
public SoftwareUpdateConfiguration(String name, SoftwareUpdateConfigurationArgs args)
public SoftwareUpdateConfiguration(String name, SoftwareUpdateConfigurationArgs args, CustomResourceOptions options)

type: azure:automation:SoftwareUpdateConfiguration
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name This property is required. string
The unique name of the resource.
args This property is required. SoftwareUpdateConfigurationArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args This property is required. SoftwareUpdateConfigurationArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args This property is required. SoftwareUpdateConfigurationArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args This property is required. SoftwareUpdateConfigurationArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. SoftwareUpdateConfigurationArgs
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 softwareUpdateConfigurationResource = new Azure.Automation.SoftwareUpdateConfiguration("softwareUpdateConfigurationResource", new()
{
    AutomationAccountId = "string",
    Schedule = new Azure.Automation.Inputs.SoftwareUpdateConfigurationScheduleArgs
    {
        Frequency = "string",
        IsEnabled = false,
        LastModifiedTime = "string",
        Description = "string",
        ExpiryTime = "string",
        ExpiryTimeOffsetMinutes = 0,
        AdvancedWeekDays = new[]
        {
            "string",
        },
        CreationTime = "string",
        AdvancedMonthDays = new[]
        {
            0,
        },
        Interval = 0,
        MonthlyOccurrence = new Azure.Automation.Inputs.SoftwareUpdateConfigurationScheduleMonthlyOccurrenceArgs
        {
            Day = "string",
            Occurrence = 0,
        },
        NextRun = "string",
        NextRunOffsetMinutes = 0,
        StartTime = "string",
        StartTimeOffsetMinutes = 0,
        TimeZone = "string",
    },
    Duration = "string",
    Linux = new Azure.Automation.Inputs.SoftwareUpdateConfigurationLinuxArgs
    {
        ClassificationsIncludeds = new[]
        {
            "string",
        },
        ExcludedPackages = new[]
        {
            "string",
        },
        IncludedPackages = new[]
        {
            "string",
        },
        Reboot = "string",
    },
    Name = "string",
    NonAzureComputerNames = new[]
    {
        "string",
    },
    PostTask = new Azure.Automation.Inputs.SoftwareUpdateConfigurationPostTaskArgs
    {
        Parameters = 
        {
            { "string", "string" },
        },
        Source = "string",
    },
    PreTask = new Azure.Automation.Inputs.SoftwareUpdateConfigurationPreTaskArgs
    {
        Parameters = 
        {
            { "string", "string" },
        },
        Source = "string",
    },
    Target = new Azure.Automation.Inputs.SoftwareUpdateConfigurationTargetArgs
    {
        AzureQueries = new[]
        {
            new Azure.Automation.Inputs.SoftwareUpdateConfigurationTargetAzureQueryArgs
            {
                Locations = new[]
                {
                    "string",
                },
                Scopes = new[]
                {
                    "string",
                },
                TagFilter = "string",
                Tags = new[]
                {
                    new Azure.Automation.Inputs.SoftwareUpdateConfigurationTargetAzureQueryTagArgs
                    {
                        Tag = "string",
                        Values = new[]
                        {
                            "string",
                        },
                    },
                },
            },
        },
        NonAzureQueries = new[]
        {
            new Azure.Automation.Inputs.SoftwareUpdateConfigurationTargetNonAzureQueryArgs
            {
                FunctionAlias = "string",
                WorkspaceId = "string",
            },
        },
    },
    VirtualMachineIds = new[]
    {
        "string",
    },
    Windows = new Azure.Automation.Inputs.SoftwareUpdateConfigurationWindowsArgs
    {
        ClassificationsIncludeds = new[]
        {
            "string",
        },
        ExcludedKnowledgeBaseNumbers = new[]
        {
            "string",
        },
        IncludedKnowledgeBaseNumbers = new[]
        {
            "string",
        },
        Reboot = "string",
    },
});
Copy
example, err := automation.NewSoftwareUpdateConfiguration(ctx, "softwareUpdateConfigurationResource", &automation.SoftwareUpdateConfigurationArgs{
	AutomationAccountId: pulumi.String("string"),
	Schedule: &automation.SoftwareUpdateConfigurationScheduleArgs{
		Frequency:               pulumi.String("string"),
		IsEnabled:               pulumi.Bool(false),
		LastModifiedTime:        pulumi.String("string"),
		Description:             pulumi.String("string"),
		ExpiryTime:              pulumi.String("string"),
		ExpiryTimeOffsetMinutes: pulumi.Float64(0),
		AdvancedWeekDays: pulumi.StringArray{
			pulumi.String("string"),
		},
		CreationTime: pulumi.String("string"),
		AdvancedMonthDays: pulumi.IntArray{
			pulumi.Int(0),
		},
		Interval: pulumi.Int(0),
		MonthlyOccurrence: &automation.SoftwareUpdateConfigurationScheduleMonthlyOccurrenceArgs{
			Day:        pulumi.String("string"),
			Occurrence: pulumi.Int(0),
		},
		NextRun:                pulumi.String("string"),
		NextRunOffsetMinutes:   pulumi.Float64(0),
		StartTime:              pulumi.String("string"),
		StartTimeOffsetMinutes: pulumi.Float64(0),
		TimeZone:               pulumi.String("string"),
	},
	Duration: pulumi.String("string"),
	Linux: &automation.SoftwareUpdateConfigurationLinuxArgs{
		ClassificationsIncludeds: pulumi.StringArray{
			pulumi.String("string"),
		},
		ExcludedPackages: pulumi.StringArray{
			pulumi.String("string"),
		},
		IncludedPackages: pulumi.StringArray{
			pulumi.String("string"),
		},
		Reboot: pulumi.String("string"),
	},
	Name: pulumi.String("string"),
	NonAzureComputerNames: pulumi.StringArray{
		pulumi.String("string"),
	},
	PostTask: &automation.SoftwareUpdateConfigurationPostTaskArgs{
		Parameters: pulumi.StringMap{
			"string": pulumi.String("string"),
		},
		Source: pulumi.String("string"),
	},
	PreTask: &automation.SoftwareUpdateConfigurationPreTaskArgs{
		Parameters: pulumi.StringMap{
			"string": pulumi.String("string"),
		},
		Source: pulumi.String("string"),
	},
	Target: &automation.SoftwareUpdateConfigurationTargetArgs{
		AzureQueries: automation.SoftwareUpdateConfigurationTargetAzureQueryArray{
			&automation.SoftwareUpdateConfigurationTargetAzureQueryArgs{
				Locations: pulumi.StringArray{
					pulumi.String("string"),
				},
				Scopes: pulumi.StringArray{
					pulumi.String("string"),
				},
				TagFilter: pulumi.String("string"),
				Tags: automation.SoftwareUpdateConfigurationTargetAzureQueryTagArray{
					&automation.SoftwareUpdateConfigurationTargetAzureQueryTagArgs{
						Tag: pulumi.String("string"),
						Values: pulumi.StringArray{
							pulumi.String("string"),
						},
					},
				},
			},
		},
		NonAzureQueries: automation.SoftwareUpdateConfigurationTargetNonAzureQueryArray{
			&automation.SoftwareUpdateConfigurationTargetNonAzureQueryArgs{
				FunctionAlias: pulumi.String("string"),
				WorkspaceId:   pulumi.String("string"),
			},
		},
	},
	VirtualMachineIds: pulumi.StringArray{
		pulumi.String("string"),
	},
	Windows: &automation.SoftwareUpdateConfigurationWindowsArgs{
		ClassificationsIncludeds: pulumi.StringArray{
			pulumi.String("string"),
		},
		ExcludedKnowledgeBaseNumbers: pulumi.StringArray{
			pulumi.String("string"),
		},
		IncludedKnowledgeBaseNumbers: pulumi.StringArray{
			pulumi.String("string"),
		},
		Reboot: pulumi.String("string"),
	},
})
Copy
var softwareUpdateConfigurationResource = new SoftwareUpdateConfiguration("softwareUpdateConfigurationResource", SoftwareUpdateConfigurationArgs.builder()
    .automationAccountId("string")
    .schedule(SoftwareUpdateConfigurationScheduleArgs.builder()
        .frequency("string")
        .isEnabled(false)
        .lastModifiedTime("string")
        .description("string")
        .expiryTime("string")
        .expiryTimeOffsetMinutes(0)
        .advancedWeekDays("string")
        .creationTime("string")
        .advancedMonthDays(0)
        .interval(0)
        .monthlyOccurrence(SoftwareUpdateConfigurationScheduleMonthlyOccurrenceArgs.builder()
            .day("string")
            .occurrence(0)
            .build())
        .nextRun("string")
        .nextRunOffsetMinutes(0)
        .startTime("string")
        .startTimeOffsetMinutes(0)
        .timeZone("string")
        .build())
    .duration("string")
    .linux(SoftwareUpdateConfigurationLinuxArgs.builder()
        .classificationsIncludeds("string")
        .excludedPackages("string")
        .includedPackages("string")
        .reboot("string")
        .build())
    .name("string")
    .nonAzureComputerNames("string")
    .postTask(SoftwareUpdateConfigurationPostTaskArgs.builder()
        .parameters(Map.of("string", "string"))
        .source("string")
        .build())
    .preTask(SoftwareUpdateConfigurationPreTaskArgs.builder()
        .parameters(Map.of("string", "string"))
        .source("string")
        .build())
    .target(SoftwareUpdateConfigurationTargetArgs.builder()
        .azureQueries(SoftwareUpdateConfigurationTargetAzureQueryArgs.builder()
            .locations("string")
            .scopes("string")
            .tagFilter("string")
            .tags(SoftwareUpdateConfigurationTargetAzureQueryTagArgs.builder()
                .tag("string")
                .values("string")
                .build())
            .build())
        .nonAzureQueries(SoftwareUpdateConfigurationTargetNonAzureQueryArgs.builder()
            .functionAlias("string")
            .workspaceId("string")
            .build())
        .build())
    .virtualMachineIds("string")
    .windows(SoftwareUpdateConfigurationWindowsArgs.builder()
        .classificationsIncludeds("string")
        .excludedKnowledgeBaseNumbers("string")
        .includedKnowledgeBaseNumbers("string")
        .reboot("string")
        .build())
    .build());
Copy
software_update_configuration_resource = azure.automation.SoftwareUpdateConfiguration("softwareUpdateConfigurationResource",
    automation_account_id="string",
    schedule={
        "frequency": "string",
        "is_enabled": False,
        "last_modified_time": "string",
        "description": "string",
        "expiry_time": "string",
        "expiry_time_offset_minutes": 0,
        "advanced_week_days": ["string"],
        "creation_time": "string",
        "advanced_month_days": [0],
        "interval": 0,
        "monthly_occurrence": {
            "day": "string",
            "occurrence": 0,
        },
        "next_run": "string",
        "next_run_offset_minutes": 0,
        "start_time": "string",
        "start_time_offset_minutes": 0,
        "time_zone": "string",
    },
    duration="string",
    linux={
        "classifications_includeds": ["string"],
        "excluded_packages": ["string"],
        "included_packages": ["string"],
        "reboot": "string",
    },
    name="string",
    non_azure_computer_names=["string"],
    post_task={
        "parameters": {
            "string": "string",
        },
        "source": "string",
    },
    pre_task={
        "parameters": {
            "string": "string",
        },
        "source": "string",
    },
    target={
        "azure_queries": [{
            "locations": ["string"],
            "scopes": ["string"],
            "tag_filter": "string",
            "tags": [{
                "tag": "string",
                "values": ["string"],
            }],
        }],
        "non_azure_queries": [{
            "function_alias": "string",
            "workspace_id": "string",
        }],
    },
    virtual_machine_ids=["string"],
    windows={
        "classifications_includeds": ["string"],
        "excluded_knowledge_base_numbers": ["string"],
        "included_knowledge_base_numbers": ["string"],
        "reboot": "string",
    })
Copy
const softwareUpdateConfigurationResource = new azure.automation.SoftwareUpdateConfiguration("softwareUpdateConfigurationResource", {
    automationAccountId: "string",
    schedule: {
        frequency: "string",
        isEnabled: false,
        lastModifiedTime: "string",
        description: "string",
        expiryTime: "string",
        expiryTimeOffsetMinutes: 0,
        advancedWeekDays: ["string"],
        creationTime: "string",
        advancedMonthDays: [0],
        interval: 0,
        monthlyOccurrence: {
            day: "string",
            occurrence: 0,
        },
        nextRun: "string",
        nextRunOffsetMinutes: 0,
        startTime: "string",
        startTimeOffsetMinutes: 0,
        timeZone: "string",
    },
    duration: "string",
    linux: {
        classificationsIncludeds: ["string"],
        excludedPackages: ["string"],
        includedPackages: ["string"],
        reboot: "string",
    },
    name: "string",
    nonAzureComputerNames: ["string"],
    postTask: {
        parameters: {
            string: "string",
        },
        source: "string",
    },
    preTask: {
        parameters: {
            string: "string",
        },
        source: "string",
    },
    target: {
        azureQueries: [{
            locations: ["string"],
            scopes: ["string"],
            tagFilter: "string",
            tags: [{
                tag: "string",
                values: ["string"],
            }],
        }],
        nonAzureQueries: [{
            functionAlias: "string",
            workspaceId: "string",
        }],
    },
    virtualMachineIds: ["string"],
    windows: {
        classificationsIncludeds: ["string"],
        excludedKnowledgeBaseNumbers: ["string"],
        includedKnowledgeBaseNumbers: ["string"],
        reboot: "string",
    },
});
Copy
type: azure:automation:SoftwareUpdateConfiguration
properties:
    automationAccountId: string
    duration: string
    linux:
        classificationsIncludeds:
            - string
        excludedPackages:
            - string
        includedPackages:
            - string
        reboot: string
    name: string
    nonAzureComputerNames:
        - string
    postTask:
        parameters:
            string: string
        source: string
    preTask:
        parameters:
            string: string
        source: string
    schedule:
        advancedMonthDays:
            - 0
        advancedWeekDays:
            - string
        creationTime: string
        description: string
        expiryTime: string
        expiryTimeOffsetMinutes: 0
        frequency: string
        interval: 0
        isEnabled: false
        lastModifiedTime: string
        monthlyOccurrence:
            day: string
            occurrence: 0
        nextRun: string
        nextRunOffsetMinutes: 0
        startTime: string
        startTimeOffsetMinutes: 0
        timeZone: string
    target:
        azureQueries:
            - locations:
                - string
              scopes:
                - string
              tagFilter: string
              tags:
                - tag: string
                  values:
                    - string
        nonAzureQueries:
            - functionAlias: string
              workspaceId: string
    virtualMachineIds:
        - string
    windows:
        classificationsIncludeds:
            - string
        excludedKnowledgeBaseNumbers:
            - string
        includedKnowledgeBaseNumbers:
            - string
        reboot: string
Copy

SoftwareUpdateConfiguration 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 SoftwareUpdateConfiguration resource accepts the following input properties:

AutomationAccountId
This property is required.
Changes to this property will trigger replacement.
string
The ID of Automation Account to manage this Source Control. Changing this forces a new Automation Source Control to be created.
Schedule This property is required. SoftwareUpdateConfigurationSchedule
A schedule blocks as defined below.
Duration string
Maximum time allowed for the software update configuration run. using format PT[n]H[n]M[n]S as per ISO8601. Defaults to PT2H.
Linux SoftwareUpdateConfigurationLinux
A linux block as defined below.
Name Changes to this property will trigger replacement. string
The name which should be used for this Automation. Changing this forces a new Automation to be created.
NonAzureComputerNames List<string>
Specifies a list of names of non-Azure machines for the software update configuration.
PostTask SoftwareUpdateConfigurationPostTask
A post_task blocks as defined below.
PreTask SoftwareUpdateConfigurationPreTask
A pre_task blocks as defined below.
Target SoftwareUpdateConfigurationTarget
A target blocks as defined below.
VirtualMachineIds List<string>
Specifies a list of Azure Resource IDs of azure virtual machines.
Windows SoftwareUpdateConfigurationWindows

A windows block as defined below.

NOTE: One of linux or windows must be specified.

AutomationAccountId
This property is required.
Changes to this property will trigger replacement.
string
The ID of Automation Account to manage this Source Control. Changing this forces a new Automation Source Control to be created.
Schedule This property is required. SoftwareUpdateConfigurationScheduleArgs
A schedule blocks as defined below.
Duration string
Maximum time allowed for the software update configuration run. using format PT[n]H[n]M[n]S as per ISO8601. Defaults to PT2H.
Linux SoftwareUpdateConfigurationLinuxArgs
A linux block as defined below.
Name Changes to this property will trigger replacement. string
The name which should be used for this Automation. Changing this forces a new Automation to be created.
NonAzureComputerNames []string
Specifies a list of names of non-Azure machines for the software update configuration.
PostTask SoftwareUpdateConfigurationPostTaskArgs
A post_task blocks as defined below.
PreTask SoftwareUpdateConfigurationPreTaskArgs
A pre_task blocks as defined below.
Target SoftwareUpdateConfigurationTargetArgs
A target blocks as defined below.
VirtualMachineIds []string
Specifies a list of Azure Resource IDs of azure virtual machines.
Windows SoftwareUpdateConfigurationWindowsArgs

A windows block as defined below.

NOTE: One of linux or windows must be specified.

automationAccountId
This property is required.
Changes to this property will trigger replacement.
String
The ID of Automation Account to manage this Source Control. Changing this forces a new Automation Source Control to be created.
schedule This property is required. SoftwareUpdateConfigurationSchedule
A schedule blocks as defined below.
duration String
Maximum time allowed for the software update configuration run. using format PT[n]H[n]M[n]S as per ISO8601. Defaults to PT2H.
linux SoftwareUpdateConfigurationLinux
A linux block as defined below.
name Changes to this property will trigger replacement. String
The name which should be used for this Automation. Changing this forces a new Automation to be created.
nonAzureComputerNames List<String>
Specifies a list of names of non-Azure machines for the software update configuration.
postTask SoftwareUpdateConfigurationPostTask
A post_task blocks as defined below.
preTask SoftwareUpdateConfigurationPreTask
A pre_task blocks as defined below.
target SoftwareUpdateConfigurationTarget
A target blocks as defined below.
virtualMachineIds List<String>
Specifies a list of Azure Resource IDs of azure virtual machines.
windows SoftwareUpdateConfigurationWindows

A windows block as defined below.

NOTE: One of linux or windows must be specified.

automationAccountId
This property is required.
Changes to this property will trigger replacement.
string
The ID of Automation Account to manage this Source Control. Changing this forces a new Automation Source Control to be created.
schedule This property is required. SoftwareUpdateConfigurationSchedule
A schedule blocks as defined below.
duration string
Maximum time allowed for the software update configuration run. using format PT[n]H[n]M[n]S as per ISO8601. Defaults to PT2H.
linux SoftwareUpdateConfigurationLinux
A linux block as defined below.
name Changes to this property will trigger replacement. string
The name which should be used for this Automation. Changing this forces a new Automation to be created.
nonAzureComputerNames string[]
Specifies a list of names of non-Azure machines for the software update configuration.
postTask SoftwareUpdateConfigurationPostTask
A post_task blocks as defined below.
preTask SoftwareUpdateConfigurationPreTask
A pre_task blocks as defined below.
target SoftwareUpdateConfigurationTarget
A target blocks as defined below.
virtualMachineIds string[]
Specifies a list of Azure Resource IDs of azure virtual machines.
windows SoftwareUpdateConfigurationWindows

A windows block as defined below.

NOTE: One of linux or windows must be specified.

automation_account_id
This property is required.
Changes to this property will trigger replacement.
str
The ID of Automation Account to manage this Source Control. Changing this forces a new Automation Source Control to be created.
schedule This property is required. SoftwareUpdateConfigurationScheduleArgs
A schedule blocks as defined below.
duration str
Maximum time allowed for the software update configuration run. using format PT[n]H[n]M[n]S as per ISO8601. Defaults to PT2H.
linux SoftwareUpdateConfigurationLinuxArgs
A linux block as defined below.
name Changes to this property will trigger replacement. str
The name which should be used for this Automation. Changing this forces a new Automation to be created.
non_azure_computer_names Sequence[str]
Specifies a list of names of non-Azure machines for the software update configuration.
post_task SoftwareUpdateConfigurationPostTaskArgs
A post_task blocks as defined below.
pre_task SoftwareUpdateConfigurationPreTaskArgs
A pre_task blocks as defined below.
target SoftwareUpdateConfigurationTargetArgs
A target blocks as defined below.
virtual_machine_ids Sequence[str]
Specifies a list of Azure Resource IDs of azure virtual machines.
windows SoftwareUpdateConfigurationWindowsArgs

A windows block as defined below.

NOTE: One of linux or windows must be specified.

automationAccountId
This property is required.
Changes to this property will trigger replacement.
String
The ID of Automation Account to manage this Source Control. Changing this forces a new Automation Source Control to be created.
schedule This property is required. Property Map
A schedule blocks as defined below.
duration String
Maximum time allowed for the software update configuration run. using format PT[n]H[n]M[n]S as per ISO8601. Defaults to PT2H.
linux Property Map
A linux block as defined below.
name Changes to this property will trigger replacement. String
The name which should be used for this Automation. Changing this forces a new Automation to be created.
nonAzureComputerNames List<String>
Specifies a list of names of non-Azure machines for the software update configuration.
postTask Property Map
A post_task blocks as defined below.
preTask Property Map
A pre_task blocks as defined below.
target Property Map
A target blocks as defined below.
virtualMachineIds List<String>
Specifies a list of Azure Resource IDs of azure virtual machines.
windows Property Map

A windows block as defined below.

NOTE: One of linux or windows must be specified.

Outputs

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

ErrorCode string
The Error code when failed.
ErrorMessage string
The Error message indicating why the operation failed.
Id string
The provider-assigned unique ID for this managed resource.
ErrorCode string
The Error code when failed.
ErrorMessage string
The Error message indicating why the operation failed.
Id string
The provider-assigned unique ID for this managed resource.
errorCode String
The Error code when failed.
errorMessage String
The Error message indicating why the operation failed.
id String
The provider-assigned unique ID for this managed resource.
errorCode string
The Error code when failed.
errorMessage string
The Error message indicating why the operation failed.
id string
The provider-assigned unique ID for this managed resource.
error_code str
The Error code when failed.
error_message str
The Error message indicating why the operation failed.
id str
The provider-assigned unique ID for this managed resource.
errorCode String
The Error code when failed.
errorMessage String
The Error message indicating why the operation failed.
id String
The provider-assigned unique ID for this managed resource.

Look up Existing SoftwareUpdateConfiguration Resource

Get an existing SoftwareUpdateConfiguration 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?: SoftwareUpdateConfigurationState, opts?: CustomResourceOptions): SoftwareUpdateConfiguration
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        automation_account_id: Optional[str] = None,
        duration: Optional[str] = None,
        error_code: Optional[str] = None,
        error_message: Optional[str] = None,
        linux: Optional[SoftwareUpdateConfigurationLinuxArgs] = None,
        name: Optional[str] = None,
        non_azure_computer_names: Optional[Sequence[str]] = None,
        post_task: Optional[SoftwareUpdateConfigurationPostTaskArgs] = None,
        pre_task: Optional[SoftwareUpdateConfigurationPreTaskArgs] = None,
        schedule: Optional[SoftwareUpdateConfigurationScheduleArgs] = None,
        target: Optional[SoftwareUpdateConfigurationTargetArgs] = None,
        virtual_machine_ids: Optional[Sequence[str]] = None,
        windows: Optional[SoftwareUpdateConfigurationWindowsArgs] = None) -> SoftwareUpdateConfiguration
func GetSoftwareUpdateConfiguration(ctx *Context, name string, id IDInput, state *SoftwareUpdateConfigurationState, opts ...ResourceOption) (*SoftwareUpdateConfiguration, error)
public static SoftwareUpdateConfiguration Get(string name, Input<string> id, SoftwareUpdateConfigurationState? state, CustomResourceOptions? opts = null)
public static SoftwareUpdateConfiguration get(String name, Output<String> id, SoftwareUpdateConfigurationState state, CustomResourceOptions options)
resources:  _:    type: azure:automation:SoftwareUpdateConfiguration    get:      id: ${id}
name This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
name This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
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 This property is required.
The unique name of the resulting resource.
id This property is required.
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:
AutomationAccountId Changes to this property will trigger replacement. string
The ID of Automation Account to manage this Source Control. Changing this forces a new Automation Source Control to be created.
Duration string
Maximum time allowed for the software update configuration run. using format PT[n]H[n]M[n]S as per ISO8601. Defaults to PT2H.
ErrorCode string
The Error code when failed.
ErrorMessage string
The Error message indicating why the operation failed.
Linux SoftwareUpdateConfigurationLinux
A linux block as defined below.
Name Changes to this property will trigger replacement. string
The name which should be used for this Automation. Changing this forces a new Automation to be created.
NonAzureComputerNames List<string>
Specifies a list of names of non-Azure machines for the software update configuration.
PostTask SoftwareUpdateConfigurationPostTask
A post_task blocks as defined below.
PreTask SoftwareUpdateConfigurationPreTask
A pre_task blocks as defined below.
Schedule SoftwareUpdateConfigurationSchedule
A schedule blocks as defined below.
Target SoftwareUpdateConfigurationTarget
A target blocks as defined below.
VirtualMachineIds List<string>
Specifies a list of Azure Resource IDs of azure virtual machines.
Windows SoftwareUpdateConfigurationWindows

A windows block as defined below.

NOTE: One of linux or windows must be specified.

AutomationAccountId Changes to this property will trigger replacement. string
The ID of Automation Account to manage this Source Control. Changing this forces a new Automation Source Control to be created.
Duration string
Maximum time allowed for the software update configuration run. using format PT[n]H[n]M[n]S as per ISO8601. Defaults to PT2H.
ErrorCode string
The Error code when failed.
ErrorMessage string
The Error message indicating why the operation failed.
Linux SoftwareUpdateConfigurationLinuxArgs
A linux block as defined below.
Name Changes to this property will trigger replacement. string
The name which should be used for this Automation. Changing this forces a new Automation to be created.
NonAzureComputerNames []string
Specifies a list of names of non-Azure machines for the software update configuration.
PostTask SoftwareUpdateConfigurationPostTaskArgs
A post_task blocks as defined below.
PreTask SoftwareUpdateConfigurationPreTaskArgs
A pre_task blocks as defined below.
Schedule SoftwareUpdateConfigurationScheduleArgs
A schedule blocks as defined below.
Target SoftwareUpdateConfigurationTargetArgs
A target blocks as defined below.
VirtualMachineIds []string
Specifies a list of Azure Resource IDs of azure virtual machines.
Windows SoftwareUpdateConfigurationWindowsArgs

A windows block as defined below.

NOTE: One of linux or windows must be specified.

automationAccountId Changes to this property will trigger replacement. String
The ID of Automation Account to manage this Source Control. Changing this forces a new Automation Source Control to be created.
duration String
Maximum time allowed for the software update configuration run. using format PT[n]H[n]M[n]S as per ISO8601. Defaults to PT2H.
errorCode String
The Error code when failed.
errorMessage String
The Error message indicating why the operation failed.
linux SoftwareUpdateConfigurationLinux
A linux block as defined below.
name Changes to this property will trigger replacement. String
The name which should be used for this Automation. Changing this forces a new Automation to be created.
nonAzureComputerNames List<String>
Specifies a list of names of non-Azure machines for the software update configuration.
postTask SoftwareUpdateConfigurationPostTask
A post_task blocks as defined below.
preTask SoftwareUpdateConfigurationPreTask
A pre_task blocks as defined below.
schedule SoftwareUpdateConfigurationSchedule
A schedule blocks as defined below.
target SoftwareUpdateConfigurationTarget
A target blocks as defined below.
virtualMachineIds List<String>
Specifies a list of Azure Resource IDs of azure virtual machines.
windows SoftwareUpdateConfigurationWindows

A windows block as defined below.

NOTE: One of linux or windows must be specified.

automationAccountId Changes to this property will trigger replacement. string
The ID of Automation Account to manage this Source Control. Changing this forces a new Automation Source Control to be created.
duration string
Maximum time allowed for the software update configuration run. using format PT[n]H[n]M[n]S as per ISO8601. Defaults to PT2H.
errorCode string
The Error code when failed.
errorMessage string
The Error message indicating why the operation failed.
linux SoftwareUpdateConfigurationLinux
A linux block as defined below.
name Changes to this property will trigger replacement. string
The name which should be used for this Automation. Changing this forces a new Automation to be created.
nonAzureComputerNames string[]
Specifies a list of names of non-Azure machines for the software update configuration.
postTask SoftwareUpdateConfigurationPostTask
A post_task blocks as defined below.
preTask SoftwareUpdateConfigurationPreTask
A pre_task blocks as defined below.
schedule SoftwareUpdateConfigurationSchedule
A schedule blocks as defined below.
target SoftwareUpdateConfigurationTarget
A target blocks as defined below.
virtualMachineIds string[]
Specifies a list of Azure Resource IDs of azure virtual machines.
windows SoftwareUpdateConfigurationWindows

A windows block as defined below.

NOTE: One of linux or windows must be specified.

automation_account_id Changes to this property will trigger replacement. str
The ID of Automation Account to manage this Source Control. Changing this forces a new Automation Source Control to be created.
duration str
Maximum time allowed for the software update configuration run. using format PT[n]H[n]M[n]S as per ISO8601. Defaults to PT2H.
error_code str
The Error code when failed.
error_message str
The Error message indicating why the operation failed.
linux SoftwareUpdateConfigurationLinuxArgs
A linux block as defined below.
name Changes to this property will trigger replacement. str
The name which should be used for this Automation. Changing this forces a new Automation to be created.
non_azure_computer_names Sequence[str]
Specifies a list of names of non-Azure machines for the software update configuration.
post_task SoftwareUpdateConfigurationPostTaskArgs
A post_task blocks as defined below.
pre_task SoftwareUpdateConfigurationPreTaskArgs
A pre_task blocks as defined below.
schedule SoftwareUpdateConfigurationScheduleArgs
A schedule blocks as defined below.
target SoftwareUpdateConfigurationTargetArgs
A target blocks as defined below.
virtual_machine_ids Sequence[str]
Specifies a list of Azure Resource IDs of azure virtual machines.
windows SoftwareUpdateConfigurationWindowsArgs

A windows block as defined below.

NOTE: One of linux or windows must be specified.

automationAccountId Changes to this property will trigger replacement. String
The ID of Automation Account to manage this Source Control. Changing this forces a new Automation Source Control to be created.
duration String
Maximum time allowed for the software update configuration run. using format PT[n]H[n]M[n]S as per ISO8601. Defaults to PT2H.
errorCode String
The Error code when failed.
errorMessage String
The Error message indicating why the operation failed.
linux Property Map
A linux block as defined below.
name Changes to this property will trigger replacement. String
The name which should be used for this Automation. Changing this forces a new Automation to be created.
nonAzureComputerNames List<String>
Specifies a list of names of non-Azure machines for the software update configuration.
postTask Property Map
A post_task blocks as defined below.
preTask Property Map
A pre_task blocks as defined below.
schedule Property Map
A schedule blocks as defined below.
target Property Map
A target blocks as defined below.
virtualMachineIds List<String>
Specifies a list of Azure Resource IDs of azure virtual machines.
windows Property Map

A windows block as defined below.

NOTE: One of linux or windows must be specified.

Supporting Types

SoftwareUpdateConfigurationLinux
, SoftwareUpdateConfigurationLinuxArgs

ClassificationsIncludeds This property is required. List<string>
Specifies the list of update classifications included in the Software Update Configuration. Possible values are Unclassified, Critical, Security and Other.
ExcludedPackages List<string>
Specifies a list of packages to excluded from the Software Update Configuration.
IncludedPackages List<string>
Specifies a list of packages to included from the Software Update Configuration.
Reboot string
Specifies the reboot settings after software update, possible values are IfRequired, Never, RebootOnly and Always. Defaults to IfRequired.
ClassificationsIncludeds This property is required. []string
Specifies the list of update classifications included in the Software Update Configuration. Possible values are Unclassified, Critical, Security and Other.
ExcludedPackages []string
Specifies a list of packages to excluded from the Software Update Configuration.
IncludedPackages []string
Specifies a list of packages to included from the Software Update Configuration.
Reboot string
Specifies the reboot settings after software update, possible values are IfRequired, Never, RebootOnly and Always. Defaults to IfRequired.
classificationsIncludeds This property is required. List<String>
Specifies the list of update classifications included in the Software Update Configuration. Possible values are Unclassified, Critical, Security and Other.
excludedPackages List<String>
Specifies a list of packages to excluded from the Software Update Configuration.
includedPackages List<String>
Specifies a list of packages to included from the Software Update Configuration.
reboot String
Specifies the reboot settings after software update, possible values are IfRequired, Never, RebootOnly and Always. Defaults to IfRequired.
classificationsIncludeds This property is required. string[]
Specifies the list of update classifications included in the Software Update Configuration. Possible values are Unclassified, Critical, Security and Other.
excludedPackages string[]
Specifies a list of packages to excluded from the Software Update Configuration.
includedPackages string[]
Specifies a list of packages to included from the Software Update Configuration.
reboot string
Specifies the reboot settings after software update, possible values are IfRequired, Never, RebootOnly and Always. Defaults to IfRequired.
classifications_includeds This property is required. Sequence[str]
Specifies the list of update classifications included in the Software Update Configuration. Possible values are Unclassified, Critical, Security and Other.
excluded_packages Sequence[str]
Specifies a list of packages to excluded from the Software Update Configuration.
included_packages Sequence[str]
Specifies a list of packages to included from the Software Update Configuration.
reboot str
Specifies the reboot settings after software update, possible values are IfRequired, Never, RebootOnly and Always. Defaults to IfRequired.
classificationsIncludeds This property is required. List<String>
Specifies the list of update classifications included in the Software Update Configuration. Possible values are Unclassified, Critical, Security and Other.
excludedPackages List<String>
Specifies a list of packages to excluded from the Software Update Configuration.
includedPackages List<String>
Specifies a list of packages to included from the Software Update Configuration.
reboot String
Specifies the reboot settings after software update, possible values are IfRequired, Never, RebootOnly and Always. Defaults to IfRequired.

SoftwareUpdateConfigurationPostTask
, SoftwareUpdateConfigurationPostTaskArgs

Parameters Dictionary<string, string>
Specifies a map of parameters for the task.
Source string
The name of the runbook for the post task.
Parameters map[string]string
Specifies a map of parameters for the task.
Source string
The name of the runbook for the post task.
parameters Map<String,String>
Specifies a map of parameters for the task.
source String
The name of the runbook for the post task.
parameters {[key: string]: string}
Specifies a map of parameters for the task.
source string
The name of the runbook for the post task.
parameters Mapping[str, str]
Specifies a map of parameters for the task.
source str
The name of the runbook for the post task.
parameters Map<String>
Specifies a map of parameters for the task.
source String
The name of the runbook for the post task.

SoftwareUpdateConfigurationPreTask
, SoftwareUpdateConfigurationPreTaskArgs

Parameters Dictionary<string, string>
Specifies a map of parameters for the task.
Source string
The name of the runbook for the pre task.
Parameters map[string]string
Specifies a map of parameters for the task.
Source string
The name of the runbook for the pre task.
parameters Map<String,String>
Specifies a map of parameters for the task.
source String
The name of the runbook for the pre task.
parameters {[key: string]: string}
Specifies a map of parameters for the task.
source string
The name of the runbook for the pre task.
parameters Mapping[str, str]
Specifies a map of parameters for the task.
source str
The name of the runbook for the pre task.
parameters Map<String>
Specifies a map of parameters for the task.
source String
The name of the runbook for the pre task.

SoftwareUpdateConfigurationSchedule
, SoftwareUpdateConfigurationScheduleArgs

Frequency This property is required. string
The frequency of the schedule. - can be either OneTime, Day, Hour, Week, or Month.
AdvancedMonthDays List<int>
List of days of the month that the job should execute on. Must be between 1 and 31. -1 for last day of the month. Only valid when frequency is Month.
AdvancedWeekDays List<string>
List of days of the week that the job should execute on. Only valid when frequency is Week. Possible values include Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, and Sunday.
CreationTime string
Description string
A description for this Schedule.
ExpiryTime string
The end time of the schedule.
ExpiryTimeOffsetMinutes double
Interval int
The number of frequencys between runs. Only valid when frequency is Day, Hour, Week, or Month.
IsEnabled bool
Whether the schedule is enabled. Defaults to true.
LastModifiedTime string
MonthlyOccurrence SoftwareUpdateConfigurationScheduleMonthlyOccurrence
List of monthly_occurrence blocks as defined below to specifies occurrences of days within a month. Only valid when frequency is Month. The monthly_occurrence block supports fields as defined below.
NextRun string
NextRunOffsetMinutes double
StartTime string
Start time of the schedule. Must be at least five minutes in the future. Defaults to seven minutes in the future from the time the resource is created.
StartTimeOffsetMinutes double
TimeZone string
The timezone of the start time. Defaults to Etc/UTC. For possible values see: https://docs.microsoft.com/en-us/rest/api/maps/timezone/gettimezoneenumwindows
Frequency This property is required. string
The frequency of the schedule. - can be either OneTime, Day, Hour, Week, or Month.
AdvancedMonthDays []int
List of days of the month that the job should execute on. Must be between 1 and 31. -1 for last day of the month. Only valid when frequency is Month.
AdvancedWeekDays []string
List of days of the week that the job should execute on. Only valid when frequency is Week. Possible values include Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, and Sunday.
CreationTime string
Description string
A description for this Schedule.
ExpiryTime string
The end time of the schedule.
ExpiryTimeOffsetMinutes float64
Interval int
The number of frequencys between runs. Only valid when frequency is Day, Hour, Week, or Month.
IsEnabled bool
Whether the schedule is enabled. Defaults to true.
LastModifiedTime string
MonthlyOccurrence SoftwareUpdateConfigurationScheduleMonthlyOccurrence
List of monthly_occurrence blocks as defined below to specifies occurrences of days within a month. Only valid when frequency is Month. The monthly_occurrence block supports fields as defined below.
NextRun string
NextRunOffsetMinutes float64
StartTime string
Start time of the schedule. Must be at least five minutes in the future. Defaults to seven minutes in the future from the time the resource is created.
StartTimeOffsetMinutes float64
TimeZone string
The timezone of the start time. Defaults to Etc/UTC. For possible values see: https://docs.microsoft.com/en-us/rest/api/maps/timezone/gettimezoneenumwindows
frequency This property is required. String
The frequency of the schedule. - can be either OneTime, Day, Hour, Week, or Month.
advancedMonthDays List<Integer>
List of days of the month that the job should execute on. Must be between 1 and 31. -1 for last day of the month. Only valid when frequency is Month.
advancedWeekDays List<String>
List of days of the week that the job should execute on. Only valid when frequency is Week. Possible values include Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, and Sunday.
creationTime String
description String
A description for this Schedule.
expiryTime String
The end time of the schedule.
expiryTimeOffsetMinutes Double
interval Integer
The number of frequencys between runs. Only valid when frequency is Day, Hour, Week, or Month.
isEnabled Boolean
Whether the schedule is enabled. Defaults to true.
lastModifiedTime String
monthlyOccurrence SoftwareUpdateConfigurationScheduleMonthlyOccurrence
List of monthly_occurrence blocks as defined below to specifies occurrences of days within a month. Only valid when frequency is Month. The monthly_occurrence block supports fields as defined below.
nextRun String
nextRunOffsetMinutes Double
startTime String
Start time of the schedule. Must be at least five minutes in the future. Defaults to seven minutes in the future from the time the resource is created.
startTimeOffsetMinutes Double
timeZone String
The timezone of the start time. Defaults to Etc/UTC. For possible values see: https://docs.microsoft.com/en-us/rest/api/maps/timezone/gettimezoneenumwindows
frequency This property is required. string
The frequency of the schedule. - can be either OneTime, Day, Hour, Week, or Month.
advancedMonthDays number[]
List of days of the month that the job should execute on. Must be between 1 and 31. -1 for last day of the month. Only valid when frequency is Month.
advancedWeekDays string[]
List of days of the week that the job should execute on. Only valid when frequency is Week. Possible values include Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, and Sunday.
creationTime string
description string
A description for this Schedule.
expiryTime string
The end time of the schedule.
expiryTimeOffsetMinutes number
interval number
The number of frequencys between runs. Only valid when frequency is Day, Hour, Week, or Month.
isEnabled boolean
Whether the schedule is enabled. Defaults to true.
lastModifiedTime string
monthlyOccurrence SoftwareUpdateConfigurationScheduleMonthlyOccurrence
List of monthly_occurrence blocks as defined below to specifies occurrences of days within a month. Only valid when frequency is Month. The monthly_occurrence block supports fields as defined below.
nextRun string
nextRunOffsetMinutes number
startTime string
Start time of the schedule. Must be at least five minutes in the future. Defaults to seven minutes in the future from the time the resource is created.
startTimeOffsetMinutes number
timeZone string
The timezone of the start time. Defaults to Etc/UTC. For possible values see: https://docs.microsoft.com/en-us/rest/api/maps/timezone/gettimezoneenumwindows
frequency This property is required. str
The frequency of the schedule. - can be either OneTime, Day, Hour, Week, or Month.
advanced_month_days Sequence[int]
List of days of the month that the job should execute on. Must be between 1 and 31. -1 for last day of the month. Only valid when frequency is Month.
advanced_week_days Sequence[str]
List of days of the week that the job should execute on. Only valid when frequency is Week. Possible values include Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, and Sunday.
creation_time str
description str
A description for this Schedule.
expiry_time str
The end time of the schedule.
expiry_time_offset_minutes float
interval int
The number of frequencys between runs. Only valid when frequency is Day, Hour, Week, or Month.
is_enabled bool
Whether the schedule is enabled. Defaults to true.
last_modified_time str
monthly_occurrence SoftwareUpdateConfigurationScheduleMonthlyOccurrence
List of monthly_occurrence blocks as defined below to specifies occurrences of days within a month. Only valid when frequency is Month. The monthly_occurrence block supports fields as defined below.
next_run str
next_run_offset_minutes float
start_time str
Start time of the schedule. Must be at least five minutes in the future. Defaults to seven minutes in the future from the time the resource is created.
start_time_offset_minutes float
time_zone str
The timezone of the start time. Defaults to Etc/UTC. For possible values see: https://docs.microsoft.com/en-us/rest/api/maps/timezone/gettimezoneenumwindows
frequency This property is required. String
The frequency of the schedule. - can be either OneTime, Day, Hour, Week, or Month.
advancedMonthDays List<Number>
List of days of the month that the job should execute on. Must be between 1 and 31. -1 for last day of the month. Only valid when frequency is Month.
advancedWeekDays List<String>
List of days of the week that the job should execute on. Only valid when frequency is Week. Possible values include Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, and Sunday.
creationTime String
description String
A description for this Schedule.
expiryTime String
The end time of the schedule.
expiryTimeOffsetMinutes Number
interval Number
The number of frequencys between runs. Only valid when frequency is Day, Hour, Week, or Month.
isEnabled Boolean
Whether the schedule is enabled. Defaults to true.
lastModifiedTime String
monthlyOccurrence Property Map
List of monthly_occurrence blocks as defined below to specifies occurrences of days within a month. Only valid when frequency is Month. The monthly_occurrence block supports fields as defined below.
nextRun String
nextRunOffsetMinutes Number
startTime String
Start time of the schedule. Must be at least five minutes in the future. Defaults to seven minutes in the future from the time the resource is created.
startTimeOffsetMinutes Number
timeZone String
The timezone of the start time. Defaults to Etc/UTC. For possible values see: https://docs.microsoft.com/en-us/rest/api/maps/timezone/gettimezoneenumwindows

SoftwareUpdateConfigurationScheduleMonthlyOccurrence
, SoftwareUpdateConfigurationScheduleMonthlyOccurrenceArgs

Day This property is required. string
Day of the occurrence. Must be one of Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.
Occurrence This property is required. int
Occurrence of the week within the month. Must be between 1 and 4. -1 for last week within the month.
Day This property is required. string
Day of the occurrence. Must be one of Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.
Occurrence This property is required. int
Occurrence of the week within the month. Must be between 1 and 4. -1 for last week within the month.
day This property is required. String
Day of the occurrence. Must be one of Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.
occurrence This property is required. Integer
Occurrence of the week within the month. Must be between 1 and 4. -1 for last week within the month.
day This property is required. string
Day of the occurrence. Must be one of Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.
occurrence This property is required. number
Occurrence of the week within the month. Must be between 1 and 4. -1 for last week within the month.
day This property is required. str
Day of the occurrence. Must be one of Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.
occurrence This property is required. int
Occurrence of the week within the month. Must be between 1 and 4. -1 for last week within the month.
day This property is required. String
Day of the occurrence. Must be one of Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.
occurrence This property is required. Number
Occurrence of the week within the month. Must be between 1 and 4. -1 for last week within the month.

SoftwareUpdateConfigurationTarget
, SoftwareUpdateConfigurationTargetArgs

AzureQueries List<SoftwareUpdateConfigurationTargetAzureQuery>
One or more azure_query blocks as defined above.
NonAzureQueries List<SoftwareUpdateConfigurationTargetNonAzureQuery>
One or more non_azure_query blocks as defined above.
AzureQueries []SoftwareUpdateConfigurationTargetAzureQuery
One or more azure_query blocks as defined above.
NonAzureQueries []SoftwareUpdateConfigurationTargetNonAzureQuery
One or more non_azure_query blocks as defined above.
azureQueries List<SoftwareUpdateConfigurationTargetAzureQuery>
One or more azure_query blocks as defined above.
nonAzureQueries List<SoftwareUpdateConfigurationTargetNonAzureQuery>
One or more non_azure_query blocks as defined above.
azureQueries SoftwareUpdateConfigurationTargetAzureQuery[]
One or more azure_query blocks as defined above.
nonAzureQueries SoftwareUpdateConfigurationTargetNonAzureQuery[]
One or more non_azure_query blocks as defined above.
azure_queries Sequence[SoftwareUpdateConfigurationTargetAzureQuery]
One or more azure_query blocks as defined above.
non_azure_queries Sequence[SoftwareUpdateConfigurationTargetNonAzureQuery]
One or more non_azure_query blocks as defined above.
azureQueries List<Property Map>
One or more azure_query blocks as defined above.
nonAzureQueries List<Property Map>
One or more non_azure_query blocks as defined above.

SoftwareUpdateConfigurationTargetAzureQuery
, SoftwareUpdateConfigurationTargetAzureQueryArgs

Locations List<string>
Specifies a list of locations to scope the query to.
Scopes List<string>
Specifies a list of Subscription or Resource Group ARM Ids to query.
TagFilter string
Specifies how the specified tags to filter VMs. Possible values are Any and All.
Tags List<SoftwareUpdateConfigurationTargetAzureQueryTag>
A mapping of tags used for query filter. One or more tags block as defined below.
Locations []string
Specifies a list of locations to scope the query to.
Scopes []string
Specifies a list of Subscription or Resource Group ARM Ids to query.
TagFilter string
Specifies how the specified tags to filter VMs. Possible values are Any and All.
Tags []SoftwareUpdateConfigurationTargetAzureQueryTag
A mapping of tags used for query filter. One or more tags block as defined below.
locations List<String>
Specifies a list of locations to scope the query to.
scopes List<String>
Specifies a list of Subscription or Resource Group ARM Ids to query.
tagFilter String
Specifies how the specified tags to filter VMs. Possible values are Any and All.
tags List<SoftwareUpdateConfigurationTargetAzureQueryTag>
A mapping of tags used for query filter. One or more tags block as defined below.
locations string[]
Specifies a list of locations to scope the query to.
scopes string[]
Specifies a list of Subscription or Resource Group ARM Ids to query.
tagFilter string
Specifies how the specified tags to filter VMs. Possible values are Any and All.
tags SoftwareUpdateConfigurationTargetAzureQueryTag[]
A mapping of tags used for query filter. One or more tags block as defined below.
locations Sequence[str]
Specifies a list of locations to scope the query to.
scopes Sequence[str]
Specifies a list of Subscription or Resource Group ARM Ids to query.
tag_filter str
Specifies how the specified tags to filter VMs. Possible values are Any and All.
tags Sequence[SoftwareUpdateConfigurationTargetAzureQueryTag]
A mapping of tags used for query filter. One or more tags block as defined below.
locations List<String>
Specifies a list of locations to scope the query to.
scopes List<String>
Specifies a list of Subscription or Resource Group ARM Ids to query.
tagFilter String
Specifies how the specified tags to filter VMs. Possible values are Any and All.
tags List<Property Map>
A mapping of tags used for query filter. One or more tags block as defined below.

SoftwareUpdateConfigurationTargetAzureQueryTag
, SoftwareUpdateConfigurationTargetAzureQueryTagArgs

Tag This property is required. string
Specifies the name of the tag to filter.
Values This property is required. List<string>
Specifies a list of values for this tag key.
Tag This property is required. string
Specifies the name of the tag to filter.
Values This property is required. []string
Specifies a list of values for this tag key.
tag This property is required. String
Specifies the name of the tag to filter.
values This property is required. List<String>
Specifies a list of values for this tag key.
tag This property is required. string
Specifies the name of the tag to filter.
values This property is required. string[]
Specifies a list of values for this tag key.
tag This property is required. str
Specifies the name of the tag to filter.
values This property is required. Sequence[str]
Specifies a list of values for this tag key.
tag This property is required. String
Specifies the name of the tag to filter.
values This property is required. List<String>
Specifies a list of values for this tag key.

SoftwareUpdateConfigurationTargetNonAzureQuery
, SoftwareUpdateConfigurationTargetNonAzureQueryArgs

FunctionAlias string
Specifies the Log Analytics save search name.
WorkspaceId string
The workspace id for Log Analytics in which the saved search in.
FunctionAlias string
Specifies the Log Analytics save search name.
WorkspaceId string
The workspace id for Log Analytics in which the saved search in.
functionAlias String
Specifies the Log Analytics save search name.
workspaceId String
The workspace id for Log Analytics in which the saved search in.
functionAlias string
Specifies the Log Analytics save search name.
workspaceId string
The workspace id for Log Analytics in which the saved search in.
function_alias str
Specifies the Log Analytics save search name.
workspace_id str
The workspace id for Log Analytics in which the saved search in.
functionAlias String
Specifies the Log Analytics save search name.
workspaceId String
The workspace id for Log Analytics in which the saved search in.

SoftwareUpdateConfigurationWindows
, SoftwareUpdateConfigurationWindowsArgs

ClassificationsIncludeds This property is required. List<string>
Specifies the list of update classification. Possible values are Unclassified, Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools and Updates.
ExcludedKnowledgeBaseNumbers List<string>
Specifies a list of knowledge base numbers excluded.
IncludedKnowledgeBaseNumbers List<string>
Specifies a list of knowledge base numbers included.
Reboot string
Specifies the reboot settings after software update, possible values are IfRequired, Never, RebootOnly and Always. Defaults to IfRequired.
ClassificationsIncludeds This property is required. []string
Specifies the list of update classification. Possible values are Unclassified, Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools and Updates.
ExcludedKnowledgeBaseNumbers []string
Specifies a list of knowledge base numbers excluded.
IncludedKnowledgeBaseNumbers []string
Specifies a list of knowledge base numbers included.
Reboot string
Specifies the reboot settings after software update, possible values are IfRequired, Never, RebootOnly and Always. Defaults to IfRequired.
classificationsIncludeds This property is required. List<String>
Specifies the list of update classification. Possible values are Unclassified, Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools and Updates.
excludedKnowledgeBaseNumbers List<String>
Specifies a list of knowledge base numbers excluded.
includedKnowledgeBaseNumbers List<String>
Specifies a list of knowledge base numbers included.
reboot String
Specifies the reboot settings after software update, possible values are IfRequired, Never, RebootOnly and Always. Defaults to IfRequired.
classificationsIncludeds This property is required. string[]
Specifies the list of update classification. Possible values are Unclassified, Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools and Updates.
excludedKnowledgeBaseNumbers string[]
Specifies a list of knowledge base numbers excluded.
includedKnowledgeBaseNumbers string[]
Specifies a list of knowledge base numbers included.
reboot string
Specifies the reboot settings after software update, possible values are IfRequired, Never, RebootOnly and Always. Defaults to IfRequired.
classifications_includeds This property is required. Sequence[str]
Specifies the list of update classification. Possible values are Unclassified, Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools and Updates.
excluded_knowledge_base_numbers Sequence[str]
Specifies a list of knowledge base numbers excluded.
included_knowledge_base_numbers Sequence[str]
Specifies a list of knowledge base numbers included.
reboot str
Specifies the reboot settings after software update, possible values are IfRequired, Never, RebootOnly and Always. Defaults to IfRequired.
classificationsIncludeds This property is required. List<String>
Specifies the list of update classification. Possible values are Unclassified, Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools and Updates.
excludedKnowledgeBaseNumbers List<String>
Specifies a list of knowledge base numbers excluded.
includedKnowledgeBaseNumbers List<String>
Specifies a list of knowledge base numbers included.
reboot String
Specifies the reboot settings after software update, possible values are IfRequired, Never, RebootOnly and Always. Defaults to IfRequired.

Import

Automations Software Update Configuration can be imported using the resource id, e.g.

$ pulumi import azure:automation/softwareUpdateConfiguration:SoftwareUpdateConfiguration example /subscriptions/12345678-1234-9876-4563-123456789012/resourceGroups/group1/providers/Microsoft.Automation/automationAccounts/account1/softwareUpdateConfigurations/suc1
Copy

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.

We recommend using Azure Native.

Azure v6.22.0 published on Tuesday, Apr 1, 2025 by Pulumi
pulumi/pulumi-azure