Sdílet prostřednictvím

Microsoft.Maintenance MaintenanceKonfigurace

  • Článek

Definice prostředku Bicep

Typ prostředku maintenanceKonfigurace je možné nasadit s operacemi, které cílí na:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Maintenance/maintenanceConfigurations, přidejte do šablony následující bicep.

resource symbolicname 'Microsoft.Maintenance/maintenanceConfigurations@2023-04-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    extensionProperties: {}
    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'
  }
}

Hodnoty vlastností

údržbaKonfigurace

Název Description Hodnota
name Název prostředku string (povinné)
location Získá nebo nastaví umístění prostředku. řetězec
tags Získá nebo nastaví značky prostředku. Slovník názvů a hodnot značek. Zobrazit značky v šablonách
properties Získá nebo nastaví vlastnosti prostředku. Vlastnosti konfigurace údržby

Vlastnosti konfigurace údržby

Název Description Hodnota
extensionVlastnosti Získá nebo nastaví vlastnosti rozšíření maintenanceConfiguration. object
installPatches Vstupní parametry, které se mají předat operaci spuštění opravy. InputPatchConfiguration
maintenanceScope Získá nebo nastaví maintenanceScope konfigurace. 'Rozšíření'
'Hostitel'
InGuestPatch
OSImage
'Zdroj'
SQLDB
SQLManagedInstance
údržbaWindow Definice maintenanceWindow ÚdržbaWindow
namespace Získá nebo nastaví obor názvů prostředku. řetězec
viditelnost Získá nebo nastaví viditelnost konfigurace. Výchozí hodnota je Vlastní. 'Vlastní'
'Veřejné'

InputPatchConfiguration

Název Description Hodnota
linuxParameters Vstupní parametry specifické pro opravy počítače s Linuxem U počítačů s Windows tuto vlastnost nepředávejte. InputLinuxParameters
rebootSetting Možná předvolba restartování definovaná uživatelem, na základě které by se po dokončení operace opravy rozhodlo restartovat počítač nebo ne. Vždy
IfRequired
'Nikdy'
windowsParameters Vstupní parametry specifické pro opravy počítače s Windows U počítačů s Linuxem tuto vlastnost nepředávejte. InputWindowsParameters

InputLinuxParameters

Název Description Hodnota
klasifikaceToInclude Klasifikační kategorie oprav, které se mají opravovat string[]
packageNameMasksToExclude Názvy balíčků, které se mají vyloučit z oprav. string[]
packageNameMasksToInclude Názvy balíčků, které mají být zahrnuty pro opravy. string[]

InputWindowsParameters

Název Description Hodnota
classificationsToInclude Klasifikační kategorie oprav, které se mají opravit string[]
excludeKbsRequiringReboot Vyloučení oprav, které vyžadují restartování bool
KbNumbersToExclude Windows KBID, který se má vyloučit z oprav. string[]
KbNumbersToInclude Windows KBID, který se má zahrnout pro opravy. string[]

ÚdržbaWindow

Název Description Hodnota
doba trvání Doba trvání časového období údržby ve formátu HH:mm. Pokud není zadaný, použije se výchozí hodnota na základě zadaného rozsahu údržby. Příklad: 05:00. řetězec
expirationDateTime Datum vypršení platnosti časového období údržby ve formátu RRRR-MM-DD hh:mm. Okno se vytvoří v zadaném časovém pásmu a upraví se na letní čas podle daného časového pásma. Datum vypršení platnosti musí být nastavené na budoucí datum. Pokud není zadaný, nastaví se na maximální datum a čas 9999-12-31 23:59:59. řetězec
recurEvery Rychlost, se kterou se očekává opakování časového období údržby Sazba může být vyjádřena denním, týdenním nebo měsíčním rozvrhem. Denní plán je naformátovaný jako rekurz: [Frequency as integer]['Day(s)']. Pokud není zadána žádná frekvence, výchozí frekvence je 1. Příklady denního plánu jsou recurEvery: Day, recurEvery: 3Days. Týdenní plán je formátovaný jako rekurz: [Frekvence jako celé číslo]['Týden(s)] [Nepovinný seznam oddělený čárkami pro pracovní dny pondělí-neděle]. Příklady týdenního plánu jsou rekurz: 3týdny, rekurzEvery: Týden sobota, neděle. Měsíční plány jsou formátované jako [Frekvence jako celé číslo]['Měsíce(s)'] [Seznam dnů měsíce oddělených čárkami] nebo [Frekvence jako celé číslo]['Měsíc(y)' [Týden měsíce (první, druhý, třetí, čtvrtý, poslední)] [Pondělí-neděle v týdnu] [Nepovinný posun (počet dnů)]. Hodnota posunu musí být od -6 do 6 včetně. Příklady měsíčního plánu jsou 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. řetězec
startDateTime Platné datum zahájení časového období údržby ve formátu RRRR-MM-DD hh:mm. Počáteční datum lze nastavit buď na aktuální datum, nebo na budoucí datum. Okno se vytvoří v zadaném časovém pásmu a upraví se na letní čas podle daného časového pásma. řetězec
timeZone Název časového pásma Seznam časových pásem můžete získat spuštěním příkazu [System.TimeZoneInfo]::GetSystemTimeZones() v PowerShellu. Příklad: Tichomoří (běžný čas), UTC, W. Evropa (běžný čas), Korea (běžný čas), Cen (Cen). Austrálie (běžný čas). řetězec

Definice prostředku šablony ARM

Typ prostředku maintenanceConfigurations je možné nasadit s operacemi, které cílí na:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Maintenance/maintenanceConfigurations, přidejte do šablony následující kód JSON.

{
  "type": "Microsoft.Maintenance/maintenanceConfigurations",
  "apiVersion": "2023-04-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "extensionProperties": {},
    "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"
  }
}

Hodnoty vlastností

údržbaKonfigurace

Název Description Hodnota
typ Typ prostředku Microsoft.Maintenance/maintenanceConfigurations
apiVersion Verze rozhraní API prostředků '2023-04-01'
name Název prostředku string (povinné)
location Získá nebo nastaví umístění prostředku. řetězec
tags Získá nebo nastaví značky prostředku. Slovník názvů značek a hodnot. Viz Značky v šablonách
properties Získá nebo nastaví vlastnosti prostředku. ÚdržbaKonfiguraceProperties

ÚdržbaKonfiguraceProperties

Název Description Hodnota
extensionVlastnosti Získá nebo nastaví vlastnosti extensionProperties údržbyConfiguration. object
installPatches Vstupní parametry, které se mají předat operaci spuštění opravy. InputPatchConfiguration
maintenanceScope Získá nebo nastaví maintenanceScope konfigurace. 'Rozšíření'
Hostitel
'InGuestPatch'
'OSImage'
'Zdroj'
SQLDB
SQLManagedInstance
údržbaWindow Definice maintenanceWindow ÚdržbaWindow
namespace Získá nebo nastaví obor názvů prostředku. řetězec
viditelnost Získá nebo nastaví viditelnost konfigurace. Výchozí hodnota je Vlastní. 'Vlastní'
'Veřejné'

InputPatchConfiguration

Název Description Hodnota
linuxParameters Vstupní parametry specifické pro opravy počítače s Linuxem U počítačů s Windows tuto vlastnost nepředávejte. InputLinuxParameters
rebootSetting Možná předvolba restartování definovaná uživatelem, na základě které by se po dokončení operace opravy rozhodlo restartovat počítač nebo ne. Vždy
IfRequired
'Nikdy'
windowsParameters Vstupní parametry specifické pro opravy počítače s Windows U počítačů s Linuxem tuto vlastnost nepředávejte. InputWindowsParameters

InputLinuxParameters

Název Description Hodnota
klasifikaceToInclude Klasifikační kategorie oprav, které se mají opravovat string[]
packageNameMasksToExclude Názvy balíčků, které se mají vyloučit z oprav. string[]
packageNameMasksToInclude Názvy balíčků, které mají být zahrnuty pro opravy. string[]

InputWindowsParameters

Název Description Hodnota
klasifikaceToInclude Klasifikační kategorie oprav, které se mají opravovat string[]
excludeKbsRequiringReboot Vyloučit opravy, které vyžadují restartování bool
Projděte si také anglickou verzi článku. Windows KBID bude vyloučen z opravy. string[]
Projděte si také anglickou verzi článku. Windows KBID bude součástí opravy. string[]

ÚdržbaWindow

Název Description Hodnota
doba trvání Doba trvání časového období údržby ve formátu HH:mm. Pokud není zadaný, použije se výchozí hodnota na základě zadaného rozsahu údržby. Příklad: 05:00. řetězec
expirationDateTime Platné datum vypršení platnosti časového období údržby ve formátu RRRR-MM-DD hh:mm. Okno bude vytvořeno v poskytnutém časovém pásmu a upraveno na letní čas podle daného časového pásma. Datum vypršení platnosti musí být nastavené na budoucí datum. Pokud není zadaný, nastaví se na maximální datum a čas 9999-12-31 23:59:59. řetězec
recurEvery Rychlost, s jakou se očekává opakování časového období údržby Sazba může být vyjádřena denním, týdenním nebo měsíčním rozvrhem. Denní plán je formátovaný jako rekurzní: [Frekvence jako celé číslo]['Den(s)']. Pokud není zadána žádná frekvence, výchozí frekvence je 1. Příklady denního plánu jsou recuryEvery: Day, recuryEvery: 3Days. Týdenní plán je formátován jako rekurzivně: [Frequency as integer]['Week(s)'] [Optional čárkami separated list of weekdays monday-Sunday]. Příklady týdenního plánu jsou recuryEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Měsíční plány jsou formátované jako [Frekvence jako celé číslo]['Měsíce(y)'] [Seznam dnů měsíce oddělených čárkami] nebo [Frekvence jako celé číslo]['Měsíc(y)'] [Týden měsíce (první, druhý, třetí, čtvrtý, poslední)] [Pondělí-neděle v týdnu] [Nepovinný posun (počet dnů)]. Hodnota posunu musí být v rozmezí od -6 do 6 (včetně). Příklady měsíčního plánu jsou 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. řetězec
startDateTime Datum zahájení časového období údržby ve formátu RRRR-MM-DD hh:mm. Počáteční datum lze nastavit na aktuální datum nebo datum v budoucnosti. Okno bude vytvořeno v poskytnutém časovém pásmu a upraveno na letní čas podle daného časového pásma. řetězec
timeZone Název časového pásma Seznam časových pásem je možné získat spuštěním příkazu [System.TimeZoneInfo]::GetSystemTimeZones() v PowerShellu. Příklad: Tichomoří (běžný čas), UTC, W. Evropa (běžný čas), Korea (běžný čas), Cen (cen). Austrálie (běžný čas). řetězec

Definice prostředku Terraform (poskytovatel AzAPI)

Typ prostředku maintenanceKonfigurace je možné nasadit s operacemi, které cílí na:

  • Skupiny prostředků

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.Maintenance/maintenanceConfigurations, přidejte do šablony následující Terraform.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Maintenance/maintenanceConfigurations@2023-04-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      extensionProperties = {}
      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"
    }
  })
}

Hodnoty vlastností

údržbaKonfigurace

Název Description Hodnota
typ Typ prostředku Microsoft.Maintenance/maintenanceConfigurations@2023-04-01
name Název prostředku string (povinné)
location Získá nebo nastaví umístění prostředku. řetězec
parent_id K nasazení do skupiny prostředků použijte ID této skupiny prostředků. string (povinné)
tags Získá nebo nastaví značky prostředku. Slovník názvů a hodnot značek.
properties Získá nebo nastaví vlastnosti prostředku. Vlastnosti konfigurace údržby

Vlastnosti konfigurace údržby

Název Description Hodnota
extensionVlastnosti Získá nebo nastaví vlastnosti rozšíření maintenanceConfiguration. object
installPatches Vstupní parametry, které se mají předat operaci spuštění opravy. InputPatchConfiguration
maintenanceScope Získá nebo nastaví maintenanceScope konfigurace. "Rozšíření"
"Hostitel"
"InGuestPatch"
"OSImage"
"Zdroj"
"SQLDB"
"SQLManagedInstance"
údržbaWindow Definice maintenanceWindow ÚdržbaWindow
namespace Získá nebo nastaví obor názvů prostředku. řetězec
viditelnost Získá nebo nastaví viditelnost konfigurace. Výchozí hodnota je Vlastní. "Vlastní"
"Veřejné"

InputPatchConfiguration

Název Description Hodnota
linuxParameters Vstupní parametry specifické pro opravy počítače s Linuxem U počítačů s Windows tuto vlastnost nepředávejte. InputLinuxParameters
rebootSetting Možná předvolba restartování definovaná uživatelem, na základě které by se po dokončení operace opravy rozhodlo restartovat počítač nebo ne. "Vždy"
"IfRequired" (IfRequired)
"Nikdy"
windowsParameters Vstupní parametry specifické pro opravy počítače s Windows U počítačů s Linuxem tuto vlastnost nepředávejte. InputWindowsParameters

InputLinuxParameters

Název Description Hodnota
klasifikaceToInclude Klasifikační kategorie oprav, které se mají opravovat string[]
packageNameMasksToExclude Názvy balíčků, které se mají vyloučit z oprav. string[]
packageNameMasksToInclude Názvy balíčků, které mají být zahrnuty pro opravy. string[]

InputWindowsParameters

Název Description Hodnota
klasifikaceToInclude Klasifikační kategorie oprav, které se mají opravovat string[]
excludeKbsRequiringReboot Vyloučit opravy, které vyžadují restartování bool
Projděte si také anglickou verzi článku. Windows KBID bude vyloučen z opravy. string[]
Projděte si také anglickou verzi článku. Windows KBID bude součástí opravy. string[]

ÚdržbaWindow

Název Description Hodnota
doba trvání Doba trvání časového období údržby ve formátu HH:mm. Pokud není zadaný, použije se výchozí hodnota na základě zadaného rozsahu údržby. Příklad: 05:00. řetězec
expirationDateTime Datum vypršení platnosti časového období údržby ve formátu RRRR-MM-DD hh:mm. Okno se vytvoří v zadaném časovém pásmu a upraví se na letní čas podle daného časového pásma. Datum vypršení platnosti musí být nastavené na budoucí datum. Pokud není zadaný, nastaví se na maximální datum a čas 9999-12-31 23:59:59. řetězec
recurEvery Rychlost, se kterou se očekává opakování časového období údržby Sazba může být vyjádřena denním, týdenním nebo měsíčním rozvrhem. Denní plán je naformátovaný jako rekurz: [Frequency as integer]['Day(s)']. Pokud není zadána žádná frekvence, výchozí frekvence je 1. Příklady denního plánu jsou recurEvery: Day, recurEvery: 3Days. Týdenní plán je formátovaný jako rekurz: [Frekvence jako celé číslo]['Týden(s)] [Nepovinný seznam oddělený čárkami pro pracovní dny pondělí-neděle]. Příklady týdenního plánu jsou rekurz: 3týdny, rekurzEvery: Týden sobota, neděle. Měsíční plány jsou formátované jako [Frekvence jako celé číslo]['Měsíce(s)'] [Seznam dnů měsíce oddělených čárkami] nebo [Frekvence jako celé číslo]['Měsíc(y)' [Týden měsíce (první, druhý, třetí, čtvrtý, poslední)] [Pondělí-neděle v týdnu] [Nepovinný posun (počet dnů)]. Hodnota posunu musí být od -6 do 6 včetně. Příklady měsíčního plánu jsou 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. řetězec
startDateTime Platné datum zahájení časového období údržby ve formátu RRRR-MM-DD hh:mm. Počáteční datum lze nastavit buď na aktuální datum, nebo na budoucí datum. Okno se vytvoří v zadaném časovém pásmu a upraví se na letní čas podle daného časového pásma. řetězec
timeZone Název časového pásma Seznam časových pásem můžete získat spuštěním příkazu [System.TimeZoneInfo]::GetSystemTimeZones() v PowerShellu. Příklad: Tichomoří (běžný čas), UTC, W. Evropa (běžný čas), Korea (běžný čas), Cen (Cen). Austrálie (běžný čas). řetězec