Software Update Configurations - Create

Usługa:

Automation

Wersja interfejsu API:

2019-06-01

Utwórz nową konfigurację aktualizacji oprogramowania o nazwie podanej w identyfikatorze URI.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/softwareUpdateConfigurations/{softwareUpdateConfigurationName}?api-version=2019-06-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
automationAccountName	path	True	string	Nazwa konta usługi Automation.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Nazwa grupy zasobów platformy Azure.
softwareUpdateConfigurationName	path	True	string	Nazwa konfiguracji aktualizacji oprogramowania, która ma zostać utworzona.
subscriptionId	path	True	string	Pobiera poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.
api-version	query	True	string	Wersja interfejsu API klienta.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
clientRequestId		string	Identyfikuje to konkretne żądanie klienta.

Treść żądania

Nazwa	Wymagane	Typ	Opis
properties.scheduleInfo	True	SUCScheduleProperties	Informacje o harmonogramie konfiguracji aktualizacji oprogramowania
properties.updateConfiguration	True	updateConfiguration	aktualizowanie określonych właściwości konfiguracji aktualizacji oprogramowania
properties.error		ErrorResponse	Szczegóły błędu aprowizacji
properties.tasks		softwareUpdateConfigurationTasks	Informacje o zadaniach konfiguracji aktualizacji oprogramowania.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	softwareUpdateConfiguration	Konfiguracja aktualizacji oprogramowania o tej samej nazwie i właściwościach już istnieje.
201 Created	softwareUpdateConfiguration	Zostanie utworzona konfiguracja aktualizacji oprogramowania.
Other Status Codes	ErrorResponse	Odpowiedź na błąd automatyzacji opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Create software update configuration

Przykładowe żądanie

HTTP

PUT https://management.azure.com/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurations/testpatch?api-version=2019-06-01

{
  "properties": {
    "updateConfiguration": {
      "operatingSystem": "Windows",
      "duration": "PT2H0M",
      "windows": {
        "excludedKbNumbers": [
          "168934",
          "168973"
        ],
        "includedUpdateClassifications": "Critical",
        "rebootSetting": "IfRequired"
      },
      "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"
      ],
      "nonAzureComputerNames": [
        "box1.contoso.com",
        "box2.contoso.com"
      ],
      "targets": {
        "azureQueries": [
          {
            "scope": [
              "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources",
              "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067"
            ],
            "tagSettings": {
              "tags": {
                "tag1": [
                  "tag1Value1",
                  "tag1Value2",
                  "tag1Value3"
                ],
                "tag2": [
                  "tag2Value1",
                  "tag2Value2",
                  "tag2Value3"
                ]
              },
              "filterOperator": "All"
            },
            "locations": [
              "Japan East",
              "UK South"
            ]
          }
        ],
        "nonAzureQueries": [
          {
            "functionAlias": "SavedSearch1",
            "workspaceId": "WorkspaceId1"
          },
          {
            "functionAlias": "SavedSearch2",
            "workspaceId": "WorkspaceId2"
          }
        ]
      }
    },
    "scheduleInfo": {
      "frequency": "Hour",
      "startTime": "2017-10-19T12:22:57+00:00",
      "timeZone": "America/Los_Angeles",
      "interval": 1,
      "expiryTime": "2018-11-09T11:22:57+00:00",
      "advancedSchedule": {
        "weekDays": [
          "Monday",
          "Thursday"
        ]
      }
    },
    "tasks": {
      "preTask": {
        "source": "HelloWorld",
        "parameters": {
          "COMPUTERNAME": "Computer1"
        }
      },
      "postTask": {
        "source": "GetCache",
        "parameters": null
      }
    }
  }
}

Java

import com.azure.resourcemanager.automation.models.AdvancedSchedule;
import com.azure.resourcemanager.automation.models.AzureQueryProperties;
import com.azure.resourcemanager.automation.models.NonAzureQueryProperties;
import com.azure.resourcemanager.automation.models.OperatingSystemType;
import com.azure.resourcemanager.automation.models.ScheduleFrequency;
import com.azure.resourcemanager.automation.models.SoftwareUpdateConfigurationTasks;
import com.azure.resourcemanager.automation.models.SucScheduleProperties;
import com.azure.resourcemanager.automation.models.TagOperators;
import com.azure.resourcemanager.automation.models.TagSettingsProperties;
import com.azure.resourcemanager.automation.models.TargetProperties;
import com.azure.resourcemanager.automation.models.TaskProperties;
import com.azure.resourcemanager.automation.models.UpdateConfiguration;
import com.azure.resourcemanager.automation.models.WindowsProperties;
import com.azure.resourcemanager.automation.models.WindowsUpdateClasses;
import java.time.Duration;
import java.time.OffsetDateTime;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for SoftwareUpdateConfigurations Create.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/automation/resource-manager/Microsoft.Automation/stable/2019-06-01/examples/
     * softwareUpdateConfiguration/createSoftwareUpdateConfiguration.json
     */
    /**
     * Sample code: Create software update configuration.
     * 
     * @param manager Entry point to AutomationManager.
     */
    public static void
        createSoftwareUpdateConfiguration(com.azure.resourcemanager.automation.AutomationManager manager) {
        manager.softwareUpdateConfigurations().define("testpatch").withExistingAutomationAccount("mygroup", "myaccount")
            .withUpdateConfiguration(new UpdateConfiguration().withOperatingSystem(OperatingSystemType.WINDOWS)
                .withWindows(new WindowsProperties().withIncludedUpdateClassifications(WindowsUpdateClasses.CRITICAL)
                    .withExcludedKbNumbers(Arrays.asList("168934", "168973")).withRebootSetting("IfRequired"))
                .withDuration(Duration.parse("PT2H0M"))
                .withAzureVirtualMachines(Arrays.asList(
                    "/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"))
                .withNonAzureComputerNames(Arrays.asList("box1.contoso.com", "box2.contoso.com"))
                .withTargets(new TargetProperties()
                    .withAzureQueries(Arrays.asList(new AzureQueryProperties()
                        .withScope(Arrays.asList(
                            "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources",
                            "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067"))
                        .withLocations(Arrays.asList("Japan East", "UK South"))
                        .withTagSettings(new TagSettingsProperties()
                            .withTags(mapOf("tag1", Arrays.asList("tag1Value1", "tag1Value2", "tag1Value3"), "tag2",
                                Arrays.asList("tag2Value1", "tag2Value2", "tag2Value3")))
                            .withFilterOperator(TagOperators.ALL))))
                    .withNonAzureQueries(Arrays.asList(
                        new NonAzureQueryProperties().withFunctionAlias("SavedSearch1").withWorkspaceId("WorkspaceId1"),
                        new NonAzureQueryProperties().withFunctionAlias("SavedSearch2")
                            .withWorkspaceId("WorkspaceId2")))))
            .withScheduleInfo(
                new SucScheduleProperties().withStartTime(OffsetDateTime.parse("2017-10-19T12:22:57+00:00"))
                    .withExpiryTime(OffsetDateTime.parse("2018-11-09T11:22:57+00:00")).withInterval(1L)
                    .withFrequency(ScheduleFrequency.HOUR).withTimeZone("America/Los_Angeles")
                    .withAdvancedSchedule(new AdvancedSchedule().withWeekDays(Arrays.asList("Monday", "Thursday"))))
            .withTasks(new SoftwareUpdateConfigurationTasks()
                .withPreTask(
                    new TaskProperties().withParameters(mapOf("COMPUTERNAME", "Computer1")).withSource("HelloWorld"))
                .withPostTask(new TaskProperties().withSource("GetCache")))
            .create();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.automation import AutomationClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-automation
# USAGE
    python create_software_update_configuration.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = AutomationClient(
        credential=DefaultAzureCredential(),
        subscription_id="51766542-3ed7-4a72-a187-0c8ab644ddab",
    )

    response = client.software_update_configurations.create(
        resource_group_name="mygroup",
        automation_account_name="myaccount",
        software_update_configuration_name="testpatch",
        parameters={
            "properties": {
                "scheduleInfo": {
                    "advancedSchedule": {"weekDays": ["Monday", "Thursday"]},
                    "expiryTime": "2018-11-09T11:22:57+00:00",
                    "frequency": "Hour",
                    "interval": 1,
                    "startTime": "2017-10-19T12:22:57+00:00",
                    "timeZone": "America/Los_Angeles",
                },
                "tasks": {
                    "postTask": {"parameters": None, "source": "GetCache"},
                    "preTask": {"parameters": {"COMPUTERNAME": "Computer1"}, "source": "HelloWorld"},
                },
                "updateConfiguration": {
                    "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": {
                        "azureQueries": [
                            {
                                "locations": ["Japan East", "UK South"],
                                "scope": [
                                    "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources",
                                    "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067",
                                ],
                                "tagSettings": {
                                    "filterOperator": "All",
                                    "tags": {
                                        "tag1": ["tag1Value1", "tag1Value2", "tag1Value3"],
                                        "tag2": ["tag2Value1", "tag2Value2", "tag2Value3"],
                                    },
                                },
                            }
                        ],
                        "nonAzureQueries": [
                            {"functionAlias": "SavedSearch1", "workspaceId": "WorkspaceId1"},
                            {"functionAlias": "SavedSearch2", "workspaceId": "WorkspaceId2"},
                        ],
                    },
                    "windows": {
                        "excludedKbNumbers": ["168934", "168973"],
                        "includedUpdateClassifications": "Critical",
                        "rebootSetting": "IfRequired",
                    },
                },
            }
        },
    )
    print(response)


# x-ms-original-file: specification/automation/resource-manager/Microsoft.Automation/stable/2019-06-01/examples/softwareUpdateConfiguration/createSoftwareUpdateConfiguration.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armautomation_test

import (
	"context"
	"log"

	"time"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/automation/armautomation"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/432872fac1d0f8edcae98a0e8504afc0ee302710/specification/automation/resource-manager/Microsoft.Automation/stable/2019-06-01/examples/softwareUpdateConfiguration/createSoftwareUpdateConfiguration.json
func ExampleSoftwareUpdateConfigurationsClient_Create() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armautomation.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewSoftwareUpdateConfigurationsClient().Create(ctx, "mygroup", "myaccount", "testpatch", armautomation.SoftwareUpdateConfiguration{
		Properties: &armautomation.SoftwareUpdateConfigurationProperties{
			ScheduleInfo: &armautomation.SUCScheduleProperties{
				AdvancedSchedule: &armautomation.AdvancedSchedule{
					WeekDays: []*string{
						to.Ptr("Monday"),
						to.Ptr("Thursday")},
				},
				ExpiryTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-11-09T11:22:57.000Z"); return t }()),
				Frequency:  to.Ptr(armautomation.ScheduleFrequencyHour),
				Interval:   to.Ptr[int64](1),
				StartTime:  to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-10-19T12:22:57.000Z"); return t }()),
				TimeZone:   to.Ptr("America/Los_Angeles"),
			},
			Tasks: &armautomation.SoftwareUpdateConfigurationTasks{
				PostTask: &armautomation.TaskProperties{
					Source: to.Ptr("GetCache"),
				},
				PreTask: &armautomation.TaskProperties{
					Parameters: map[string]*string{
						"COMPUTERNAME": to.Ptr("Computer1"),
					},
					Source: to.Ptr("HelloWorld"),
				},
			},
			UpdateConfiguration: &armautomation.UpdateConfiguration{
				AzureVirtualMachines: []*string{
					to.Ptr("/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01"),
					to.Ptr("/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02"),
					to.Ptr("/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03")},
				Duration: to.Ptr("PT2H0M"),
				NonAzureComputerNames: []*string{
					to.Ptr("box1.contoso.com"),
					to.Ptr("box2.contoso.com")},
				OperatingSystem: to.Ptr(armautomation.OperatingSystemTypeWindows),
				Targets: &armautomation.TargetProperties{
					AzureQueries: []*armautomation.AzureQueryProperties{
						{
							Locations: []*string{
								to.Ptr("Japan East"),
								to.Ptr("UK South")},
							Scope: []*string{
								to.Ptr("/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources"),
								to.Ptr("/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067")},
							TagSettings: &armautomation.TagSettingsProperties{
								FilterOperator: to.Ptr(armautomation.TagOperatorsAll),
								Tags: map[string][]*string{
									"tag1": {
										to.Ptr("tag1Value1"),
										to.Ptr("tag1Value2"),
										to.Ptr("tag1Value3")},
									"tag2": {
										to.Ptr("tag2Value1"),
										to.Ptr("tag2Value2"),
										to.Ptr("tag2Value3")},
								},
							},
						}},
					NonAzureQueries: []*armautomation.NonAzureQueryProperties{
						{
							FunctionAlias: to.Ptr("SavedSearch1"),
							WorkspaceID:   to.Ptr("WorkspaceId1"),
						},
						{
							FunctionAlias: to.Ptr("SavedSearch2"),
							WorkspaceID:   to.Ptr("WorkspaceId2"),
						}},
				},
				Windows: &armautomation.WindowsProperties{
					ExcludedKbNumbers: []*string{
						to.Ptr("168934"),
						to.Ptr("168973")},
					IncludedUpdateClassifications: to.Ptr(armautomation.WindowsUpdateClassesCritical),
					RebootSetting:                 to.Ptr("IfRequired"),
				},
			},
		},
	}, &armautomation.SoftwareUpdateConfigurationsClientCreateOptions{ClientRequestID: nil})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.SoftwareUpdateConfiguration = armautomation.SoftwareUpdateConfiguration{
	// 	Name: to.Ptr("testpatch"),
	// 	ID: to.Ptr("/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurations/testpatch"),
	// 	Properties: &armautomation.SoftwareUpdateConfigurationProperties{
	// 		CreatedBy: to.Ptr("adam@contoso.com"),
	// 		CreationTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-10-19T18:54:50.523Z"); return t}()),
	// 		Error: &armautomation.ErrorResponse{
	// 		},
	// 		LastModifiedBy: to.Ptr("adam@contoso.com"),
	// 		LastModifiedTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-10-19T18:54:50.680Z"); return t}()),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		ScheduleInfo: &armautomation.SUCScheduleProperties{
	// 			Description: to.Ptr(""),
	// 			AdvancedSchedule: &armautomation.AdvancedSchedule{
	// 			},
	// 			CreationTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-10-19T18:54:50.523Z"); return t}()),
	// 			ExpiryTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-11-09T19:22:00.000Z"); return t}()),
	// 			ExpiryTimeOffsetMinutes: to.Ptr[float64](-480),
	// 			Frequency: to.Ptr(armautomation.ScheduleFrequencyWeek),
	// 			Interval: to.Ptr[int64](1),
	// 			IsEnabled: to.Ptr(true),
	// 			LastModifiedTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-10-19T18:54:50.523Z"); return t}()),
	// 			NextRun: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-10-19T19:22:00.000Z"); return t}()),
	// 			NextRunOffsetMinutes: to.Ptr[float64](-420),
	// 			StartTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-10-19T19:22:00.000Z"); return t}()),
	// 			StartTimeOffsetMinutes: to.Ptr[float64](-420),
	// 			TimeZone: to.Ptr("America/Los_Angeles"),
	// 		},
	// 		Tasks: &armautomation.SoftwareUpdateConfigurationTasks{
	// 			PostTask: &armautomation.TaskProperties{
	// 				Source: to.Ptr("GetCache"),
	// 			},
	// 			PreTask: &armautomation.TaskProperties{
	// 				Parameters: map[string]*string{
	// 					"COMPUTERNAME": to.Ptr("Computer1"),
	// 				},
	// 				Source: to.Ptr("HelloWorld"),
	// 			},
	// 		},
	// 		UpdateConfiguration: &armautomation.UpdateConfiguration{
	// 			AzureVirtualMachines: []*string{
	// 				to.Ptr("/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01"),
	// 				to.Ptr("/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02"),
	// 				to.Ptr("/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03")},
	// 				Duration: to.Ptr("PT2H"),
	// 				Linux: &armautomation.LinuxProperties{
	// 				},
	// 				NonAzureComputerNames: []*string{
	// 					to.Ptr("box1.contoso.com"),
	// 					to.Ptr("box2.contoso.com")},
	// 					OperatingSystem: to.Ptr(armautomation.OperatingSystemTypeWindows),
	// 					Targets: &armautomation.TargetProperties{
	// 						AzureQueries: []*armautomation.AzureQueryProperties{
	// 							{
	// 								Locations: []*string{
	// 									to.Ptr("Japan East"),
	// 									to.Ptr("UK South")},
	// 									Scope: []*string{
	// 										to.Ptr("/subscriptions/422b6c61-95b0-4213-b3be-7282315df71d/resourceGroups/a-stasku-rg0"),
	// 										to.Ptr("/subscriptions/422b6c61-95b0-4213-b3be-7282315df71d")},
	// 										TagSettings: &armautomation.TagSettingsProperties{
	// 											FilterOperator: to.Ptr(armautomation.TagOperatorsAll),
	// 											Tags: map[string][]*string{
	// 												"tag1": []*string{
	// 													to.Ptr("tag1Value1"),
	// 													to.Ptr("tag1Value2")},
	// 													"tag2": []*string{
	// 														to.Ptr("tag2Value1"),
	// 														to.Ptr("tag2Value2")},
	// 													},
	// 												},
	// 										}},
	// 									},
	// 									Windows: &armautomation.WindowsProperties{
	// 										ExcludedKbNumbers: []*string{
	// 											to.Ptr("168934"),
	// 											to.Ptr("168973")},
	// 											IncludedUpdateClassifications: to.Ptr(armautomation.WindowsUpdateClassesCritical),
	// 										},
	// 									},
	// 								},
	// 							}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { AutomationClient } = require("@azure/arm-automation");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Create a new software update configuration with the name given in the URI.
 *
 * @summary Create a new software update configuration with the name given in the URI.
 * x-ms-original-file: specification/automation/resource-manager/Microsoft.Automation/stable/2019-06-01/examples/softwareUpdateConfiguration/createSoftwareUpdateConfiguration.json
 */
async function createSoftwareUpdateConfiguration() {
  const subscriptionId =
    process.env["AUTOMATION_SUBSCRIPTION_ID"] || "51766542-3ed7-4a72-a187-0c8ab644ddab";
  const resourceGroupName = process.env["AUTOMATION_RESOURCE_GROUP"] || "mygroup";
  const automationAccountName = "myaccount";
  const softwareUpdateConfigurationName = "testpatch";
  const parameters = {
    scheduleInfo: {
      advancedSchedule: { weekDays: ["Monday", "Thursday"] },
      expiryTime: new Date("2018-11-09T11:22:57+00:00"),
      frequency: "Hour",
      interval: 1,
      startTime: new Date("2017-10-19T12:22:57+00:00"),
      timeZone: "America/Los_Angeles",
    },
    tasks: {
      postTask: { parameters: {}, source: "GetCache" },
      preTask: {
        parameters: { computername: "Computer1" },
        source: "HelloWorld",
      },
    },
    updateConfiguration: {
      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: {
        azureQueries: [
          {
            locations: ["Japan East", "UK South"],
            scope: [
              "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources",
              "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067",
            ],
            tagSettings: {
              filterOperator: "All",
              tags: {
                tag1: ["tag1Value1", "tag1Value2", "tag1Value3"],
                tag2: ["tag2Value1", "tag2Value2", "tag2Value3"],
              },
            },
          },
        ],
        nonAzureQueries: [
          { functionAlias: "SavedSearch1", workspaceId: "WorkspaceId1" },
          { functionAlias: "SavedSearch2", workspaceId: "WorkspaceId2" },
        ],
      },
      windows: {
        excludedKbNumbers: ["168934", "168973"],
        includedUpdateClassifications: "Critical",
        rebootSetting: "IfRequired",
      },
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new AutomationClient(credential, subscriptionId);
  const result = await client.softwareUpdateConfigurations.create(
    resourceGroupName,
    automationAccountName,
    softwareUpdateConfigurationName,
    parameters
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using System.Xml;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Automation.Models;
using Azure.ResourceManager.Automation;

// Generated from example definition: specification/automation/resource-manager/Microsoft.Automation/stable/2019-06-01/examples/softwareUpdateConfiguration/createSoftwareUpdateConfiguration.json
// this example is just showing the usage of "SoftwareUpdateConfigurations_Create" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this AutomationAccountResource created on azure
// for more information of creating AutomationAccountResource, please refer to the document of AutomationAccountResource
string subscriptionId = "51766542-3ed7-4a72-a187-0c8ab644ddab";
string resourceGroupName = "mygroup";
string automationAccountName = "myaccount";
ResourceIdentifier automationAccountResourceId = AutomationAccountResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, automationAccountName);
AutomationAccountResource automationAccount = client.GetAutomationAccountResource(automationAccountResourceId);

// get the collection of this SoftwareUpdateConfigurationResource
SoftwareUpdateConfigurationCollection collection = automationAccount.GetSoftwareUpdateConfigurations();

// invoke the operation
string softwareUpdateConfigurationName = "testpatch";
SoftwareUpdateConfigurationData data = new SoftwareUpdateConfigurationData(new SoftwareUpdateConfigurationSpecificProperties(SoftwareUpdateConfigurationOperatingSystemType.Windows)
{
    Windows = new WindowsUpdateConfigurationProperties
    {
        IncludedUpdateClassifications = WindowsUpdateClassification.Critical,
        ExcludedKBNumbers = { "168934", "168973" },
        RebootSetting = "IfRequired",
    },
    Duration = XmlConvert.ToTimeSpan("PT2H0M"),
    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" },
    NonAzureComputerNames = { "box1.contoso.com", "box2.contoso.com" },
    Targets = new SoftwareUpdateConfigurationTargetProperties
    {
        AzureQueries = {new AzureQueryProperties
        {
        Scope = {"/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067/resourceGroups/myresources", "/subscriptions/5ae68d89-69a4-454f-b5ce-e443cc4e0067"},
        Locations = {new AzureLocation("Japan East"), new AzureLocation("UK South")},
        TagSettings = new QueryTagSettingsProperties
        {
        Tags =
        {
        ["tag1"] = new string[]{"tag1Value1", "tag1Value2", "tag1Value3"},
        ["tag2"] = new string[]{"tag2Value1", "tag2Value2", "tag2Value3"}
        },
        FilterOperator = QueryTagOperator.All,
        },
        }},
        NonAzureQueries = {new NonAzureQueryProperties
        {
        FunctionAlias = "SavedSearch1",
        WorkspaceId = "WorkspaceId1",
        }, new NonAzureQueryProperties
        {
        FunctionAlias = "SavedSearch2",
        WorkspaceId = "WorkspaceId2",
        }},
    },
}, new SoftwareUpdateConfigurationScheduleProperties
{
    StartOn = DateTimeOffset.Parse("2017-10-19T12:22:57+00:00"),
    ExpireOn = DateTimeOffset.Parse("2018-11-09T11:22:57+00:00"),
    Interval = 1L,
    Frequency = AutomationScheduleFrequency.Hour,
    TimeZone = "America/Los_Angeles",
    AdvancedSchedule = new AutomationAdvancedSchedule
    {
        WeekDays = { "Monday", "Thursday" },
    },
})
{
    Tasks = new SoftwareUpdateConfigurationTasks
    {
        PreTask = new SoftwareUpdateConfigurationTaskProperties
        {
            Parameters =
            {
            ["COMPUTERNAME"] = "Computer1"
            },
            Source = "HelloWorld",
        },
        PostTask = new SoftwareUpdateConfigurationTaskProperties
        {
            Parameters = { },
            Source = "GetCache",
        },
    },
};
ArmOperation<SoftwareUpdateConfigurationResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, softwareUpdateConfigurationName, data);
SoftwareUpdateConfigurationResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SoftwareUpdateConfigurationData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Przykładowa odpowiedź

Kod stanu:

200

{
  "name": "testpatch",
  "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurations/testpatch",
  "properties": {
    "updateConfiguration": {
      "operatingSystem": "Windows",
      "windows": {
        "includedUpdateClassifications": "Critical",
        "excludedKbNumbers": [
          "168934",
          "168973"
        ]
      },
      "linux": {},
      "targets": {
        "azureQueries": [
          {
            "scope": [
              "/subscriptions/422b6c61-95b0-4213-b3be-7282315df71d/resourceGroups/a-stasku-rg0",
              "/subscriptions/422b6c61-95b0-4213-b3be-7282315df71d"
            ],
            "tagSettings": {
              "tags": {
                "tag1": [
                  "tag1Value1",
                  "tag1Value2"
                ],
                "tag2": [
                  "tag2Value1",
                  "tag2Value2"
                ]
              },
              "filterOperator": "All"
            },
            "locations": [
              "Japan East",
              "UK South"
            ]
          }
        ]
      },
      "duration": "PT2H",
      "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"
      ],
      "nonAzureComputerNames": [
        "box1.contoso.com",
        "box2.contoso.com"
      ]
    },
    "scheduleInfo": {
      "description": "",
      "startTime": "2017-10-19T12:22:00-07:00",
      "startTimeOffsetMinutes": -420,
      "expiryTime": "2018-11-09T11:22:00-08:00",
      "expiryTimeOffsetMinutes": -480,
      "isEnabled": true,
      "nextRun": "2017-10-19T12:22:00-07:00",
      "nextRunOffsetMinutes": -420,
      "interval": 1,
      "frequency": "Week",
      "creationTime": "2017-10-19T18:54:50.5233333+00:00",
      "lastModifiedTime": "2017-10-19T18:54:50.5233333+00:00",
      "timeZone": "America/Los_Angeles",
      "advancedSchedule": {}
    },
    "tasks": {
      "preTask": {
        "source": "HelloWorld",
        "parameters": {
          "COMPUTERNAME": "Computer1"
        }
      },
      "postTask": {
        "source": "GetCache",
        "parameters": null
      }
    },
    "provisioningState": "Provisioning",
    "error": {},
    "creationTime": "2017-10-19T18:54:50.5233333+00:00",
    "createdBy": "adam@contoso.com",
    "lastModifiedBy": "adam@contoso.com",
    "lastModifiedTime": "2017-10-19T18:54:50.68+00:00"
  }
}

Kod stanu:

201

{
  "name": "testpatch",
  "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurations/testpatch",
  "properties": {
    "updateConfiguration": {
      "operatingSystem": "Windows",
      "windows": {
        "includedUpdateClassifications": "Critical",
        "excludedKbNumbers": [
          "168934",
          "168973"
        ]
      },
      "linux": {},
      "targets": {
        "azureQueries": [
          {
            "scope": [
              "/subscriptions/422b6c61-95b0-4213-b3be-7282315df71d/resourceGroups/a-stasku-rg0",
              "/subscriptions/422b6c61-95b0-4213-b3be-7282315df71d"
            ],
            "tagSettings": {
              "tags": {
                "tag1": [
                  "tag1Value1",
                  "tag1Value2"
                ],
                "tag2": [
                  "tag2Value1",
                  "tag2Value2"
                ]
              },
              "filterOperator": "All"
            },
            "locations": [
              "Japan East",
              "UK South"
            ]
          }
        ]
      },
      "duration": "PT2H",
      "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"
      ],
      "nonAzureComputerNames": [
        "box1.contoso.com",
        "box2.contoso.com"
      ]
    },
    "scheduleInfo": {
      "description": "",
      "startTime": "2017-10-19T12:22:00-07:00",
      "startTimeOffsetMinutes": -420,
      "expiryTime": "2018-11-09T11:22:00-08:00",
      "expiryTimeOffsetMinutes": -480,
      "isEnabled": true,
      "nextRun": "2017-10-19T12:22:00-07:00",
      "nextRunOffsetMinutes": -420,
      "interval": 1,
      "frequency": "Week",
      "creationTime": "2017-10-19T18:54:50.5233333+00:00",
      "lastModifiedTime": "2017-10-19T18:54:50.5233333+00:00",
      "timeZone": "America/Los_Angeles"
    },
    "tasks": {
      "preTask": {
        "source": "HelloWorld",
        "parameters": {
          "COMPUTERNAME": "Computer1"
        }
      },
      "postTask": {
        "source": "GetCache",
        "parameters": null
      }
    },
    "provisioningState": "Provisioning",
    "error": {},
    "creationTime": "2017-10-19T18:54:50.5233333+00:00",
    "lastModifiedBy": "",
    "lastModifiedTime": "2017-10-19T18:54:50.68+00:00"
  }
}

Definicje

Nazwa	Opis
AdvancedSchedule	Właściwości tworzenia harmonogramu zaawansowanego.
AdvancedScheduleMonthlyOccurrence	Właściwości tworzenia zaawansowanego harmonogramu wystąpienia miesięcznego.
AzureQueryProperties	Zapytanie platformy Azure dotyczące konfiguracji aktualizacji.
ErrorResponse	Odpowiedź na błąd operacji
LinuxProperties	Konfiguracja aktualizacji specyficznej dla systemu Linux.
LinuxUpdateClasses	Klasyfikacje aktualizacji uwzględnione w konfiguracji aktualizacji oprogramowania.
NonAzureQueryProperties	Zapytanie spoza platformy Azure dotyczące konfiguracji aktualizacji.
OperatingSystemType	system operacyjny maszyn docelowych
ScheduleDay	Dzień wystąpienia. Musi być jednym z poniedziałku, wtorek, środa, czwartek, piątek, sobota, niedziela.
ScheduleFrequency	Pobiera lub ustawia częstotliwość harmonogramu.
softwareUpdateConfiguration	Właściwości konfiguracji aktualizacji oprogramowania.
softwareUpdateConfigurationTasks	Właściwości zadania konfiguracji aktualizacji oprogramowania.
SUCScheduleProperties	Definicja parametrów harmonogramu.
TagOperators	Filtruj maszyny wirtualne według dowolnych lub wszystkich określonych tagów.
TagSettingsProperties	Taguj informacje o filtrze maszyny wirtualnej.
TargetProperties	Grupuj określoną dla konfiguracji aktualizacji.
taskProperties	Właściwości zadania konfiguracji aktualizacji oprogramowania.
updateConfiguration	Zaktualizuj określone właściwości konfiguracji aktualizacji oprogramowania.
WindowsProperties	Konfiguracja aktualizacji specyficznej dla systemu Windows.
WindowsUpdateClasses	Klasyfikacja aktualizacji uwzględniona w konfiguracji aktualizacji oprogramowania. Ciąg rozdzielony przecinkami z wymaganymi wartościami

AdvancedSchedule

Objekt

Właściwości tworzenia harmonogramu zaawansowanego.

Nazwa	Typ	Opis
monthDays	integer[] (int32)	Dni miesiąca, w których zadanie powinno zostać wykonane. Musi należeć do przedziału od 1 do 31.
monthlyOccurrences	AdvancedScheduleMonthlyOccurrence[]	Wystąpienia dni w ciągu miesiąca.
weekDays	string[]	Dni tygodnia, w których zadanie powinno zostać wykonane.

AdvancedScheduleMonthlyOccurrence

Objekt

Właściwości tworzenia zaawansowanego harmonogramu wystąpienia miesięcznego.

Nazwa	Typ	Opis
day	ScheduleDay	Dzień wystąpienia. Musi być jednym z poniedziałku, wtorek, środa, czwartek, piątek, sobota, niedziela.
occurrence	integer (int32)	Wystąpienie tygodnia w ciągu miesiąca. Musi należeć do przedziału od 1 do 5

AzureQueryProperties

Objekt

Zapytanie platformy Azure dotyczące konfiguracji aktualizacji.

Nazwa	Typ	Opis
locations	string[]	Lista lokalizacji, do których ma być ograniczone zapytanie.
scope	string[]	Lista identyfikatorów usługi ARM subskrypcji lub grupy zasobów.
tagSettings	TagSettingsProperties	Ustawienia tagu dla maszyny wirtualnej.

ErrorResponse

Objekt

Odpowiedź na błąd operacji

Nazwa	Typ	Opis
code	string	Kod błędu
message	string	Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.

LinuxProperties

Objekt

Konfiguracja aktualizacji specyficznej dla systemu Linux.

Nazwa	Typ	Opis
excludedPackageNameMasks	string[]	pakiety wykluczone z konfiguracji aktualizacji oprogramowania.
includedPackageClassifications	LinuxUpdateClasses	Klasyfikacje aktualizacji uwzględnione w konfiguracji aktualizacji oprogramowania.
includedPackageNameMasks	string[]	pakiety dołączone do konfiguracji aktualizacji oprogramowania.
rebootSetting	string	Ustawienie ponownego uruchamiania konfiguracji aktualizacji oprogramowania.

LinuxUpdateClasses

Wyliczanie

Klasyfikacje aktualizacji uwzględnione w konfiguracji aktualizacji oprogramowania.

Wartość	Opis
Critical
Other
Security
Unclassified

NonAzureQueryProperties

Objekt

Zapytanie spoza platformy Azure dotyczące konfiguracji aktualizacji.

Nazwa	Typ	Opis
functionAlias	string	Zapisana nazwa wyszukiwania w usłudze Log Analytics.
workspaceId	string	Identyfikator obszaru roboczego usługi Log Analytics, w którym znajduje się zapisane wyszukiwanie.

OperatingSystemType

Wyliczanie

system operacyjny maszyn docelowych

Wartość	Opis
Linux
Windows

ScheduleDay

Wyliczanie

Dzień wystąpienia. Musi być jednym z poniedziałku, wtorek, środa, czwartek, piątek, sobota, niedziela.

Wartość	Opis
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

ScheduleFrequency

Wyliczanie

Pobiera lub ustawia częstotliwość harmonogramu.

Wartość	Opis
Day
Hour
Minute	Minimalny dozwolony interwał dla harmonogramów minut wynosi 15 minut.
Month
OneTime
Week

softwareUpdateConfiguration

Objekt

Właściwości konfiguracji aktualizacji oprogramowania.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.createdBy	string	Właściwość CreatedBy, która jest wyświetlana tylko w odpowiedzi.
properties.creationTime	string (date-time)	Czas utworzenia zasobu, który pojawia się tylko w odpowiedzi.
properties.error	ErrorResponse	Szczegóły błędu aprowizacji
properties.lastModifiedBy	string	Właściwość LastModifiedBy, która jest wyświetlana tylko w odpowiedzi.
properties.lastModifiedTime	string (date-time)	Czas ostatniej modyfikacji zasobu, który pojawia się tylko w odpowiedzi.
properties.provisioningState	string	Stan aprowizacji konfiguracji aktualizacji oprogramowania, który pojawia się tylko w odpowiedzi.
properties.scheduleInfo	SUCScheduleProperties	Informacje o harmonogramie konfiguracji aktualizacji oprogramowania
properties.tasks	softwareUpdateConfigurationTasks	Informacje o zadaniach konfiguracji aktualizacji oprogramowania.
properties.updateConfiguration	updateConfiguration	aktualizowanie określonych właściwości konfiguracji aktualizacji oprogramowania
type	string	Typ zasobu

softwareUpdateConfigurationTasks

Objekt

Właściwości zadania konfiguracji aktualizacji oprogramowania.

Nazwa	Typ	Opis
postTask	taskProperties	Opublikuj właściwości zadania.
preTask	taskProperties	Właściwości zadania wstępnego.

SUCScheduleProperties

Objekt

Definicja parametrów harmonogramu.

Nazwa	Typ	Domyślna wartość	Opis
advancedSchedule	AdvancedSchedule		Pobiera lub ustawia harmonogram zaawansowany.
creationTime	string (date-time)		Pobiera lub ustawia czas tworzenia.
description	string		Pobiera lub ustawia opis.
expiryTime	string (date-time)		Pobiera lub ustawia godzinę zakończenia harmonogramu.
expiryTimeOffsetMinutes	number (double)		Pobiera lub ustawia przesunięcie czasu wygaśnięcia w minutach.
frequency	ScheduleFrequency		Pobiera lub ustawia częstotliwość harmonogramu.
interval	integer (int64)		Pobiera lub ustawia interwał harmonogramu.
isEnabled	boolean	False	Pobiera lub ustawia wartość wskazującą, czy ten harmonogram jest włączony.
lastModifiedTime	string (date-time)		Pobiera lub ustawia czas ostatniej modyfikacji.
nextRun	string (date-time)		Pobiera lub ustawia następny czas wykonywania harmonogramu.
nextRunOffsetMinutes	number (double)		Pobiera lub ustawia przesunięcie następnego czasu wykonywania w minutach.
startTime	string (date-time)		Pobiera lub ustawia godzinę rozpoczęcia harmonogramu.
startTimeOffsetMinutes	number (double)		Pobiera przesunięcie czasu rozpoczęcia w minutach.
timeZone	string		Pobiera lub ustawia strefę czasową harmonogramu.

TagOperators

Wyliczanie

Filtruj maszyny wirtualne według dowolnych lub wszystkich określonych tagów.

Wartość	Opis
All
Any

TagSettingsProperties

Objekt

Taguj informacje o filtrze maszyny wirtualnej.

Nazwa	Typ	Opis
filterOperator	TagOperators	Filtruj maszyny wirtualne według dowolnych lub wszystkich określonych tagów.
tags	object	Słownik tagów z listą wartości.

TargetProperties

Objekt

Grupuj określoną dla konfiguracji aktualizacji.

Nazwa	Typ	Opis
azureQueries	AzureQueryProperties[]	Lista zapytań platformy Azure w konfiguracji aktualizacji oprogramowania.
nonAzureQueries	NonAzureQueryProperties[]	Lista zapytań spoza platformy Azure w konfiguracji aktualizacji oprogramowania.

taskProperties

Objekt

Właściwości zadania konfiguracji aktualizacji oprogramowania.

Nazwa	Typ	Opis
parameters	object	Pobiera lub ustawia parametry zadania.
source	string	Pobiera lub ustawia nazwę elementu Runbook.

updateConfiguration

Objekt

Zaktualizuj określone właściwości konfiguracji aktualizacji oprogramowania.

Nazwa	Typ	Opis
azureVirtualMachines	string[]	Lista identyfikatorów zasobów platformy Azure dla maszyn wirtualnych platformy Azure objętych konfiguracją aktualizacji oprogramowania.
duration	string (duration)	Maksymalny dozwolony czas uruchamiania konfiguracji aktualizacji oprogramowania. Czas trwania należy określić przy użyciu formatu PT[n]H[n]M[n]S zgodnie z ISO8601
linux	LinuxProperties	Konfiguracja aktualizacji specyficznej dla systemu Linux.
nonAzureComputerNames	string[]	Lista nazw maszyn spoza platformy Azure objętych konfiguracją aktualizacji oprogramowania.
operatingSystem	OperatingSystemType	system operacyjny maszyn docelowych
targets	TargetProperties	Grupuj elementy docelowe konfiguracji aktualizacji oprogramowania.
windows	WindowsProperties	Konfiguracja aktualizacji specyficznej dla systemu Windows.

WindowsProperties

Objekt

Konfiguracja aktualizacji specyficznej dla systemu Windows.

Nazwa	Typ	Opis
excludedKbNumbers	string[]	Numery KB wykluczone z konfiguracji aktualizacji oprogramowania.
includedKbNumbers	string[]	Numery KB zawarte w konfiguracji aktualizacji oprogramowania.
includedUpdateClassifications	WindowsUpdateClasses	Klasyfikacja aktualizacji uwzględniona w konfiguracji aktualizacji oprogramowania. Ciąg rozdzielony przecinkami z wymaganymi wartościami
rebootSetting	string	Ustawienie ponownego uruchamiania konfiguracji aktualizacji oprogramowania.

WindowsUpdateClasses

Wyliczanie

Klasyfikacja aktualizacji uwzględniona w konfiguracji aktualizacji oprogramowania. Ciąg rozdzielony przecinkami z wymaganymi wartościami

Wartość	Opis
Critical
Definition
FeaturePack
Security
ServicePack
Tools
Unclassified
UpdateRollup
Updates