Delen via


Microsoft.Onderhoud onderhoudConfiguraties

Bicep-resourcedefinitie

Het resourcetype maintenanceConfigurations kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Formaat van de bron

Als u een Resource Microsoft.Maintenance/maintenanceConfigurations wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

resource symbolicname 'Microsoft.Maintenance/maintenanceConfigurations@2023-10-01-preview' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    extensionProperties: {
      {customized property}: 'string'
    }
    installPatches: {
      linuxParameters: {
        classificationsToInclude: [
          'string'
        ]
        packageNameMasksToExclude: [
          'string'
        ]
        packageNameMasksToInclude: [
          'string'
        ]
      }
      rebootSetting: 'string'
      windowsParameters: {
        classificationsToInclude: [
          'string'
        ]
        excludeKbsRequiringReboot: bool
        kbNumbersToExclude: [
          'string'
        ]
        kbNumbersToInclude: [
          'string'
        ]
      }
    }
    maintenanceScope: 'string'
    maintenanceWindow: {
      duration: 'string'
      expirationDateTime: 'string'
      recurEvery: 'string'
      startDateTime: 'string'
      timeZone: 'string'
    }
    namespace: 'string'
    visibility: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Eigenschapswaarden

Microsoft.Maintenance/maintenanceConfigurations

Name Description Value
location Hiermee haalt u de locatie van de resource op of stelt u deze in string
name De resourcenaam Touwtje (verplicht)
properties Eigenschappen van de resource ophalen of instellen MaintenanceConfigurationProperties
omvang Gebruik deze functie bij het maken van een resource in een bereik dat anders is dan het implementatiebereik. Stel deze eigenschap in op de symbolische naam van een resource om de extensieresource toe te passen.
tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen

InputLinuxParameters

Name Description Value
classificationsToInclude Classificatiecategorie van patches die moeten worden gepatcht. Toegestane waarden zijn Kritiek, Beveiliging en Overige. string[]
packageNameMasksToExclude Pakketnamen die moeten worden uitgesloten voor patching. string[]
packageNameMasksToInclude Pakketnamen die moeten worden opgenomen voor patching. string[]

InputPatchConfiguration

Name Description Value
linuxParameters Invoerparameters die specifiek zijn voor het patchen van linux-machines. Geef deze eigenschap niet door voor Windows-computers. InputLinuxParameters
rebootSetting Mogelijke voorkeur voor opnieuw opstarten zoals gedefinieerd door de gebruiker op basis waarvan wordt besloten de computer opnieuw op te starten of niet nadat de patchbewerking is voltooid. 'Always'
'IfRequired'
'Never'
windowsParameters Invoerparameters die specifiek zijn voor het patchen van een Windows-computer. Geef deze eigenschap niet door voor Linux-machines. InputWindowsParameters

InputWindowsParameters

Name Description Value
classificationsToInclude Classificatiecategorie van patches die moeten worden gepatcht. Toegestane waarden zijn 'Kritiek', 'Beveiliging', 'UpdateRollup', 'FeaturePack', 'ServicePack', 'Definitie', 'Hulpprogramma's' en 'Updates'. string[]
excludeKbsRequiringReboot Patches uitsluiten die opnieuw moeten worden opgestart bool
kbNumbersToExclude Windows KBID die moet worden uitgesloten voor patching. string[]
kbNumbersToInclude Windows KBID moet worden opgenomen voor patching. string[]

MaintenanceConfigurationProperties

Name Description Value
extensionProperties Hiermee haalt u extensionProperties van de maintenanceConfiguration op of stelt u deze in MaintenanceConfigurationPropertiesExtensionProperties
installPatches De invoerparameters die moeten worden doorgegeven aan de patchuitvoeringsbewerking. InputPatchConfiguration
maintenanceScope Hiermee haalt u maintenanceScope van de configuratie op of stelt u deze in 'Extension'
'Host'
'InGuestPatch'
'OSImage'
'Resource'
'SQLDB'
'SQLManagedInstance'
maintenanceWindow Definitie van een MaintenanceWindow MaintenanceWindow
namespace Hiermee haalt u de naamruimte van de resource op of stelt u deze in string
visibility Hiermee haalt u de zichtbaarheid van de configuratie op of stelt u deze in. De standaardwaarde is 'Aangepast' 'Custom'
'Public'

MaintenanceConfigurationPropertiesExtensionProperties

Name Description Value

MaintenanceConfigurationTags

Name Description Value

MaintenanceWindow

Name Description Value
duration Duur van het onderhoudsvenster in HH:mm-formaat. Indien niet opgegeven, wordt de standaardwaarde gebruikt op basis van het opgegeven onderhoudsbereik. Voorbeeld: 05:00. string
expirationDateTime Effectieve vervaldatum van het onderhoudsvenster in JJJJ-MM-DD uu:mm-notatie. Het venster wordt gemaakt in de opgegeven tijdzone en aangepast aan zomertijd op basis van die tijdzone. De vervaldatum moet worden ingesteld op een toekomstige datum. Indien niet opgegeven, wordt deze ingesteld op de maximale datum/tijd 9999-12-31 23:59:59. string
recurEvery Snelheid waarmee een onderhoudsvenster naar verwachting opnieuw zal optreden. Het tarief kan worden uitgedrukt als dagelijkse, wekelijkse of maandelijkse schema's. De dagelijkse planning wordt opgemaakt als recurEvery: [Frequentie als geheel getal][Dag(en)]. Als er geen frequentie wordt opgegeven, is de standaardfrequentie 1. Voorbeelden van dagelijkse planningen zijn recurEvery: Day, recurEvery: 3Days. Wekelijkse planning wordt opgemaakt als recurEvery: [Frequentie als geheel getal][Week(en)] [Optionele door komma's gescheiden lijst met weekdagen maandag-zondag]. Wekelijkse planningsvoorbeelden zijn recurEvery: 3Weeks, recurEvery: Week zaterdag, zondag. Maandelijkse schema's zijn opgemaakt als [Frequentie als geheel getal][Maand(en)] [Door komma's gescheiden lijst met maanddagen] of [Frequentie als geheel getal][Maand(en)] [Week van maand (eerste, tweede, derde, vierde, laatste)] [weekdag maandag-zondag] [Optionele verschuiving(nee. van dagen)]. De verschuivingswaarde moet tussen -6 en 6 liggen. Maandelijkse schemavoorbeelden zijn recurEvery: Month, recurEvery: 2Months, recurEvery: Month day23,day24, recurEvery: Month Last Sunday, recurEvery: Month Fourth Monday, recurEvery: Month Last Sunday Offset-3, recurEvery: Month Third Sunday Offset6. string
startDateTime Effectieve begindatum van het onderhoudsvenster in JJJJ-MM-DD uu:mm formaat. De begindatum kan worden ingesteld op de huidige of toekomstige datum. Het venster wordt gemaakt in de opgegeven tijdzone en aangepast aan zomertijd op basis van die tijdzone. string
timeZone Naam van de tijdzone. Lijst met tijdzones kan worden verkregen door [System.TimeZoneInfo]::GetSystemTimeZones() uit te voeren in PowerShell. Voorbeeld: Pacific Standard Time, UTC, W. Europe Standard Time, Korea Standard Time, Cen. Australië Standaardtijd. string

Gebruiksvoorbeelden

Geverifieerde Azure-modules

De volgende azure-geverifieerde modules kunnen worden gebruikt om dit resourcetype te implementeren.

Module Description
Onderhoudsconfiguratie AVM-resourcemodule voor onderhoudsconfiguratie

Resourcedefinitie van ARM-sjabloon

Het resourcetype maintenanceConfigurations kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Formaat van de bron

Als u een Microsoft.Maintenance/maintenanceConfigurations-resource wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

{
  "type": "Microsoft.Maintenance/maintenanceConfigurations",
  "apiVersion": "2023-10-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "extensionProperties": {
      "{customized property}": "string"
    },
    "installPatches": {
      "linuxParameters": {
        "classificationsToInclude": [ "string" ],
        "packageNameMasksToExclude": [ "string" ],
        "packageNameMasksToInclude": [ "string" ]
      },
      "rebootSetting": "string",
      "windowsParameters": {
        "classificationsToInclude": [ "string" ],
        "excludeKbsRequiringReboot": "bool",
        "kbNumbersToExclude": [ "string" ],
        "kbNumbersToInclude": [ "string" ]
      }
    },
    "maintenanceScope": "string",
    "maintenanceWindow": {
      "duration": "string",
      "expirationDateTime": "string",
      "recurEvery": "string",
      "startDateTime": "string",
      "timeZone": "string"
    },
    "namespace": "string",
    "visibility": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Eigenschapswaarden

Microsoft.Maintenance/maintenanceConfigurations

Name Description Value
apiVersion De API-versie '2023-10-01-preview'
location Hiermee haalt u de locatie van de resource op of stelt u deze in string
name De resourcenaam Touwtje (verplicht)
properties Eigenschappen van de resource ophalen of instellen MaintenanceConfigurationProperties
tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen
type Het resourcetype 'Microsoft.Maintenance/maintenanceConfigurations'

InputLinuxParameters

Name Description Value
classificationsToInclude Classificatiecategorie van patches die moeten worden gepatcht. Toegestane waarden zijn Kritiek, Beveiliging en Overige. string[]
packageNameMasksToExclude Pakketnamen die moeten worden uitgesloten voor patching. string[]
packageNameMasksToInclude Pakketnamen die moeten worden opgenomen voor patching. string[]

InputPatchConfiguration

Name Description Value
linuxParameters Invoerparameters die specifiek zijn voor het patchen van linux-machines. Geef deze eigenschap niet door voor Windows-computers. InputLinuxParameters
rebootSetting Mogelijke voorkeur voor opnieuw opstarten zoals gedefinieerd door de gebruiker op basis waarvan wordt besloten de computer opnieuw op te starten of niet nadat de patchbewerking is voltooid. 'Always'
'IfRequired'
'Never'
windowsParameters Invoerparameters die specifiek zijn voor het patchen van een Windows-computer. Geef deze eigenschap niet door voor Linux-machines. InputWindowsParameters

InputWindowsParameters

Name Description Value
classificationsToInclude Classificatiecategorie van patches die moeten worden gepatcht. Toegestane waarden zijn 'Kritiek', 'Beveiliging', 'UpdateRollup', 'FeaturePack', 'ServicePack', 'Definitie', 'Hulpprogramma's' en 'Updates'. string[]
excludeKbsRequiringReboot Patches uitsluiten die opnieuw moeten worden opgestart bool
kbNumbersToExclude Windows KBID die moet worden uitgesloten voor patching. string[]
kbNumbersToInclude Windows KBID moet worden opgenomen voor patching. string[]

MaintenanceConfigurationProperties

Name Description Value
extensionProperties Hiermee haalt u extensionProperties van de maintenanceConfiguration op of stelt u deze in MaintenanceConfigurationPropertiesExtensionProperties
installPatches De invoerparameters die moeten worden doorgegeven aan de patchuitvoeringsbewerking. InputPatchConfiguration
maintenanceScope Hiermee haalt u maintenanceScope van de configuratie op of stelt u deze in 'Extension'
'Host'
'InGuestPatch'
'OSImage'
'Resource'
'SQLDB'
'SQLManagedInstance'
maintenanceWindow Definitie van een MaintenanceWindow MaintenanceWindow
namespace Hiermee haalt u de naamruimte van de resource op of stelt u deze in string
visibility Hiermee haalt u de zichtbaarheid van de configuratie op of stelt u deze in. De standaardwaarde is 'Aangepast' 'Custom'
'Public'

MaintenanceConfigurationPropertiesExtensionProperties

Name Description Value

MaintenanceConfigurationTags

Name Description Value

MaintenanceWindow

Name Description Value
duration Duur van het onderhoudsvenster in HH:mm-formaat. Indien niet opgegeven, wordt de standaardwaarde gebruikt op basis van het opgegeven onderhoudsbereik. Voorbeeld: 05:00. string
expirationDateTime Effectieve vervaldatum van het onderhoudsvenster in JJJJ-MM-DD uu:mm-notatie. Het venster wordt gemaakt in de opgegeven tijdzone en aangepast aan zomertijd op basis van die tijdzone. De vervaldatum moet worden ingesteld op een toekomstige datum. Indien niet opgegeven, wordt deze ingesteld op de maximale datum/tijd 9999-12-31 23:59:59. string
recurEvery Snelheid waarmee een onderhoudsvenster naar verwachting opnieuw zal optreden. Het tarief kan worden uitgedrukt als dagelijkse, wekelijkse of maandelijkse schema's. De dagelijkse planning wordt opgemaakt als recurEvery: [Frequentie als geheel getal][Dag(en)]. Als er geen frequentie wordt opgegeven, is de standaardfrequentie 1. Voorbeelden van dagelijkse planningen zijn recurEvery: Day, recurEvery: 3Days. Wekelijkse planning wordt opgemaakt als recurEvery: [Frequentie als geheel getal][Week(en)] [Optionele door komma's gescheiden lijst met weekdagen maandag-zondag]. Wekelijkse planningsvoorbeelden zijn recurEvery: 3Weeks, recurEvery: Week zaterdag, zondag. Maandelijkse schema's zijn opgemaakt als [Frequentie als geheel getal][Maand(en)] [Door komma's gescheiden lijst met maanddagen] of [Frequentie als geheel getal][Maand(en)] [Week van maand (eerste, tweede, derde, vierde, laatste)] [weekdag maandag-zondag] [Optionele verschuiving(nee. van dagen)]. De verschuivingswaarde moet tussen -6 en 6 liggen. Maandelijkse schemavoorbeelden zijn recurEvery: Month, recurEvery: 2Months, recurEvery: Month day23,day24, recurEvery: Month Last Sunday, recurEvery: Month Fourth Monday, recurEvery: Month Last Sunday Offset-3, recurEvery: Month Third Sunday Offset6. string
startDateTime Effectieve begindatum van het onderhoudsvenster in JJJJ-MM-DD uu:mm formaat. De begindatum kan worden ingesteld op de huidige of toekomstige datum. Het venster wordt gemaakt in de opgegeven tijdzone en aangepast aan zomertijd op basis van die tijdzone. string
timeZone Naam van de tijdzone. Lijst met tijdzones kan worden verkregen door [System.TimeZoneInfo]::GetSystemTimeZones() uit te voeren in PowerShell. Voorbeeld: Pacific Standard Time, UTC, W. Europe Standard Time, Korea Standard Time, Cen. Australië Standaardtijd. string

Gebruiksvoorbeelden

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype maintenanceConfigurations kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Formaat van de bron

Als u een Microsoft.Maintenance/maintenanceConfigurations-resource wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Maintenance/maintenanceConfigurations@2023-10-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      extensionProperties = {
        {customized property} = "string"
      }
      installPatches = {
        linuxParameters = {
          classificationsToInclude = [
            "string"
          ]
          packageNameMasksToExclude = [
            "string"
          ]
          packageNameMasksToInclude = [
            "string"
          ]
        }
        rebootSetting = "string"
        windowsParameters = {
          classificationsToInclude = [
            "string"
          ]
          excludeKbsRequiringReboot = bool
          kbNumbersToExclude = [
            "string"
          ]
          kbNumbersToInclude = [
            "string"
          ]
        }
      }
      maintenanceScope = "string"
      maintenanceWindow = {
        duration = "string"
        expirationDateTime = "string"
        recurEvery = "string"
        startDateTime = "string"
        timeZone = "string"
      }
      namespace = "string"
      visibility = "string"
    }
  }
}

Eigenschapswaarden

Microsoft.Maintenance/maintenanceConfigurations

Name Description Value
location Hiermee haalt u de locatie van de resource op of stelt u deze in string
name De resourcenaam Touwtje (verplicht)
parent_id De id van de resource waar deze extensieresource op moet worden toegepast. Touwtje (verplicht)
properties Eigenschappen van de resource ophalen of instellen MaintenanceConfigurationProperties
tags Resourcetags Woordenlijst met tagnamen en -waarden.
type Het resourcetype "Microsoft.Maintenance/maintenanceConfigurations@2023-10-01-preview"

InputLinuxParameters

Name Description Value
classificationsToInclude Classificatiecategorie van patches die moeten worden gepatcht. Toegestane waarden zijn Kritiek, Beveiliging en Overige. string[]
packageNameMasksToExclude Pakketnamen die moeten worden uitgesloten voor patching. string[]
packageNameMasksToInclude Pakketnamen die moeten worden opgenomen voor patching. string[]

InputPatchConfiguration

Name Description Value
linuxParameters Invoerparameters die specifiek zijn voor het patchen van linux-machines. Geef deze eigenschap niet door voor Windows-computers. InputLinuxParameters
rebootSetting Mogelijke voorkeur voor opnieuw opstarten zoals gedefinieerd door de gebruiker op basis waarvan wordt besloten de computer opnieuw op te starten of niet nadat de patchbewerking is voltooid. 'Always'
'IfRequired'
'Never'
windowsParameters Invoerparameters die specifiek zijn voor het patchen van een Windows-computer. Geef deze eigenschap niet door voor Linux-machines. InputWindowsParameters

InputWindowsParameters

Name Description Value
classificationsToInclude Classificatiecategorie van patches die moeten worden gepatcht. Toegestane waarden zijn 'Kritiek', 'Beveiliging', 'UpdateRollup', 'FeaturePack', 'ServicePack', 'Definitie', 'Hulpprogramma's' en 'Updates'. string[]
excludeKbsRequiringReboot Patches uitsluiten die opnieuw moeten worden opgestart bool
kbNumbersToExclude Windows KBID die moet worden uitgesloten voor patching. string[]
kbNumbersToInclude Windows KBID moet worden opgenomen voor patching. string[]

MaintenanceConfigurationProperties

Name Description Value
extensionProperties Hiermee haalt u extensionProperties van de maintenanceConfiguration op of stelt u deze in MaintenanceConfigurationPropertiesExtensionProperties
installPatches De invoerparameters die moeten worden doorgegeven aan de patchuitvoeringsbewerking. InputPatchConfiguration
maintenanceScope Hiermee haalt u maintenanceScope van de configuratie op of stelt u deze in 'Extension'
'Host'
'InGuestPatch'
'OSImage'
'Resource'
'SQLDB'
'SQLManagedInstance'
maintenanceWindow Definitie van een MaintenanceWindow MaintenanceWindow
namespace Hiermee haalt u de naamruimte van de resource op of stelt u deze in string
visibility Hiermee haalt u de zichtbaarheid van de configuratie op of stelt u deze in. De standaardwaarde is 'Aangepast' 'Custom'
'Public'

MaintenanceConfigurationPropertiesExtensionProperties

Name Description Value

MaintenanceConfigurationTags

Name Description Value

MaintenanceWindow

Name Description Value
duration Duur van het onderhoudsvenster in HH:mm-formaat. Indien niet opgegeven, wordt de standaardwaarde gebruikt op basis van het opgegeven onderhoudsbereik. Voorbeeld: 05:00. string
expirationDateTime Effectieve vervaldatum van het onderhoudsvenster in JJJJ-MM-DD uu:mm-notatie. Het venster wordt gemaakt in de opgegeven tijdzone en aangepast aan zomertijd op basis van die tijdzone. De vervaldatum moet worden ingesteld op een toekomstige datum. Indien niet opgegeven, wordt deze ingesteld op de maximale datum/tijd 9999-12-31 23:59:59. string
recurEvery Snelheid waarmee een onderhoudsvenster naar verwachting opnieuw zal optreden. Het tarief kan worden uitgedrukt als dagelijkse, wekelijkse of maandelijkse schema's. De dagelijkse planning wordt opgemaakt als recurEvery: [Frequentie als geheel getal][Dag(en)]. Als er geen frequentie wordt opgegeven, is de standaardfrequentie 1. Voorbeelden van dagelijkse planningen zijn recurEvery: Day, recurEvery: 3Days. Wekelijkse planning wordt opgemaakt als recurEvery: [Frequentie als geheel getal][Week(en)] [Optionele door komma's gescheiden lijst met weekdagen maandag-zondag]. Wekelijkse planningsvoorbeelden zijn recurEvery: 3Weeks, recurEvery: Week zaterdag, zondag. Maandelijkse schema's zijn opgemaakt als [Frequentie als geheel getal][Maand(en)] [Door komma's gescheiden lijst met maanddagen] of [Frequentie als geheel getal][Maand(en)] [Week van maand (eerste, tweede, derde, vierde, laatste)] [weekdag maandag-zondag] [Optionele verschuiving(nee. van dagen)]. De verschuivingswaarde moet tussen -6 en 6 liggen. Maandelijkse schemavoorbeelden zijn recurEvery: Month, recurEvery: 2Months, recurEvery: Month day23,day24, recurEvery: Month Last Sunday, recurEvery: Month Fourth Monday, recurEvery: Month Last Sunday Offset-3, recurEvery: Month Third Sunday Offset6. string
startDateTime Effectieve begindatum van het onderhoudsvenster in JJJJ-MM-DD uu:mm formaat. De begindatum kan worden ingesteld op de huidige of toekomstige datum. Het venster wordt gemaakt in de opgegeven tijdzone en aangepast aan zomertijd op basis van die tijdzone. string
timeZone Naam van de tijdzone. Lijst met tijdzones kan worden verkregen door [System.TimeZoneInfo]::GetSystemTimeZones() uit te voeren in PowerShell. Voorbeeld: Pacific Standard Time, UTC, W. Europe Standard Time, Korea Standard Time, Cen. Australië Standaardtijd. string

Gebruiksvoorbeelden

Terraform-monsters

Een eenvoudig voorbeeld van het implementeren van Maintenance Configuration.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "maintenanceConfiguration" {
  type      = "Microsoft.Maintenance/maintenanceConfigurations@2022-07-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      extensionProperties = {
      }
      maintenanceScope = "SQLDB"
      namespace        = "Microsoft.Maintenance"
      visibility       = "Custom"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Geverifieerde Azure-modules

De volgende azure-geverifieerde modules kunnen worden gebruikt om dit resourcetype te implementeren.

Module Description
Onderhoudsconfiguratie AVM-resourcemodule voor onderhoudsconfiguratie