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 |
---|---|---|---|---|
automation
|
path | True |
string |
De naam van het Automation-account. |
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._]+$ |
Naam van een Azure-resourcegroep. |
software
|
path | True |
string |
De naam van de software-updateconfiguratie die moet worden gemaakt. |
subscription
|
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 |
Informatie plannen voor de configuratie van software-updates |
|
properties.updateConfiguration | True |
specifieke eigenschappen voor de software-updateconfiguratie bijwerken |
|
properties.error |
Details van inrichtingsfout |
||
properties.tasks |
Informatie over taken voor de configuratie van software-updates. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
Configuratie van software-updates met dezelfde naam en eigenschappen bestaat al. |
|
201 Created |
De configuratie van software-updates wordt gemaakt. |
|
Other Status Codes |
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 |
---|---|
Advanced |
De eigenschappen van het geavanceerde schema maken. |
Advanced |
De eigenschappen van het maken van een maandelijks exemplaar van een geavanceerd schema. |
Azure |
Azure-query voor de updateconfiguratie. |
Error |
Foutreactie van een bewerkingsfout |
Linux |
Linux-specifieke updateconfiguratie. |
Linux |
Updateclassificaties die zijn opgenomen in de configuratie van de software-update. |
Non |
Geen Azure-query voor de updateconfiguratie. |
Operating |
besturingssysteem van doelmachines |
Schedule |
Dag van de gebeurtenis. Moet een van de maandag, dinsdag, woensdag, donderdag, vrijdag, zaterdag, zondag zijn. |
Schedule |
Hiermee haalt u de frequentie van het schema op of stelt u deze in. |
software |
Configuratie-eigenschappen van software-updates. |
software |
Taakeigenschappen van de configuratie van de software-update. |
SUCSchedule |
Definitie van planningsparameters. |
Tag |
Filter VM's op alle opgegeven tags of alle opgegeven tags. |
Tag |
Labelfilterinformatie voor de VIRTUELE machine. |
Target |
Groep die specifiek is voor de updateconfiguratie. |
task |
Taakeigenschappen van de configuratie van de software-update. |
update |
Werk specifieke eigenschappen van de configuratie van de software-update bij. |
Windows |
Windows-specifieke updateconfiguratie. |
Windows |
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 |
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 |
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 |
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 |
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 |
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 |
Informatie plannen voor de configuratie van software-updates |
|
properties.tasks |
Informatie over taken voor de configuratie van software-updates. |
|
properties.updateConfiguration |
specifieke eigenschappen voor de software-updateconfiguratie bijwerken |
|
type |
string |
Resourcetype |
softwareUpdateConfigurationTasks
Taakeigenschappen van de configuratie van de software-update.
Name | Type | Description |
---|---|---|
postTask |
Eigenschappen van taak posten. |
|
preTask |
Eigenschappen van de pre-taak. |
SUCScheduleProperties
Definitie van planningsparameters.
Name | Type | Default value | Description |
---|---|---|---|
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 |
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 |
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 |
Lijst met Azure-query's in de configuratie van de software-update. |
|
nonAzureQueries |
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 |
Linux-specifieke updateconfiguratie. |
|
nonAzureComputerNames |
string[] |
Lijst met namen van niet-Azure-machines waarop de configuratie van de software-update is gericht. |
operatingSystem |
besturingssysteem van doelmachines |
|
targets |
Groepsdoelen voor de configuratie van software-updates. |
|
windows |
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 |
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 |