Microsoft.Maintenance maintenanceConfigurations
Définition de ressource Bicep
Le type de ressource maintenanceConfigurations peut être déployé avec des opérations qui ciblent :
- Groupes de ressources - Voir 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 des ressources
Pour créer une ressource Microsoft.Maintenance/maintenanceConfigurations, ajoutez le Bicep suivant à votre modèle.
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'
}
}
Valeurs de propriétés
maintenanceConfigurations
Nom | Description | Valeur |
---|---|---|
name | Nom de la ressource | chaîne (obligatoire) |
location | Obtient ou définit l’emplacement de la ressource | string |
tags | Obtient ou définit les étiquettes de la ressource | Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles |
properties | Obtient ou définit les propriétés de la ressource | MaintenanceConfigurationProperties |
MaintenanceConfigurationProperties
Nom | Description | Valeur |
---|---|---|
extensionProperties | Obtient ou définit extensionProperties de maintenanceConfiguration | object |
installPatches | Paramètres d’entrée à passer à l’opération d’exécution de correctif. | InputPatchConfiguration |
maintenanceScope | Obtient ou définit maintenanceScope de la configuration | 'Extension' 'Host' 'InGuestPatch' 'OSImage' 'Ressource' 'SQLDB' 'SQLManagedInstance' |
maintenanceWindow | Définition d’une maintenanceWindow | MaintenanceWindow |
espace de noms | Obtient ou définit l’espace de noms de la ressource | string |
visibility | Obtient ou définit la visibilité de la configuration. La valeur par défaut est ’Custom’ | 'Personnalisé' 'Public' |
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 transmettez pas cette propriété. | InputLinuxParameters |
rebootSetting | Préférence de redémarrage possible telle que 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 de correctif terminée. | 'Always' 'IfRequired' 'Jamais' |
windowsParameters | Paramètres d’entrée spécifiques à la mise à jour corrective d’un ordinateur Windows. Pour les machines Linux, ne transmettez pas cette propriété. | InputWindowsParameters |
InputLinuxParameters
Nom | Description | Valeur |
---|---|---|
classificationsToInclude | Catégorie de classification des correctifs à corriger | string[] |
packageNameMasksToExclude | Noms de package à exclure pour la mise à jour corrective. | string[] |
packageNameMasksToInclude | Noms de package à inclure pour la mise à jour corrective. | string[] |
InputWindowsParameters
Nom | Description | Valeur |
---|---|---|
classificationsToInclude | Catégorie de classification des correctifs à corriger | string[] |
excludeKbsRequiringReboot | Exclure les correctifs nécessitant un redémarrage | bool |
kbNumbersToExclude | KbID Windows à exclure pour la mise à jour corrective. | string[] |
kbNumbersToInclude | KBID Windows à inclure pour la mise à jour corrective. | string[] |
MaintenanceWindow
Nom | Description | Valeur |
---|---|---|
duration | Durée de la fenêtre de maintenance au format HH:MM. Si vous n’indiquez rien, la valeur par défaut est utilisée en fonction de l’étendue de maintenance fournie. Exemple : 05:00. | string |
expirationDateTime | Date d’expiration effective de la fenêtre de maintenance au format AAAA-MM-JJ hh:mm. La fenêtre sera créée dans le fuseau horaire fourni et ajustée à l’heure d’été en fonction de ce fuseau horaire. La date d’expiration doit être fixée à une date ultérieure. Si vous ne l’indiquez pas, le paramètre sera défini sur la date/heure maximale, 9999-12-31 23:59:59. | string |
recurEvery | Taux auquel une fenêtre de maintenance est censée se répéter. La cadence peut être exprimée sous la forme de planifications quotidiennes, hebdomadaires ou mensuelles. La planification quotidienne est mise en forme sous la forme recurEvery : [Fréquence en tant qu’entier][’Day(s)’]. Si aucune fréquence n’est fournie, la fréquence par défaut est 1. Voici des exemples de planifications quotidiennes recurEvery: Day, recurEvery: 3Days. La planification hebdomadaire est mise en forme sous la forme recurEvery : [Frequency as integer][’Week(s)’] [Liste facultative séparée par des virgules des jours de semaine Monday-Sunday]. Voici des exemples de planifications hebdomadaires recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Les planifications mensuelles sont au format [Fréquence en tant qu’entier]['Mois(s)'] [Liste séparée par des virgules des jours de mois] ou [Fréquence en tant qu’entier]['Mois(s)'] [Semaine du mois (Premier, Deuxième, Troisième, Quatrième, Dernier)] [Lundi-Dimanche] [Décalage facultatif(Nombre de 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 Lundi, recurEvery: Month Last Sunday Offset-3, recurEvery: Month Third Sunday Offset6. | string |
startDateTime | Date de début effective de la fenêtre de maintenance au format AAAA-MM-JJ hh:mm. La date de début peut être définie sur la date actuelle ou une date future. La fenêtre sera créée dans le fuseau horaire fourni et ajustée à l’heure d’été en fonction de ce fuseau horaire. | string |
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 d’Australie de l’Est. | string |
Définition de ressources de modèle ARM
Le type de ressource maintenanceConfigurations peut être déployé avec des opérations qui ciblent :
- Groupes de ressources - Voir 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 des ressources
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",
"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"
}
}
Valeurs de propriétés
maintenanceConfigurations
Nom | Description | Valeur |
---|---|---|
type | Type de ressource | « Microsoft.Maintenance/maintenanceConfigurations » |
apiVersion | Version de l’API de ressource | '2023-04-01' |
name | Nom de la ressource | chaîne (obligatoire) |
location | Obtient ou définit l’emplacement de la ressource | string |
tags | Obtient ou définit les étiquettes de la ressource | Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles |
properties | Obtient ou définit les propriétés de la ressource | MaintenanceConfigurationProperties |
MaintenanceConfigurationProperties
Nom | Description | Valeur |
---|---|---|
extensionProperties | Obtient ou définit extensionProperties de maintenanceConfiguration | object |
installPatches | Paramètres d’entrée à passer à l’opération d’exécution de correctif. | InputPatchConfiguration |
maintenanceScope | Obtient ou définit maintenanceScope de la configuration | 'Extension' 'Host' 'InGuestPatch' 'OSImage' 'Ressource' 'SQLDB' 'SQLManagedInstance' |
maintenanceWindow | Définition d’une maintenanceWindow | MaintenanceWindow |
espace de noms | Obtient ou définit l’espace de noms de la ressource | string |
visibility | Obtient ou définit la visibilité de la configuration. La valeur par défaut est ’Custom’ | 'Personnalisé' 'Public' |
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 transmettez pas cette propriété. | InputLinuxParameters |
rebootSetting | Préférence de redémarrage possible telle que 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 de correctif terminée. | 'Always' 'IfRequired' 'Jamais' |
windowsParameters | Paramètres d’entrée spécifiques à la mise à jour corrective d’un ordinateur Windows. Pour les machines Linux, ne transmettez pas cette propriété. | InputWindowsParameters |
InputLinuxParameters
Nom | Description | Valeur |
---|---|---|
classificationsToInclude | Catégorie de classification des correctifs à corriger | string[] |
packageNameMasksToExclude | Noms de package à exclure pour la mise à jour corrective. | string[] |
packageNameMasksToInclude | Noms de package à inclure pour la mise à jour corrective. | string[] |
InputWindowsParameters
Nom | Description | Valeur |
---|---|---|
classificationsToInclude | Catégorie de classification des correctifs à corriger | string[] |
excludeKbsRequiringReboot | Exclure les correctifs nécessitant un redémarrage | bool |
kbNumbersToExclude | KbID Windows à exclure pour la mise à jour corrective. | string[] |
kbNumbersToInclude | KBID Windows à inclure pour la mise à jour corrective. | string[] |
MaintenanceWindow
Nom | Description | Valeur |
---|---|---|
duration | Durée de la fenêtre de maintenance au format HH:MM. Si vous n’indiquez rien, la valeur par défaut est utilisée en fonction de l’étendue de maintenance fournie. Exemple : 05:00. | string |
expirationDateTime | Date d’expiration effective de la fenêtre de maintenance au format AAAA-MM-JJ hh:mm. La fenêtre sera créée dans le fuseau horaire fourni et ajustée à l’heure d’été en fonction de ce fuseau horaire. La date d’expiration doit être fixée à une date ultérieure. Si vous ne l’indiquez pas, le paramètre sera défini sur la date/heure maximale, 9999-12-31 23:59:59. | string |
recurEvery | Taux auquel une fenêtre de maintenance est censée se répéter. La cadence peut être exprimée sous la forme de planifications quotidiennes, hebdomadaires ou mensuelles. La planification quotidienne est mise en forme sous la forme recurEvery : [Fréquence en tant qu’entier][’Day(s)’]. Si aucune fréquence n’est fournie, la fréquence par défaut est 1. Voici des exemples de planifications quotidiennes recurEvery: Day, recurEvery: 3Days. La planification hebdomadaire est mise en forme sous la forme recurEvery : [Frequency as integer][’Week(s)’] [Liste facultative séparée par des virgules des jours de semaine Monday-Sunday]. Voici des exemples de planifications hebdomadaires recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Les planifications mensuelles sont au format [Fréquence en tant qu’entier]['Mois(s)'] [Liste séparée par des virgules des jours de mois] ou [Fréquence en tant qu’entier]['Mois(s)'] [Semaine du mois (Premier, Deuxième, Troisième, Quatrième, Dernier)] [Lundi-Dimanche] [Décalage facultatif(Nombre de 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 Lundi, recurEvery: Month Last Sunday Offset-3, recurEvery: Month Third Sunday Offset6. | string |
startDateTime | Date de début effective de la fenêtre de maintenance au format AAAA-MM-JJ hh:mm. La date de début peut être définie sur la date actuelle ou une date future. La fenêtre sera créée dans le fuseau horaire fourni et ajustée à l’heure d’été en fonction de ce fuseau horaire. | string |
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 d’Australie de l’Est. | string |
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 des ressources
Pour créer une ressource Microsoft.Maintenance/maintenanceConfigurations, ajoutez le Terraform suivant à votre modèle.
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"
}
})
}
Valeurs de propriétés
maintenanceConfigurations
Nom | Description | Valeur |
---|---|---|
type | Type de ressource | « Microsoft.Maintenance/maintenanceConfigurations@2023-04-01 » |
name | Nom de la ressource | chaîne (obligatoire) |
location | Obtient ou définit l’emplacement de la ressource | string |
parent_id | Pour effectuer un déploiement sur un groupe de ressources, utilisez l’ID de ce groupe de ressources. | chaîne (obligatoire) |
tags | Obtient ou définit les étiquettes de la ressource | Dictionnaire de noms et de valeurs d’étiquettes. |
properties | Obtient ou définit les propriétés de la ressource | MaintenanceConfigurationProperties |
MaintenanceConfigurationProperties
Nom | Description | Valeur |
---|---|---|
extensionProperties | Obtient ou définit extensionProperties de maintenanceConfiguration | object |
installPatches | Paramètres d’entrée à passer à l’opération d’exécution de correctif. | InputPatchConfiguration |
maintenanceScope | Obtient ou définit maintenanceScope de la configuration | « Extension » « Hôte » « InGuestPatch » « OSImage » "Resource" « SQLDB » « SQLManagedInstance » |
maintenanceWindow | Définition d’une maintenanceWindow | MaintenanceWindow |
espace de noms | Obtient ou définit l’espace de noms de la ressource | string |
visibility | Obtient ou définit la visibilité de la configuration. La valeur par défaut est ’Custom’ | "Custom" « Public » |
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 transmettez pas cette propriété. | InputLinuxParameters |
rebootSetting | Préférence de redémarrage possible telle que 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 de correctif terminée. | « Always » « IfRequired » « Jamais » |
windowsParameters | Paramètres d’entrée spécifiques à la mise à jour corrective d’un ordinateur Windows. Pour les machines Linux, ne transmettez pas cette propriété. | InputWindowsParameters |
InputLinuxParameters
Nom | Description | Valeur |
---|---|---|
classificationsToInclude | Catégorie de classification des correctifs à corriger | string[] |
packageNameMasksToExclude | Noms de package à exclure pour la mise à jour corrective. | string[] |
packageNameMasksToInclude | Noms de package à inclure pour la mise à jour corrective. | string[] |
InputWindowsParameters
Nom | Description | Valeur |
---|---|---|
classificationsToInclude | Catégorie de classification des correctifs à corriger | string[] |
excludeKbsRequiringReboot | Exclure les correctifs nécessitant un redémarrage | bool |
kbNumbersToExclude | KbID Windows à exclure pour la mise à jour corrective. | string[] |
kbNumbersToInclude | KBID Windows à inclure pour la mise à jour corrective. | string[] |
MaintenanceWindow
Nom | Description | Valeur |
---|---|---|
duration | Durée de la fenêtre de maintenance au format HH:MM. Si vous n’indiquez rien, la valeur par défaut est utilisée en fonction de l’étendue de maintenance fournie. Exemple : 05:00. | string |
expirationDateTime | Date d’expiration effective de la fenêtre de maintenance au format AAAA-MM-JJ hh:mm. La fenêtre sera créée dans le fuseau horaire fourni et ajustée à l’heure d’été en fonction de ce fuseau horaire. La date d’expiration doit être fixée à une date ultérieure. Si vous ne l’indiquez pas, le paramètre sera défini sur la date/heure maximale, 9999-12-31 23:59:59. | string |
recurEvery | Taux auquel une fenêtre de maintenance est censée se répéter. La cadence peut être exprimée sous la forme de planifications quotidiennes, hebdomadaires ou mensuelles. La planification quotidienne est mise en forme sous la forme recurEvery : [Fréquence en tant qu’entier][’Day(s)’]. Si aucune fréquence n’est fournie, la fréquence par défaut est 1. Voici des exemples de planifications quotidiennes recurEvery: Day, recurEvery: 3Days. La planification hebdomadaire est mise en forme sous la forme recurEvery : [Frequency as integer][’Week(s)’] [Liste facultative séparée par des virgules des jours de semaine Monday-Sunday]. Voici des exemples de planifications hebdomadaires recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Les planifications mensuelles sont au format [Fréquence en tant qu’entier]['Mois(s)'] [Liste séparée par des virgules des jours de mois] ou [Fréquence en tant qu’entier]['Mois(s)'] [Semaine du mois (Premier, Deuxième, Troisième, Quatrième, Dernier)] [Lundi-Dimanche] [Décalage facultatif(Non de 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. | string |
startDateTime | Date de début effective de la fenêtre de maintenance au format AAAA-MM-JJ hh:mm. La date de début peut être définie sur la date actuelle ou une date future. La fenêtre sera créée dans le fuseau horaire fourni et ajustée à l’heure d’été en fonction de ce fuseau horaire. | string |
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 d’Australie de l’Est. | string |