Delen via


Software Update Configurations - List

Alle software-updateconfiguraties voor het account ophalen.

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

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.

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.

$filter
query

string

Het filter dat moet worden toegepast op de bewerking.

Aanvraagkoptekst

Name Vereist Type Description
clientRequestId

string

Identificeert deze specifieke clientaanvraag.

Antwoorden

Name Type Description
200 OK

softwareUpdateConfigurationListResult

Retourlijst met software-updateconfiguraties.

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

List software update configurations
List software update configurations Targeting a specific azure virtual machine

List software update configurations

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurations?api-version=2019-06-01

Voorbeeldrespons

{
  "value": [
    {
      "name": "testpatch-01",
      "id": "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/Mo-Resources-WCUS/providers/Microsoft.Automation/automationAccounts/Mo-AAA-WCUS/softwareUpdateConfigurations/testpatch-01",
      "properties": {
        "updateConfiguration": {
          "operatingSystem": "Windows",
          "windows": {
            "includedUpdateClassifications": "Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools, Updates",
            "excludedKbNumbers": null
          },
          "linux": null,
          "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": null
              }
            ]
          },
          "duration": "PT2H",
          "azureVirtualMachines": [
            "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01",
            "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02",
            "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03"
          ],
          "nonAzureComputerNames": null
        },
        "tasks": {
          "preTask": {
            "source": "HelloWorld",
            "parameters": {
              "COMPUTERNAME": "Computer1"
            }
          },
          "postTask": {
            "source": "GetCache",
            "parameters": null
          }
        },
        "frequency": "Week",
        "startTime": "2017-10-19T12:22:00-07:00",
        "creationTime": "2017-10-19T18:54:50.5233333+00:00",
        "lastModifiedTime": "2017-10-19T18:54:50.68+00:00",
        "provisioningState": "Succeeded",
        "nextRun": "2017-10-23T12:22:00-07:00"
      }
    },
    {
      "name": "testpatch-02",
      "id": "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/Mo-Resources-WCUS/providers/Microsoft.Automation/automationAccounts/Mo-AAA-WCUS/softwareUpdateConfigurations/testpatch-02",
      "properties": {
        "updateConfiguration": {
          "operatingSystem": "Windows",
          "windows": {
            "includedUpdateClassifications": "Critical, FeaturePack",
            "excludedKbNumbers": null
          },
          "linux": null,
          "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": "PT2H30M",
          "azureVirtualMachines": [
            "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-04",
            "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-05",
            "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-06"
          ],
          "nonAzureComputerNames": null
        },
        "tasks": {
          "preTask": {
            "source": "HelloWorld",
            "parameters": {
              "COMPUTERNAME": "Computer1"
            }
          },
          "postTask": {
            "source": "GetCache",
            "parameters": null
          }
        },
        "frequency": "Hour",
        "startTime": "2018-05-05T12:26:00-07:00",
        "creationTime": "2017-08-11T21:52:02.7733333+00:00",
        "lastModifiedTime": "2017-08-11T21:52:22.88+00:00",
        "provisioningState": "Succeeded",
        "nextRun": "2018-05-05T12:26:00-07:00"
      }
    }
  ]
}

List software update configurations Targeting a specific azure virtual machine

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/myaccount/softwareUpdateConfigurations?api-version=2019-06-01&$filter=properties/updateConfiguration/azureVirtualMachines/any(m: m eq '/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01')

Voorbeeldrespons

{
  "value": [
    {
      "name": "testpatch-01",
      "id": "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/Mo-Resources-WCUS/providers/Microsoft.Automation/automationAccounts/Mo-AAA-WCUS/softwareUpdateConfigurations/testpatch-01",
      "properties": {
        "updateConfiguration": {
          "operatingSystem": "Windows",
          "windows": {
            "includedUpdateClassifications": "Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools, Updates",
            "excludedKbNumbers": null
          },
          "linux": null,
          "duration": "PT2H",
          "azureVirtualMachines": [
            "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01",
            "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-02",
            "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-03"
          ],
          "nonAzureComputerNames": null
        },
        "tasks": {
          "preTask": {
            "source": "HelloWorld",
            "parameters": {
              "COMPUTERNAME": "Computer1"
            }
          },
          "postTask": {
            "source": "GetCache",
            "parameters": null
          }
        },
        "frequency": "Week",
        "startTime": "2017-10-19T12:22:00-07:00",
        "creationTime": "2017-10-19T18:54:50.5233333+00:00",
        "lastModifiedTime": "2017-10-19T18:54:50.68+00:00",
        "provisioningState": "Succeeded",
        "nextRun": "2017-10-23T12:22:00-07:00"
      }
    },
    {
      "name": "testpatch-02",
      "id": "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/Mo-Resources-WCUS/providers/Microsoft.Automation/automationAccounts/Mo-AAA-WCUS/softwareUpdateConfigurations/testpatch-02",
      "properties": {
        "updateConfiguration": {
          "operatingSystem": "Windows",
          "windows": {
            "includedUpdateClassifications": "Critical, FeaturePack",
            "excludedKbNumbers": null
          },
          "linux": null,
          "duration": "PT2H30M",
          "azureVirtualMachines": [
            "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-01",
            "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-05",
            "/subscriptions/1a7d4044-286c-4acb-969a-96639265bf2e/resourceGroups/myresources/providers/Microsoft.Compute/virtualMachines/vm-06"
          ],
          "nonAzureComputerNames": null
        },
        "tasks": {
          "preTask": {
            "source": "HelloWorld",
            "parameters": {
              "COMPUTERNAME": "Computer1"
            }
          },
          "postTask": {
            "source": "GetCache",
            "parameters": null
          }
        },
        "frequency": "Hour",
        "startTime": "2018-05-05T12:26:00-07:00",
        "creationTime": "2017-08-11T21:52:02.7733333+00:00",
        "lastModifiedTime": "2017-08-11T21:52:22.88+00:00",
        "provisioningState": "Succeeded",
        "nextRun": "2018-05-05T12:26:00-07:00"
      }
    }
  ]
}

Definities

Name Description
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

ScheduleFrequency

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

softwareUpdateConfigurationCollectionItem

Eigenschappen van configuratieverzamelingsitem voor software-updates.

softwareUpdateConfigurationListResult

resultaat van het weergeven van alle configuratie van software-updates

softwareUpdateConfigurationTasks

Taakeigenschappen van de configuratie van de software-update.

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

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

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

softwareUpdateConfigurationCollectionItem

Eigenschappen van configuratieverzamelingsitem voor software-updates.

Name Type Description
id

string

Resource-id van de configuratie van de software-update

name

string

Naam van de configuratie van de software-update.

properties.creationTime

string (date-time)

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

properties.frequency

ScheduleFrequency

uitvoeringsfrequentie van de planning die is gekoppeld aan de configuratie van de software-update

properties.lastModifiedTime

string (date-time)

De laatste keer dat de configuratie van software-updates is gewijzigd, wordt deze alleen weergegeven in het antwoord.

properties.nextRun

string (date-time)

ext runtime van de update.

properties.provisioningState

string

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

properties.startTime

string (date-time)

de begintijd van de update.

properties.tasks

softwareUpdateConfigurationTasks

Vooraf en na taken gedefinieerd

properties.updateConfiguration

updateConfiguration

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

softwareUpdateConfigurationListResult

resultaat van het weergeven van alle configuratie van software-updates

Name Type Description
value

softwareUpdateConfigurationCollectionItem[]

outer object geretourneerd bij het weergeven van alle software-updateconfiguraties

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.

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