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

Naam van een Azure-resourcegroep.

Regex-patroon: ^[-\w\._]+$

subscriptionId
path True

string

Hiermee worden abonnementsreferenties opgehaald waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke service-aanroep.

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

Retourneert een lijst 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 software-updates.

NonAzureQueryProperties

Niet-Azure-query voor de updateconfiguratie.

OperatingSystemType

besturingssysteem van doelmachines

ScheduleFrequency

Hiermee wordt de frequentie van de planning opgehaald of ingesteld.

softwareUpdateConfigurationCollectionItem

Eigenschappen van software-updateconfiguratieverzamelingsitems.

softwareUpdateConfigurationListResult

resultaat van het weergeven van alle software-updateconfiguraties

softwareUpdateConfigurationTasks

Taakeigenschappen van de configuratie van de software-update.

TagOperators

Vm's filteren op alle of alle opgegeven tags.

TagSettingsProperties

Informatie over tagfilters voor de VM.

TargetProperties

Groep die specifiek is voor de updateconfiguratie.

taskProperties

Taakeigenschappen van de configuratie van de software-update.

updateConfiguration

Specifieke eigenschappen van de software-updateconfiguratie bijwerken.

WindowsProperties

Windows-specifieke updateconfiguratie.

WindowsUpdateClasses

Updateclassificatie opgenomen in de configuratie van software-updates. 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

Taginstellingen voor de VM.

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 software-updates.

includedPackageClassifications

LinuxUpdateClasses

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

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 software-updates.

Name Type Description
Critical

string

Other

string

Security

string

Unclassified

string

NonAzureQueryProperties

Niet-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 zich bevindt.

OperatingSystemType

besturingssysteem van doelmachines

Name Type Description
Linux

string

Windows

string

ScheduleFrequency

Hiermee wordt de frequentie van de planning opgehaald of ingesteld.

Name Type Description
Day

string

Hour

string

Minute

string

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

Month

string

OneTime

string

Week

string

softwareUpdateConfigurationCollectionItem

Eigenschappen van software-updateconfiguratieverzamelingsitems.

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

Aanmaaktijd van de software-updateconfiguratie, die alleen wordt weergegeven in het antwoord.

properties.frequency

ScheduleFrequency

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

properties.lastModifiedTime

string

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

properties.nextRun

string

ext uitvoeringstijd van de update.

properties.provisioningState

string

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

properties.startTime

string

de begintijd van de update.

properties.tasks

softwareUpdateConfigurationTasks

Taken vooraf en na gedefinieerd

properties.updateConfiguration

updateConfiguration

Specifieke eigenschappen van de software-updateconfiguratie bijwerken.

softwareUpdateConfigurationListResult

resultaat van het weergeven van alle software-updateconfiguraties

Name Type Description
value

softwareUpdateConfigurationCollectionItem[]

buitenste 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 posttaak.

preTask

taskProperties

Eigenschappen vóór taak.

TagOperators

Vm's filteren op alle of alle opgegeven tags.

Name Type Description
All

string

Any

string

TagSettingsProperties

Informatie over tagfilters voor de VM.

Name Type Description
filterOperator

TagOperators

Vm's filteren op alle of alle opgegeven tags.

tags

object

Woordenlijst met tags met de bijbehorende 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 software-updates.

nonAzureQueries

NonAzureQueryProperties[]

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

taskProperties

Taakeigenschappen van de configuratie van de software-update.

Name Type Description
parameters

object

Hiermee worden de parameters van de taak opgehaald of ingesteld.

source

string

Hiermee wordt de naam van het runbook opgehaald of ingesteld.

updateConfiguration

Specifieke eigenschappen van de software-updateconfiguratie bijwerken.

Name Type Description
azureVirtualMachines

string[]

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

duration

string

Maximale tijd die is toegestaan voor het uitvoeren van de software-updateconfiguratie. De duur moet worden opgegeven met de notatie 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 software-updateconfiguratie 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 software-updateconfiguratie.

includedKbNumbers

string[]

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

includedUpdateClassifications

WindowsUpdateClasses

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

rebootSetting

string

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

WindowsUpdateClasses

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

Name Type Description
Critical

string

Definition

string

FeaturePack

string

Security

string

ServicePack

string

Tools

string

Unclassified

string

UpdateRollup

string

Updates

string