Microsoft.Maintenance maintenanceConfigurations 2023-04-01

• più recenti
• 2023-10-01-preview
• 2023-09-01-preview
• 2023-04-01
• 11-11-2022
• 2022-07-01-preview
• 2021-09-01-preview
• 2021-05-01
• 2021-04-01-preview
• 2020-07-01-preview
• 2020-04-01
• 2018-06-01-preview

Definizione di risorsa Bicep

Il tipo di risorsa maintenanceConfigurations può essere distribuito con operazioni destinate a:

• gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Maintenance/maintenanceConfigurations, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.Maintenance/maintenanceConfigurations@2023-04-01' = {
  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'
  }
}

Valori delle proprietà

InputLinuxParameters

Nome	Descrizione	Valore
classificationsToInclude	Categoria di classificazione delle patch da applicare alle patch. I valori consentiti sono 'Critical', 'Security' e 'Other'.	string[]
packageNameMasksToExclude	Nomi dei pacchetti da escludere per l'applicazione di patch.	string[]
packageNameMasksToInclude	Nomi dei pacchetti da includere per l'applicazione di patch.	string[]

InputPatchConfiguration

Nome	Descrizione	Valore
linuxParameters	Parametri di input specifici per l'applicazione di patch al computer Linux. Per i computer Windows, non passare questa proprietà.	InputLinuxParameters
rebootSetting	Possibile preferenza di riavvio definita dall'utente in base alla quale sarebbe stato deciso di riavviare il computer o meno dopo il completamento dell'operazione di patch.	'Always' 'IfRequired' 'Never'
windowsParameters	Parametri di input specifici per l'applicazione di patch a un computer Windows. Per i computer Linux, non passare questa proprietà.	InputWindowsParameters

InputWindowsParameters

Nome	Descrizione	Valore
classificationsToInclude	Categoria di classificazione delle patch da applicare alle patch. I valori consentiti sono 'Critical', 'Security', 'UpdateRollup', 'FeaturePack', 'ServicePack', 'Definition', 'Tools' e 'Updates'.	string[]
excludeKbsRequiringReboot	Escludere le patch che richiedono il riavvio	Bool
kbNumbersToExclude	KBID di Windows da escludere per l'applicazione di patch.	string[]
kbNumbersToInclude	KBID di Windows da includere per l'applicazione di patch.	string[]

MaintenanceConfigurationProperties

Nome	Descrizione	Valore
extensionProperties	Ottiene o imposta extensionProperties dell'oggetto maintenanceConfiguration	MaintenanceConfigurationPropertiesExtensionProperties
installPatches	Parametri di input da passare all'operazione di esecuzione della patch.	InputPatchConfiguration
maintenanceScope	Ottiene o imposta la manutenzioneScope della configurazione	'Extension' 'Host' 'InGuestPatch' 'OSImage' 'Resource' 'SQLDB' 'SQLManagedInstance'
maintenanceWindow	Definizione di un oggetto MaintenanceWindow	manutenzione Window
Namespace	Ottiene o imposta lo spazio dei nomi della risorsa	corda
visibilità	Ottiene o imposta la visibilità della configurazione. Il valore predefinito è 'Custom'	'Custom' 'Pubblico'

MaintenanceConfigurationPropertiesExtensionProperties

Nome	Descrizione	Valore

MaintenanceConfigurationTags

Nome	Descrizione	Valore

MaintenanceWindow

Nome	Descrizione	Valore
durata	Durata della finestra di manutenzione in formato HH:mm. Se non specificato, il valore predefinito verrà usato in base all'ambito di manutenzione specificato. Esempio: 05:00.	corda
expirationDateTime	Data di scadenza effettiva della finestra di manutenzione in formato AAAA-MM-DD hh:mm. La finestra verrà creata nel fuso orario specificato e regolata in base al fuso orario. La data di scadenza deve essere impostata su una data futura. Se non specificato, verrà impostato sul valore datetime massimo 9999-12-31 23:59:59.	corda
recurEvery	Frequenza di ripetizione di una finestra di manutenzione. Il tasso può essere espresso come pianificazioni giornaliere, settimanali o mensili. La pianificazione giornaliera viene formattata come ricorsiva: [Frequency as integer]['Day/s)']. Se non viene specificata alcuna frequenza, la frequenza predefinita è 1. Gli esempi di pianificazione giornaliera sono ricorsivi: Day, recurEvery: 3Days. La pianificazione settimanale viene formattata come ricorsiva: [Frequenza come numero intero][Settimana/i][Elenco delimitato da virgole facoltativo dei giorni feriali lunedì-domenica]. Gli esempi di pianificazione settimanale sono ricorsiva: 3Weeks, recurEvery: Week Saturday,Sunday. Le pianificazioni mensili vengono formattate come [Frequency as integer]['Month/s)'] [Elenco delimitato da virgole di giorni mensili] o [Frequency as integer]['Month(s)'] [Week of Month (First, Second, Third, Fourth, Last)] [Weekday Monday-Sunday] [Optional Offset(No. of days)]. Il valore di offset deve essere compreso tra -6 e 6 inclusi. Gli esempi di pianificazione mensile sono recurEvery: Month, recurEvery: 2Months, recurevery: Month day23,day24, recurEvery: Month Last Sunday, recury: Month Fourth Monday, recury: Month Last Sunday Offset-3, recury: Month Third Sunday Offset6.	corda
startDateTime	Data di inizio effettiva della finestra di manutenzione in formato AAAA-MM-DD hh:mm. La data di inizio può essere impostata sulla data corrente o sulla data futura. La finestra verrà creata nel fuso orario specificato e regolata in base al fuso orario.	corda
timeZone	Nome del fuso orario. È possibile ottenere l'elenco dei fusi orari eseguendo [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell. Esempio: Ora solare pacifico, UTC, Ora solare W. Europa, Ora solare corea, Cen. Ora solare australia.	corda

Microsoft.Maintenance/maintenanceConfigurations

Nome	Descrizione	Valore
ubicazione	Ottiene o imposta la posizione della risorsa	corda
nome	Nome della risorsa	stringa (obbligatorio)
proprietà	Ottiene o imposta le proprietà della risorsa	MaintenanceConfigurationProperties
Tag	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli

Esempi di utilizzo

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Modulo	Descrizione
Configurazione della manutenzione	Modulo di risorse AVM per la configurazione della manutenzione

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa maintenanceConfigurations può essere distribuito con operazioni destinate a:

• gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Maintenance/maintenanceConfigurations, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.Maintenance/maintenanceConfigurations",
  "apiVersion": "2023-04-01",
  "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"
  }
}

Valori delle proprietà

InputLinuxParameters

Nome	Descrizione	Valore
classificationsToInclude	Categoria di classificazione delle patch da applicare alle patch. I valori consentiti sono 'Critical', 'Security' e 'Other'.	string[]
packageNameMasksToExclude	Nomi dei pacchetti da escludere per l'applicazione di patch.	string[]
packageNameMasksToInclude	Nomi dei pacchetti da includere per l'applicazione di patch.	string[]

InputPatchConfiguration

Nome	Descrizione	Valore
linuxParameters	Parametri di input specifici per l'applicazione di patch al computer Linux. Per i computer Windows, non passare questa proprietà.	InputLinuxParameters
rebootSetting	Possibile preferenza di riavvio definita dall'utente in base alla quale sarebbe stato deciso di riavviare il computer o meno dopo il completamento dell'operazione di patch.	'Always' 'IfRequired' 'Never'
windowsParameters	Parametri di input specifici per l'applicazione di patch a un computer Windows. Per i computer Linux, non passare questa proprietà.	InputWindowsParameters

InputWindowsParameters

Nome	Descrizione	Valore
classificationsToInclude	Categoria di classificazione delle patch da applicare alle patch. I valori consentiti sono 'Critical', 'Security', 'UpdateRollup', 'FeaturePack', 'ServicePack', 'Definition', 'Tools' e 'Updates'.	string[]
excludeKbsRequiringReboot	Escludere le patch che richiedono il riavvio	Bool
kbNumbersToExclude	KBID di Windows da escludere per l'applicazione di patch.	string[]
kbNumbersToInclude	KBID di Windows da includere per l'applicazione di patch.	string[]

MaintenanceConfigurationProperties

Nome	Descrizione	Valore
extensionProperties	Ottiene o imposta extensionProperties dell'oggetto maintenanceConfiguration	MaintenanceConfigurationPropertiesExtensionProperties
installPatches	Parametri di input da passare all'operazione di esecuzione della patch.	InputPatchConfiguration
maintenanceScope	Ottiene o imposta la manutenzioneScope della configurazione	'Extension' 'Host' 'InGuestPatch' 'OSImage' 'Resource' 'SQLDB' 'SQLManagedInstance'
maintenanceWindow	Definizione di un oggetto MaintenanceWindow	manutenzione Window
Namespace	Ottiene o imposta lo spazio dei nomi della risorsa	corda
visibilità	Ottiene o imposta la visibilità della configurazione. Il valore predefinito è 'Custom'	'Custom' 'Pubblico'

MaintenanceConfigurationPropertiesExtensionProperties

Nome	Descrizione	Valore

MaintenanceConfigurationTags

Nome	Descrizione	Valore

MaintenanceWindow

Nome	Descrizione	Valore
durata	Durata della finestra di manutenzione in formato HH:mm. Se non specificato, il valore predefinito verrà usato in base all'ambito di manutenzione specificato. Esempio: 05:00.	corda
expirationDateTime	Data di scadenza effettiva della finestra di manutenzione in formato AAAA-MM-DD hh:mm. La finestra verrà creata nel fuso orario specificato e regolata in base al fuso orario. La data di scadenza deve essere impostata su una data futura. Se non specificato, verrà impostato sul valore datetime massimo 9999-12-31 23:59:59.	corda
recurEvery	Frequenza di ripetizione di una finestra di manutenzione. Il tasso può essere espresso come pianificazioni giornaliere, settimanali o mensili. La pianificazione giornaliera viene formattata come ricorsiva: [Frequency as integer]['Day/s)']. Se non viene specificata alcuna frequenza, la frequenza predefinita è 1. Gli esempi di pianificazione giornaliera sono ricorsivi: Day, recurEvery: 3Days. La pianificazione settimanale viene formattata come ricorsiva: [Frequenza come numero intero][Settimana/i][Elenco delimitato da virgole facoltativo dei giorni feriali lunedì-domenica]. Gli esempi di pianificazione settimanale sono ricorsiva: 3Weeks, recurEvery: Week Saturday,Sunday. Le pianificazioni mensili vengono formattate come [Frequency as integer]['Month/s)'] [Elenco delimitato da virgole di giorni mensili] o [Frequency as integer]['Month(s)'] [Week of Month (First, Second, Third, Fourth, Last)] [Weekday Monday-Sunday] [Optional Offset(No. of days)]. Il valore di offset deve essere compreso tra -6 e 6 inclusi. Gli esempi di pianificazione mensile sono recurEvery: Month, recurEvery: 2Months, recurevery: Month day23,day24, recurEvery: Month Last Sunday, recury: Month Fourth Monday, recury: Month Last Sunday Offset-3, recury: Month Third Sunday Offset6.	corda
startDateTime	Data di inizio effettiva della finestra di manutenzione in formato AAAA-MM-DD hh:mm. La data di inizio può essere impostata sulla data corrente o sulla data futura. La finestra verrà creata nel fuso orario specificato e regolata in base al fuso orario.	corda
timeZone	Nome del fuso orario. È possibile ottenere l'elenco dei fusi orari eseguendo [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell. Esempio: Ora solare pacifico, UTC, Ora solare W. Europa, Ora solare corea, Cen. Ora solare australia.	corda

Microsoft.Maintenance/maintenanceConfigurations

Nome	Descrizione	Valore
apiVersion	Versione dell'API	'2023-04-01'
ubicazione	Ottiene o imposta la posizione della risorsa	corda
nome	Nome della risorsa	stringa (obbligatorio)
proprietà	Ottiene o imposta le proprietà della risorsa	MaintenanceConfigurationProperties
Tag	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare	Tipo di risorsa	'Microsoft.Maintenance/maintenanceConfigurations'

Esempi di utilizzo

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa maintenanceConfigurations può essere distribuito con operazioni destinate a:

• gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Maintenance/maintenanceConfigurations, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Maintenance/maintenanceConfigurations@2023-04-01"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    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"
    }
  })
}

Valori delle proprietà

InputLinuxParameters

Nome	Descrizione	Valore
classificationsToInclude	Categoria di classificazione delle patch da applicare alle patch. I valori consentiti sono 'Critical', 'Security' e 'Other'.	string[]
packageNameMasksToExclude	Nomi dei pacchetti da escludere per l'applicazione di patch.	string[]
packageNameMasksToInclude	Nomi dei pacchetti da includere per l'applicazione di patch.	string[]

InputPatchConfiguration

Nome	Descrizione	Valore
linuxParameters	Parametri di input specifici per l'applicazione di patch al computer Linux. Per i computer Windows, non passare questa proprietà.	InputLinuxParameters
rebootSetting	Possibile preferenza di riavvio definita dall'utente in base alla quale sarebbe stato deciso di riavviare il computer o meno dopo il completamento dell'operazione di patch.	'Always' 'IfRequired' 'Never'
windowsParameters	Parametri di input specifici per l'applicazione di patch a un computer Windows. Per i computer Linux, non passare questa proprietà.	InputWindowsParameters

InputWindowsParameters

Nome	Descrizione	Valore
classificationsToInclude	Categoria di classificazione delle patch da applicare alle patch. I valori consentiti sono 'Critical', 'Security', 'UpdateRollup', 'FeaturePack', 'ServicePack', 'Definition', 'Tools' e 'Updates'.	string[]
excludeKbsRequiringReboot	Escludere le patch che richiedono il riavvio	Bool
kbNumbersToExclude	KBID di Windows da escludere per l'applicazione di patch.	string[]
kbNumbersToInclude	KBID di Windows da includere per l'applicazione di patch.	string[]

MaintenanceConfigurationProperties

Nome	Descrizione	Valore
extensionProperties	Ottiene o imposta extensionProperties dell'oggetto maintenanceConfiguration	MaintenanceConfigurationPropertiesExtensionProperties
installPatches	Parametri di input da passare all'operazione di esecuzione della patch.	InputPatchConfiguration
maintenanceScope	Ottiene o imposta la manutenzioneScope della configurazione	'Extension' 'Host' 'InGuestPatch' 'OSImage' 'Resource' 'SQLDB' 'SQLManagedInstance'
maintenanceWindow	Definizione di un oggetto MaintenanceWindow	manutenzione Window
Namespace	Ottiene o imposta lo spazio dei nomi della risorsa	corda
visibilità	Ottiene o imposta la visibilità della configurazione. Il valore predefinito è 'Custom'	'Custom' 'Pubblico'

MaintenanceConfigurationPropertiesExtensionProperties

Nome	Descrizione	Valore

MaintenanceConfigurationTags

Nome	Descrizione	Valore

MaintenanceWindow

Nome	Descrizione	Valore
durata	Durata della finestra di manutenzione in formato HH:mm. Se non specificato, il valore predefinito verrà usato in base all'ambito di manutenzione specificato. Esempio: 05:00.	corda
expirationDateTime	Data di scadenza effettiva della finestra di manutenzione in formato AAAA-MM-DD hh:mm. La finestra verrà creata nel fuso orario specificato e regolata in base al fuso orario. La data di scadenza deve essere impostata su una data futura. Se non specificato, verrà impostato sul valore datetime massimo 9999-12-31 23:59:59.	corda
recurEvery	Frequenza di ripetizione di una finestra di manutenzione. Il tasso può essere espresso come pianificazioni giornaliere, settimanali o mensili. La pianificazione giornaliera viene formattata come ricorsiva: [Frequency as integer]['Day/s)']. Se non viene specificata alcuna frequenza, la frequenza predefinita è 1. Gli esempi di pianificazione giornaliera sono ricorsivi: Day, recurEvery: 3Days. La pianificazione settimanale viene formattata come ricorsiva: [Frequenza come numero intero][Settimana/i][Elenco delimitato da virgole facoltativo dei giorni feriali lunedì-domenica]. Gli esempi di pianificazione settimanale sono ricorsiva: 3Weeks, recurEvery: Week Saturday,Sunday. Le pianificazioni mensili vengono formattate come [Frequency as integer]['Month/s)'] [Elenco delimitato da virgole di giorni mensili] o [Frequency as integer]['Month(s)'] [Week of Month (First, Second, Third, Fourth, Last)] [Weekday Monday-Sunday] [Optional Offset(No. of days)]. Il valore di offset deve essere compreso tra -6 e 6 inclusi. Gli esempi di pianificazione mensile sono recurEvery: Month, recurEvery: 2Months, recurevery: Month day23,day24, recurEvery: Month Last Sunday, recury: Month Fourth Monday, recury: Month Last Sunday Offset-3, recury: Month Third Sunday Offset6.	corda
startDateTime	Data di inizio effettiva della finestra di manutenzione in formato AAAA-MM-DD hh:mm. La data di inizio può essere impostata sulla data corrente o sulla data futura. La finestra verrà creata nel fuso orario specificato e regolata in base al fuso orario.	corda
timeZone	Nome del fuso orario. È possibile ottenere l'elenco dei fusi orari eseguendo [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell. Esempio: Ora solare pacifico, UTC, Ora solare W. Europa, Ora solare corea, Cen. Ora solare australia.	corda

Microsoft.Maintenance/maintenanceConfigurations

Nome	Descrizione	Valore
ubicazione	Ottiene o imposta la posizione della risorsa	corda
nome	Nome della risorsa	stringa (obbligatorio)
proprietà	Ottiene o imposta le proprietà della risorsa	MaintenanceConfigurationProperties
Tag	Tag delle risorse	Dizionario di nomi e valori di tag.
digitare	Tipo di risorsa	"Microsoft.Maintenance/maintenanceConfigurations@2023-04-01"

Esempi di utilizzo

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Modulo	Descrizione
Configurazione della manutenzione	Modulo di risorse AVM per la configurazione della manutenzione