Microsoft.Maintenance MaintenanceConfigurations 2023-04-01

Article
2025-01-28

Définition de ressource Bicep

Le type de ressource maintenanceConfigurations peut être déployé avec des opérations qui ciblent :

groupes de ressources - Consultez commandes de déploiement de groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Maintenance/maintenanceConfigurations, ajoutez le bicep suivant à votre modèle.

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'
  }
}

Valeurs de propriété

InputLinuxParameters

Nom	Description	Valeur
classificationsToInclude	Catégorie de classification des correctifs à corriger. Les valeurs autorisées sont « Critique », « Sécurité » et « Autre ».	string[]
packageNameMasksToExclude	Noms de package à exclure pour la mise à jour corrective.	string[]
packageNameMasksToInclude	Noms de package à inclure pour la mise à jour corrective.	string[]

InputPatchConfiguration

Nom	Description	Valeur
linuxParameters	Paramètres d’entrée spécifiques à la mise à jour corrective de la machine Linux. Pour les machines Windows, ne passez pas cette propriété.	InputLinuxParameters
rebootSetting	Préférence de redémarrage possible définie par l’utilisateur en fonction de laquelle il serait décidé de redémarrer l’ordinateur ou non une fois l’opération corrective terminée.	'Always' 'IfRequired' 'Never'
windowsParameters	Paramètres d’entrée spécifiques à la mise à jour corrective d’une machine Windows. Pour les machines Linux, ne transmettez pas cette propriété.	InputWindowsParameters

InputWindowsParameters

Nom	Description	Valeur
classificationsToInclude	Catégorie de classification des correctifs à corriger. Les valeurs autorisées sont « Critical », « Security », « UpdateRollup », « FeaturePack », « ServicePack », « Definition », « Tools » et « Updates ».	string[]
excludeKbsRequiringReboot	Exclure les correctifs qui nécessitent un redémarrage	Bool
kbNumbersToExclude	Id de base de connaissances Windows à exclure pour la mise à jour corrective.	string[]
kbNumbersToInclude	KBID Windows à inclure pour la mise à jour corrective.	string[]

MaintenanceConfigurationProperties

Nom	Description	Valeur
extensionProperties	Obtient ou définit extensionProperties de maintenanceConfiguration	MaintenanceConfigurationPropertiesExtensionProperties
installPatches	Paramètres d’entrée à passer à l’opération d’exécution du correctif.	InputPatchConfiguration
maintenanceScope	Obtient ou définit maintenanceScope de la configuration	'Extension' 'Host' 'InGuestPatch' 'OSImage' 'Resource' 'SQLDB' 'SQLManagedInstance'
maintenanceWindow	Définition d’un MaintenanceWindow	MaintenanceWindow
Namespace	Obtient ou définit l’espace de noms de la ressource	corde
visibilité	Obtient ou définit la visibilité de la configuration. La valeur par défaut est « Custom »	'Custom' 'Public'

MaintenanceConfigurationPropertiesExtensionProperties

Nom	Description	Valeur

MaintenanceConfigurationTags

Nom	Description	Valeur

MaintenanceWindow

Nom	Description	Valeur
durée	Durée de la fenêtre de maintenance au format HH :mm. Si elle n’est pas fournie, la valeur par défaut est utilisée en fonction de l’étendue de maintenance fournie. Exemple : 05:00.	corde
expirationDateTime	Date d’expiration effective de la fenêtre de maintenance au format aaaa-MM-DD hh :mm. La fenêtre sera créée dans le fuseau horaire fourni et ajustée aux économies d’été en fonction de ce fuseau horaire. La date d’expiration doit être définie sur une date ultérieure. S’il n’est pas fourni, il est défini sur la date maximale de datetime 9999-12-31 23:59:59.	corde
recurEvery	Fréquence à laquelle une fenêtre maintenance est censée se reproduire. Le taux peut être exprimé sous forme de planifications quotidiennes, hebdomadaires ou mensuelles. La planification quotidienne est mise en forme sous forme de récurrité : [Fréquence en tant qu’entier]['Jour(s)']. Si aucune fréquence n’est fournie, la fréquence par défaut est 1. Les exemples de planification quotidienne sont recurEvery : Day, recurEvery : 3Days. La planification hebdomadaire est mise en forme sous forme de récurrité : [Fréquence en tant qu’entier]['Semaine(s)'] [Liste séparée par des virgules facultatives du lundi au dimanche]. Les exemples de planification hebdomadaire sont recurEvery : 3Weeks, recurEvery : Week Saturday,Sunday. Les planifications mensuelles sont mises en forme comme [Fréquence sous forme d’entier]['Mois(s)'] [Liste séparée par des virgules des jours du mois] ou [Fréquence sous forme d’entier]['Mois(s)'] [Semaine du mois (Premier, Deuxième, Troisième, Quatrième, Last)] [Lundi-dimanche en semaine] [Décalage facultatif (Non. jours)]. La valeur de décalage doit être comprise entre -6 et 6 inclus. Les exemples de planification mensuelle sont 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.	corde
startDateTime	Date de début effective de la fenêtre de maintenance au format aaaa-MM-DD hh :mm. La date de début peut être définie sur la date actuelle ou la date ultérieure. La fenêtre sera créée dans le fuseau horaire fourni et ajustée aux économies d’été en fonction de ce fuseau horaire.	corde
timeZone	Nom du fuseau horaire. Vous pouvez obtenir la liste des fuseaux horaires en exécutant [System.TimeZoneInfo] ::GetSystemTimeZones() dans PowerShell. Exemple : Heure standard du Pacifique, UTC, W. Europe Standard Time, Corée Standard Time, Cen. Heure standard de l’Australie.	corde

Microsoft.Maintenance/maintenanceConfigurations

Nom	Description	Valeur
emplacement	Obtient ou définit l’emplacement de la ressource	corde
nom	Nom de la ressource	chaîne (obligatoire)
Propriétés	Obtient ou définit les propriétés de la ressource	MaintenanceConfigurationProperties
étiquettes	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

Exemples d’utilisation

Modules vérifiés Azure

Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.

Module	Description
Configuration de maintenance	Module de ressources AVM pour la configuration de la maintenance

Définition de ressource de modèle ARM

Le type de ressource maintenanceConfigurations peut être déployé avec des opérations qui ciblent :

groupes de ressources - Consultez commandes de déploiement de groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Maintenance/maintenanceConfigurations, ajoutez le code JSON suivant à votre modèle.

{
  "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"
  }
}

Valeurs de propriété

InputLinuxParameters

Nom	Description	Valeur
classificationsToInclude	Catégorie de classification des correctifs à corriger. Les valeurs autorisées sont « Critique », « Sécurité » et « Autre ».	string[]
packageNameMasksToExclude	Noms de package à exclure pour la mise à jour corrective.	string[]
packageNameMasksToInclude	Noms de package à inclure pour la mise à jour corrective.	string[]

InputPatchConfiguration

Nom	Description	Valeur
linuxParameters	Paramètres d’entrée spécifiques à la mise à jour corrective de la machine Linux. Pour les machines Windows, ne passez pas cette propriété.	InputLinuxParameters
rebootSetting	Préférence de redémarrage possible définie par l’utilisateur en fonction de laquelle il serait décidé de redémarrer l’ordinateur ou non une fois l’opération corrective terminée.	'Always' 'IfRequired' 'Never'
windowsParameters	Paramètres d’entrée spécifiques à la mise à jour corrective d’une machine Windows. Pour les machines Linux, ne transmettez pas cette propriété.	InputWindowsParameters

InputWindowsParameters

Nom	Description	Valeur
classificationsToInclude	Catégorie de classification des correctifs à corriger. Les valeurs autorisées sont « Critical », « Security », « UpdateRollup », « FeaturePack », « ServicePack », « Definition », « Tools » et « Updates ».	string[]
excludeKbsRequiringReboot	Exclure les correctifs qui nécessitent un redémarrage	Bool
kbNumbersToExclude	Id de base de connaissances Windows à exclure pour la mise à jour corrective.	string[]
kbNumbersToInclude	KBID Windows à inclure pour la mise à jour corrective.	string[]

MaintenanceConfigurationProperties

Nom	Description	Valeur
extensionProperties	Obtient ou définit extensionProperties de maintenanceConfiguration	MaintenanceConfigurationPropertiesExtensionProperties
installPatches	Paramètres d’entrée à passer à l’opération d’exécution du correctif.	InputPatchConfiguration
maintenanceScope	Obtient ou définit maintenanceScope de la configuration	'Extension' 'Host' 'InGuestPatch' 'OSImage' 'Resource' 'SQLDB' 'SQLManagedInstance'
maintenanceWindow	Définition d’un MaintenanceWindow	MaintenanceWindow
Namespace	Obtient ou définit l’espace de noms de la ressource	corde
visibilité	Obtient ou définit la visibilité de la configuration. La valeur par défaut est « Custom »	'Custom' 'Public'

MaintenanceConfigurationPropertiesExtensionProperties

Nom	Description	Valeur

MaintenanceConfigurationTags

Nom	Description	Valeur

MaintenanceWindow

Nom	Description	Valeur
durée	Durée de la fenêtre de maintenance au format HH :mm. Si elle n’est pas fournie, la valeur par défaut est utilisée en fonction de l’étendue de maintenance fournie. Exemple : 05:00.	corde
expirationDateTime	Date d’expiration effective de la fenêtre de maintenance au format aaaa-MM-DD hh :mm. La fenêtre sera créée dans le fuseau horaire fourni et ajustée aux économies d’été en fonction de ce fuseau horaire. La date d’expiration doit être définie sur une date ultérieure. S’il n’est pas fourni, il est défini sur la date maximale de datetime 9999-12-31 23:59:59.	corde
recurEvery	Fréquence à laquelle une fenêtre maintenance est censée se reproduire. Le taux peut être exprimé sous forme de planifications quotidiennes, hebdomadaires ou mensuelles. La planification quotidienne est mise en forme sous forme de récurrité : [Fréquence en tant qu’entier]['Jour(s)']. Si aucune fréquence n’est fournie, la fréquence par défaut est 1. Les exemples de planification quotidienne sont recurEvery : Day, recurEvery : 3Days. La planification hebdomadaire est mise en forme sous forme de récurrité : [Fréquence en tant qu’entier]['Semaine(s)'] [Liste séparée par des virgules facultatives du lundi au dimanche]. Les exemples de planification hebdomadaire sont recurEvery : 3Weeks, recurEvery : Week Saturday,Sunday. Les planifications mensuelles sont mises en forme comme [Fréquence sous forme d’entier]['Mois(s)'] [Liste séparée par des virgules des jours du mois] ou [Fréquence sous forme d’entier]['Mois(s)'] [Semaine du mois (Premier, Deuxième, Troisième, Quatrième, Last)] [Lundi-dimanche en semaine] [Décalage facultatif (Non. jours)]. La valeur de décalage doit être comprise entre -6 et 6 inclus. Les exemples de planification mensuelle sont 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.	corde
startDateTime	Date de début effective de la fenêtre de maintenance au format aaaa-MM-DD hh :mm. La date de début peut être définie sur la date actuelle ou la date ultérieure. La fenêtre sera créée dans le fuseau horaire fourni et ajustée aux économies d’été en fonction de ce fuseau horaire.	corde
timeZone	Nom du fuseau horaire. Vous pouvez obtenir la liste des fuseaux horaires en exécutant [System.TimeZoneInfo] ::GetSystemTimeZones() dans PowerShell. Exemple : Heure standard du Pacifique, UTC, W. Europe Standard Time, Corée Standard Time, Cen. Heure standard de l’Australie.	corde

Microsoft.Maintenance/maintenanceConfigurations

Nom	Description	Valeur
apiVersion	Version de l’API	'2023-04-01'
emplacement	Obtient ou définit l’emplacement de la ressource	corde
nom	Nom de la ressource	chaîne (obligatoire)
Propriétés	Obtient ou définit les propriétés de la ressource	MaintenanceConfigurationProperties
étiquettes	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type	Type de ressource	'Microsoft.Maintenance/maintenanceConfigurations'

Exemples d’utilisation

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource maintenanceConfigurations peut être déployé avec des opérations qui ciblent :

groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Maintenance/maintenanceConfigurations, ajoutez terraform suivant à votre modèle.

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

Valeurs de propriété

InputLinuxParameters

Nom	Description	Valeur
classificationsToInclude	Catégorie de classification des correctifs à corriger. Les valeurs autorisées sont « Critique », « Sécurité » et « Autre ».	string[]
packageNameMasksToExclude	Noms de package à exclure pour la mise à jour corrective.	string[]
packageNameMasksToInclude	Noms de package à inclure pour la mise à jour corrective.	string[]

InputPatchConfiguration

Nom	Description	Valeur
linuxParameters	Paramètres d’entrée spécifiques à la mise à jour corrective de la machine Linux. Pour les machines Windows, ne passez pas cette propriété.	InputLinuxParameters
rebootSetting	Préférence de redémarrage possible définie par l’utilisateur en fonction de laquelle il serait décidé de redémarrer l’ordinateur ou non une fois l’opération corrective terminée.	'Always' 'IfRequired' 'Never'
windowsParameters	Paramètres d’entrée spécifiques à la mise à jour corrective d’une machine Windows. Pour les machines Linux, ne transmettez pas cette propriété.	InputWindowsParameters

InputWindowsParameters

Nom	Description	Valeur
classificationsToInclude	Catégorie de classification des correctifs à corriger. Les valeurs autorisées sont « Critical », « Security », « UpdateRollup », « FeaturePack », « ServicePack », « Definition », « Tools » et « Updates ».	string[]
excludeKbsRequiringReboot	Exclure les correctifs qui nécessitent un redémarrage	Bool
kbNumbersToExclude	Id de base de connaissances Windows à exclure pour la mise à jour corrective.	string[]
kbNumbersToInclude	KBID Windows à inclure pour la mise à jour corrective.	string[]

MaintenanceConfigurationProperties

Nom	Description	Valeur
extensionProperties	Obtient ou définit extensionProperties de maintenanceConfiguration	MaintenanceConfigurationPropertiesExtensionProperties
installPatches	Paramètres d’entrée à passer à l’opération d’exécution du correctif.	InputPatchConfiguration
maintenanceScope	Obtient ou définit maintenanceScope de la configuration	'Extension' 'Host' 'InGuestPatch' 'OSImage' 'Resource' 'SQLDB' 'SQLManagedInstance'
maintenanceWindow	Définition d’un MaintenanceWindow	MaintenanceWindow
Namespace	Obtient ou définit l’espace de noms de la ressource	corde
visibilité	Obtient ou définit la visibilité de la configuration. La valeur par défaut est « Custom »	'Custom' 'Public'

MaintenanceConfigurationPropertiesExtensionProperties

Nom	Description	Valeur

MaintenanceConfigurationTags

Nom	Description	Valeur

MaintenanceWindow

Nom	Description	Valeur
durée	Durée de la fenêtre de maintenance au format HH :mm. Si elle n’est pas fournie, la valeur par défaut est utilisée en fonction de l’étendue de maintenance fournie. Exemple : 05:00.	corde
expirationDateTime	Date d’expiration effective de la fenêtre de maintenance au format aaaa-MM-DD hh :mm. La fenêtre sera créée dans le fuseau horaire fourni et ajustée aux économies d’été en fonction de ce fuseau horaire. La date d’expiration doit être définie sur une date ultérieure. S’il n’est pas fourni, il est défini sur la date maximale de datetime 9999-12-31 23:59:59.	corde
recurEvery	Fréquence à laquelle une fenêtre maintenance est censée se reproduire. Le taux peut être exprimé sous forme de planifications quotidiennes, hebdomadaires ou mensuelles. La planification quotidienne est mise en forme sous forme de récurrité : [Fréquence en tant qu’entier]['Jour(s)']. Si aucune fréquence n’est fournie, la fréquence par défaut est 1. Les exemples de planification quotidienne sont recurEvery : Day, recurEvery : 3Days. La planification hebdomadaire est mise en forme sous forme de récurrité : [Fréquence en tant qu’entier]['Semaine(s)'] [Liste séparée par des virgules facultatives du lundi au dimanche]. Les exemples de planification hebdomadaire sont recurEvery : 3Weeks, recurEvery : Week Saturday,Sunday. Les planifications mensuelles sont mises en forme comme [Fréquence sous forme d’entier]['Mois(s)'] [Liste séparée par des virgules des jours du mois] ou [Fréquence sous forme d’entier]['Mois(s)'] [Semaine du mois (Premier, Deuxième, Troisième, Quatrième, Last)] [Lundi-dimanche en semaine] [Décalage facultatif (Non. jours)]. La valeur de décalage doit être comprise entre -6 et 6 inclus. Les exemples de planification mensuelle sont 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.	corde
startDateTime	Date de début effective de la fenêtre de maintenance au format aaaa-MM-DD hh :mm. La date de début peut être définie sur la date actuelle ou la date ultérieure. La fenêtre sera créée dans le fuseau horaire fourni et ajustée aux économies d’été en fonction de ce fuseau horaire.	corde
timeZone	Nom du fuseau horaire. Vous pouvez obtenir la liste des fuseaux horaires en exécutant [System.TimeZoneInfo] ::GetSystemTimeZones() dans PowerShell. Exemple : Heure standard du Pacifique, UTC, W. Europe Standard Time, Corée Standard Time, Cen. Heure standard de l’Australie.	corde

Microsoft.Maintenance/maintenanceConfigurations

Nom	Description	Valeur
emplacement	Obtient ou définit l’emplacement de la ressource	corde
nom	Nom de la ressource	chaîne (obligatoire)
Propriétés	Obtient ou définit les propriétés de la ressource	MaintenanceConfigurationProperties
étiquettes	Balises de ressource	Dictionnaire de noms et de valeurs d’étiquettes.
type	Type de ressource	« Microsoft.Maintenance/maintenanceConfigurations@2023-04-01 »

Partager via

Microsoft.Maintenance MaintenanceConfigurations 2023-04-01

Définition de ressource Bicep

Format de ressource

Valeurs de propriété

InputLinuxParameters

InputPatchConfiguration

InputWindowsParameters

MaintenanceConfigurationProperties

MaintenanceConfigurationPropertiesExtensionProperties

MaintenanceConfigurationTags

MaintenanceWindow

Microsoft.Maintenance/maintenanceConfigurations

Exemples d’utilisation

Modules vérifiés Azure

Définition de ressource de modèle ARM

Format de ressource

Valeurs de propriété

InputLinuxParameters

InputPatchConfiguration

InputWindowsParameters

MaintenanceConfigurationProperties

MaintenanceConfigurationPropertiesExtensionProperties

MaintenanceConfigurationTags

MaintenanceWindow

Microsoft.Maintenance/maintenanceConfigurations

Exemples d’utilisation

Définition de ressource Terraform (fournisseur AzAPI)

Format de ressource

Valeurs de propriété

InputLinuxParameters

InputPatchConfiguration

InputWindowsParameters

MaintenanceConfigurationProperties

MaintenanceConfigurationPropertiesExtensionProperties

MaintenanceConfigurationTags

MaintenanceWindow

Microsoft.Maintenance/maintenanceConfigurations

Commentaires

Ressources supplémentaires