New-AzMaintenanceConfiguration

Syntaxe

Default (Par défaut)

New-AzMaintenanceConfiguration
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-Location] <String>
    [-Tag <Hashtable>]
    [-ExtensionProperty <Hashtable>]
    [-MaintenanceScope <String>]
    [-StartDateTime <String>]
    [-ExpirationDateTime <String>]
    [-Timezone <String>]
    [-Duration <TimeSpan>]
    [-Visibility <String>]
    [-RecurEvery <String>]
    [-LinuxParameterPackageNameMaskToInclude <System.Collections.Generic.HashSet`1[System.String]>]
    [-LinuxParameterPackageNameMaskToExclude <System.Collections.Generic.HashSet`1[System.String]>]
    [-LinuxParameterClassificationToInclude <System.Collections.Generic.HashSet`1[System.String]>]
    [-WindowParameterKbNumberToInclude <System.Collections.Generic.HashSet`1[System.String]>]
    [-WindowParameterKbNumberToExclude <System.Collections.Generic.HashSet`1[System.String]>]
    [-WindowParameterClassificationToInclude <System.Collections.Generic.HashSet`1[System.String]>]
    [-WindowParameterExcludeKbRequiringReboot <Boolean>]
    [-InstallPatchRebootSetting <String>]
    [-PreTask <String>]
    [-PostTask <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exemples

Exemple 1

New-AzMaintenanceConfiguration -ResourceGroupName smdtest -Name workervmscentralus -MaintenanceScope Host -Location centralus -StartDateTime "2020-08-01 00:00" -ExpirationDateTime "2021-08-04 00:00" -Timezone "Pacific Standard Time" -Duration 05:00 -RecurEvery Day

Location            : centralus
Tags                : {}
ExtensionProperties : {}
MaintenanceScope    : Host
StartDateTime       : 2020-08-01 00:00
ExpirationDateTime  : 2021-08-04 00:00
TimeZone            : Pacific Standard Time
RecurEvery          : Day
Duration            : 05:00
MaintenanceScope    : Host
Visibility          : Custom
Id                  : /subscriptions/42c974dd-2c03-4f1b-96ad-b07f050aaa74/resourcegroups/smdtest/providers/Microsoft.Maintenance/maintenanceConfigurations/workervmscentralus
Name                : workervmscentralus
Type                : Microsoft.Maintenance/maintenanceConfigurations

Exemple 2

New-AzMaintenanceConfiguration -ResourceGroupName sample-rg  -Name PatchSchedule -MaintenanceScope "InGuestPatch" -Location westeurope -Timezone "UTC" -StartDateTime "2025-10-09 12:30" -Duration "3:00" -RecurEvery "Day" -LinuxParameterClassificationToInclude @('Other') -LinuxParameterPackageNameMaskToInclude @('lib', 'kernel') -LinuxParameterPackageNameMaskToExclude @('curl', 'vim') -WindowParameterClassificationToInclude @('Critical', 'Security') -WindowParameterKbNumberToInclude @('5035849', '5035857') -WindowParameterKbNumberToExclude @('5034439')  -ExtensionProperty @{inGuestPatchMode="User"} -InstallPatchRebootSetting "IfRequired"  -Debug

Location                               : westeurope
Tags                                   : {"resource":"test"}
ExtensionProperties                    : {"inGuestPatchMode":"User"}
MaintenanceScope                       : InGuestPatch
Id                                     :
/subscriptions/783fd652-64f3-4680-81e9-0b978c542005/resourcegroups/sample-rg/providers/Microsoft.Maintenance/maintenanceConfigurations/PatchSchedule
Name                                   : PatchSchedule
Type                                   : Microsoft.Maintenance/maintenanceConfigurations
StartDateTime                          : 2025-10-09 12:30
Duration                               : 03:00
Timezone                               : UTC
Visibility                             : Custom
RecurEvery                             : Day
LinuxParameterClassificationToInclude  :
LinuxParameterPackageNameMaskToExclude :
LinuxParameterPackageNameMaskToInclude : apt
                                         httpd
WindowParameterKbNumberToInclude       :
WindowParameterKbNumberToExclude       :
WindowParameterClassificationToInclude :
InstallPatchRebootSetting              : IfRequired

Paramètres

-AsJob

Exécuter l’applet de commande en arrière-plan

Propriétés du paramètre

Jeux de paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Jeux de paramètres

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Jeux de paramètres

-Duration

Durée

Propriétés du paramètre

Jeux de paramètres

-ExpirationDateTime

ExpirationDateTime de la planification au format AAAA -MM-DD hh :mm

Propriétés du paramètre

Jeux de paramètres

-ExtensionProperty

Propriétés d’extension par ressource.

Propriétés du paramètre

Jeux de paramètres

-InstallPatchRebootSetting

Installer l’option de redémarrage du correctif. Valeurs autorisées Never, IfRequired, Always

Propriétés du paramètre

Jeux de paramètres

-LinuxParameterClassificationToInclude

Liste des classifications de correctifs Linux. Les valeurs autorisées sont « Critique », « Sécurité » et « Autre ».

Propriétés du paramètre

Jeux de paramètres

-LinuxParameterPackageNameMaskToExclude

Liste des packages à exclure pendant l’opération de correctif de machine virtuelle

Propriétés du paramètre

Jeux de paramètres

-LinuxParameterPackageNameMaskToInclude

Liste des packages à inclure pendant l’opération de correctif de machine virtuelle

Propriétés du paramètre

Jeux de paramètres

-Location

Emplacement de configuration de la maintenance.

Propriétés du paramètre

Jeux de paramètres

-MaintenanceScope

Étendue de maintenance.

Propriétés du paramètre

Jeux de paramètres

-Name

Nom de la configuration de maintenance.

Propriétés du paramètre

Jeux de paramètres

-PostTask

Liste des tâches exécutées après la planification. [{'source' :'runbook', 'taskScope' : 'Resource', 'parameters' : { 'arg1' : 'value1'}]. Ce paramètre est utilisé pour spécifier une commande ou un script qui doit être exécuté une fois les tâches de maintenance effectuées. Cela peut être utilisé pour effectuer toutes les actions de suivi nécessaires une fois les tâches de maintenance terminées. Ce paramètre accepte une valeur de chaîne qui spécifie la commande ou le script à exécuter. La commande ou le script peut être spécifié sous la forme d’une chaîne simple ou d’un tableau de chaînes. Si un tableau de chaînes est spécifié, chaque élément du tableau est traité comme une commande ou un script distinct.

Propriétés du paramètre

Jeux de paramètres

-PreTask

Liste des tâches exécutées avant la planification. Par exemple, [{'source' :'runbook', 'taskScope' : 'Global', 'parameters' : { 'arg1' : 'value1'}}]. Ce paramètre est utilisé pour spécifier une commande ou un script qui doit être exécuté avant l’exécution des tâches de maintenance. Cela peut être utilisé pour effectuer toutes les préparations ou actions de nettoyage nécessaires avant l’exécution des tâches de maintenance. Ce paramètre accepte une valeur de chaîne qui spécifie la commande ou le script à exécuter. La commande ou le script peut être spécifié sous la forme d’une chaîne simple ou d’un tableau de chaînes. Si un tableau de chaînes est spécifié, chaque élément du tableau est traité comme une commande ou un script distinct.

Propriétés du paramètre

Jeux de paramètres

-RecurEvery

Périodicité de la planification

Propriétés du paramètre

Jeux de paramètres

-ResourceGroupName

Nom du groupe de ressources.

Propriétés du paramètre

Jeux de paramètres

-StartDateTime

StartDateTime de la planification au format AAAA-MM-DD hh :mm

Propriétés du paramètre

Jeux de paramètres

-Tag

Balises ARM.

Propriétés du paramètre

Jeux de paramètres

-Timezone

Fuseau horaire

Propriétés du paramètre

Jeux de paramètres

-Visibility

Visibilité de l’étendue

Propriétés du paramètre

Jeux de paramètres

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Jeux de paramètres

-WindowParameterClassificationToInclude

Liste de la classification des correctifs Windows. Les valeurs autorisées sont « Critical », « Security », « UpdateRollup », « FeaturePack », « ServicePack », « Definition », « Tools » et « Updates ».

Propriétés du paramètre

Jeux de paramètres

-WindowParameterExcludeKbRequiringReboot

Exclure les ko qui nécessitent un redémarrage

Propriétés du paramètre

Jeux de paramètres

-WindowParameterKbNumberToExclude

Liste des ko à exclure pendant l’opération de correctif de machine virtuelle

Propriétés du paramètre

Jeux de paramètres

-WindowParameterKbNumberToInclude

Liste des ko à inclure pendant l’opération de correctif de machine virtuelle

Propriétés du paramètre

Jeux de paramètres

CommonParameters

Entrées

String

Sorties

PSMaintenanceConfiguration