Delen via


Software Update Configurations - Create

Maak een nieuwe configuratie voor software-updates met de naam die is opgegeven in de URI.

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

URI-parameters

Name In Vereist Type Description
automationAccountName
path True

string

De naam van het Automation-account.

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._]+$

Naam van een Azure-resourcegroep.

softwareUpdateConfigurationName
path True

string

De naam van de software-updateconfiguratie die moet worden gemaakt.

subscriptionId
path True

string

Hiermee haalt u abonnementsreferenties op die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.

api-version
query True

string

Client-API-versie.

Aanvraagkoptekst

Name Vereist Type Description
clientRequestId

string

Identificeert deze specifieke clientaanvraag.

Aanvraagbody

Name Vereist Type Description
properties.scheduleInfo True

SUCScheduleProperties

Informatie plannen voor de configuratie van software-updates

properties.updateConfiguration True

updateConfiguration

specifieke eigenschappen voor de software-updateconfiguratie bijwerken

properties.error

ErrorResponse

Details van inrichtingsfout

properties.tasks

softwareUpdateConfigurationTasks

Informatie over taken voor de configuratie van software-updates.

Antwoorden

Name Type Description
200 OK

softwareUpdateConfiguration

Configuratie van software-updates met dezelfde naam en eigenschappen bestaat al.

201 Created

softwareUpdateConfiguration

De configuratie van software-updates wordt gemaakt.

Other Status Codes

ErrorResponse

Automatiseringsfoutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Create software update configuration

Voorbeeldaanvraag

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
      }
    }
  }
}

Voorbeeldrespons

{
  "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"
  }
}
{
  "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"
  }
}

Definities

Name Description
AdvancedSchedule

De eigenschappen van het geavanceerde schema maken.

AdvancedScheduleMonthlyOccurrence

De eigenschappen van het maken van een maandelijks exemplaar van een geavanceerd schema.

AzureQueryProperties

Azure-query voor de updateconfiguratie.

ErrorResponse

Foutreactie van een bewerkingsfout

LinuxProperties

Linux-specifieke updateconfiguratie.

LinuxUpdateClasses

Updateclassificaties die zijn opgenomen in de configuratie van de software-update.

NonAzureQueryProperties

Geen Azure-query voor de updateconfiguratie.

OperatingSystemType

besturingssysteem van doelmachines

ScheduleDay

Dag van de gebeurtenis. Moet een van de maandag, dinsdag, woensdag, donderdag, vrijdag, zaterdag, zondag zijn.

ScheduleFrequency

Hiermee haalt u de frequentie van het schema op of stelt u deze in.

softwareUpdateConfiguration

Configuratie-eigenschappen van software-updates.

softwareUpdateConfigurationTasks

Taakeigenschappen van de configuratie van de software-update.

SUCScheduleProperties

Definitie van planningsparameters.

TagOperators

Filter VM's op alle opgegeven tags of alle opgegeven tags.

TagSettingsProperties

Labelfilterinformatie voor de VIRTUELE machine.

TargetProperties

Groep die specifiek is voor de updateconfiguratie.

taskProperties

Taakeigenschappen van de configuratie van de software-update.

updateConfiguration

Werk specifieke eigenschappen van de configuratie van de software-update bij.

WindowsProperties

Windows-specifieke updateconfiguratie.

WindowsUpdateClasses

Updateclassificatie die is opgenomen in de configuratie van de software-update. Een door komma's gescheiden tekenreeks met vereiste waarden

AdvancedSchedule

De eigenschappen van het geavanceerde schema maken.

Name Type Description
monthDays

integer[] (int32)

Dagen van de maand waarop de taak moet worden uitgevoerd. Moet tussen 1 en 31 zijn.

monthlyOccurrences

AdvancedScheduleMonthlyOccurrence[]

Exemplaren van dagen binnen een maand.

weekDays

string[]

Dagen van de week waarop de taak moet worden uitgevoerd.

AdvancedScheduleMonthlyOccurrence

De eigenschappen van het maken van een maandelijks exemplaar van een geavanceerd schema.

Name Type Description
day

ScheduleDay

Dag van de gebeurtenis. Moet een van de maandag, dinsdag, woensdag, donderdag, vrijdag, zaterdag, zondag zijn.

occurrence

integer (int32)

Exemplaar van de week binnen de maand. Moet tussen 1 en 5 zijn

AzureQueryProperties

Azure-query voor de updateconfiguratie.

Name Type Description
locations

string[]

Lijst met locaties voor het bereik van de query.

scope

string[]

Lijst met ARM-id's voor abonnement of resourcegroep.

tagSettings

TagSettingsProperties

Tag-instellingen voor de virtuele machine.

ErrorResponse

Foutreactie van een bewerkingsfout

Name Type Description
code

string

Foutcode

message

string

Foutbericht dat aangeeft waarom de bewerking is mislukt.

LinuxProperties

Linux-specifieke updateconfiguratie.

Name Type Description
excludedPackageNameMasks

string[]

pakketten die zijn uitgesloten van de configuratie van de software-update.

includedPackageClassifications

LinuxUpdateClasses

Updateclassificaties die zijn opgenomen in de configuratie van de software-update.

includedPackageNameMasks

string[]

pakketten die zijn opgenomen in de configuratie van de software-update.

rebootSetting

string

Instelling voor opnieuw opstarten voor de configuratie van de software-update.

LinuxUpdateClasses

Updateclassificaties die zijn opgenomen in de configuratie van de software-update.

Waarde Description
Critical
Other
Security
Unclassified

NonAzureQueryProperties

Geen Azure-query voor de updateconfiguratie.

Name Type Description
functionAlias

string

Naam van opgeslagen zoekopdracht in Log Analytics.

workspaceId

string

Werkruimte-id voor Log Analytics waarin de opgeslagen zoekopdracht is opgeslagen.

OperatingSystemType

besturingssysteem van doelmachines

Waarde Description
Linux
Windows

ScheduleDay

Dag van de gebeurtenis. Moet een van de maandag, dinsdag, woensdag, donderdag, vrijdag, zaterdag, zondag zijn.

Waarde Description
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

ScheduleFrequency

Hiermee haalt u de frequentie van het schema op of stelt u deze in.

Waarde Description
Day
Hour
Minute

Het minimaal toegestane interval voor minutenschema's is 15 minuten.

Month
OneTime
Week

softwareUpdateConfiguration

Configuratie-eigenschappen van software-updates.

Name Type Description
id

string

Resource-id.

name

string

Resourcenaam.

properties.createdBy

string

De eigenschap CreatedBy, die alleen in het antwoord wordt weergegeven.

properties.creationTime

string (date-time)

Maaktijd van de resource, die alleen in het antwoord wordt weergegeven.

properties.error

ErrorResponse

Details van inrichtingsfout

properties.lastModifiedBy

string

De eigenschap LastModifiedBy, die alleen in het antwoord wordt weergegeven.

properties.lastModifiedTime

string (date-time)

De laatste keer dat de resource is gewijzigd, wordt deze alleen weergegeven in het antwoord.

properties.provisioningState

string

Inrichtingsstatus voor de configuratie van de software-update, die alleen in het antwoord wordt weergegeven.

properties.scheduleInfo

SUCScheduleProperties

Informatie plannen voor de configuratie van software-updates

properties.tasks

softwareUpdateConfigurationTasks

Informatie over taken voor de configuratie van software-updates.

properties.updateConfiguration

updateConfiguration

specifieke eigenschappen voor de software-updateconfiguratie bijwerken

type

string

Resourcetype

softwareUpdateConfigurationTasks

Taakeigenschappen van de configuratie van de software-update.

Name Type Description
postTask

taskProperties

Eigenschappen van taak posten.

preTask

taskProperties

Eigenschappen van de pre-taak.

SUCScheduleProperties

Definitie van planningsparameters.

Name Type Default value Description
advancedSchedule

AdvancedSchedule

Hiermee haalt u de geavanceerde planning op of stelt u deze in.

creationTime

string (date-time)

Hiermee haalt u de aanmaaktijd op of stelt u deze in.

description

string

Hiermee haalt u de beschrijving op of stelt u deze in.

expiryTime

string (date-time)

Hiermee haalt u de eindtijd van de planning op of stelt u deze in.

expiryTimeOffsetMinutes

number (double)

Hiermee haalt u de verschuiving van de verlooptijd in minuten op of stelt u deze in.

frequency

ScheduleFrequency

Hiermee haalt u de frequentie van het schema op of stelt u deze in.

interval

integer (int64)

Hiermee haalt u het interval van de planning op of stelt u deze in.

isEnabled

boolean

False

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of deze planning is ingeschakeld.

lastModifiedTime

string (date-time)

Hiermee haalt u de laatst gewijzigde tijd op of stelt u deze in.

nextRun

string (date-time)

Hiermee haalt u de volgende uitvoeringstijd van de planning op of stelt u deze in.

nextRunOffsetMinutes

number (double)

Hiermee wordt de verschuiving van de volgende uitvoeringstijd in minuten op of ingesteld.

startTime

string (date-time)

Hiermee haalt u de begintijd van de planning op of stelt u deze in.

startTimeOffsetMinutes

number (double)

Hiermee wordt de verschuiving van de begintijd in minuten opgeslagen.

timeZone

string

Hiermee haalt u de tijdzone van de planning op of stelt u deze in.

TagOperators

Filter VM's op alle opgegeven tags of alle opgegeven tags.

Waarde Description
All
Any

TagSettingsProperties

Labelfilterinformatie voor de VIRTUELE machine.

Name Type Description
filterOperator

TagOperators

Filter VM's op alle opgegeven tags of alle opgegeven tags.

tags

object

Woordenlijst met tags met de lijst met waarden.

TargetProperties

Groep die specifiek is voor de updateconfiguratie.

Name Type Description
azureQueries

AzureQueryProperties[]

Lijst met Azure-query's in de configuratie van de software-update.

nonAzureQueries

NonAzureQueryProperties[]

Lijst met niet-Azure-query's in de configuratie van de software-update.

taskProperties

Taakeigenschappen van de configuratie van de software-update.

Name Type Description
parameters

object

Hiermee haalt u de parameters van de taak op of stelt u deze in.

source

string

Hiermee haalt u de naam van het runbook op of stelt u deze in.

updateConfiguration

Werk specifieke eigenschappen van de configuratie van de software-update bij.

Name Type Description
azureVirtualMachines

string[]

Lijst met azure-resource-id's voor virtuele Azure-machines waarop de configuratie van de software-update is gericht.

duration

string (duration)

Maximale tijd die is toegestaan voor de uitvoering van de configuratie van de software-update. De duur moet worden opgegeven met de indeling PT[n]H[n]M[n]S volgens ISO8601

linux

LinuxProperties

Linux-specifieke updateconfiguratie.

nonAzureComputerNames

string[]

Lijst met namen van niet-Azure-machines waarop de configuratie van de software-update is gericht.

operatingSystem

OperatingSystemType

besturingssysteem van doelmachines

targets

TargetProperties

Groepsdoelen voor de configuratie van software-updates.

windows

WindowsProperties

Windows-specifieke updateconfiguratie.

WindowsProperties

Windows-specifieke updateconfiguratie.

Name Type Description
excludedKbNumbers

string[]

KB-nummers die zijn uitgesloten van de configuratie van de software-update.

includedKbNumbers

string[]

KB-nummers die zijn opgenomen in de configuratie van de software-update.

includedUpdateClassifications

WindowsUpdateClasses

Updateclassificatie die is opgenomen in de configuratie van de software-update. Een door komma's gescheiden tekenreeks met vereiste waarden

rebootSetting

string

Instelling voor opnieuw opstarten voor de configuratie van de software-update.

WindowsUpdateClasses

Updateclassificatie die is opgenomen in de configuratie van de software-update. Een door komma's gescheiden tekenreeks met vereiste waarden

Waarde Description
Critical
Definition
FeaturePack
Security
ServicePack
Tools
Unclassified
UpdateRollup
Updates