New-AzMaintenanceConfiguration

Sintaxis

Default (valor predeterminado)

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

Ejemplos

Ejemplo 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

Ejemplo 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

Parámetros

-AsJob

Ejecución del cmdlet en segundo plano

Propiedades de parámetro

Conjuntos de parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Conjuntos de parámetros

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Propiedades de parámetro

Conjuntos de parámetros

-Duration

Duración

Propiedades de parámetro

Conjuntos de parámetros

-ExpirationDateTime

ExpirationDateTime de la programación con formato AAAA-MM-DD hh:mm

Propiedades de parámetro

Conjuntos de parámetros

-ExtensionProperty

Propiedades de extensión por recurso.

Propiedades de parámetro

Conjuntos de parámetros

-InstallPatchRebootSetting

Instale la opción de reinicio de revisiones. Valores permitidos Never, IfRequired, Always

Propiedades de parámetro

Conjuntos de parámetros

-LinuxParameterClassificationToInclude

Lista de clasificaciones de revisiones de Linux. Los valores permitidos son "Critical", "Security" y "Other".

Propiedades de parámetro

Conjuntos de parámetros

-LinuxParameterPackageNameMaskToExclude

Lista de paquetes que se van a excluir durante la operación de revisión de máquina virtual

Propiedades de parámetro

Conjuntos de parámetros

-LinuxParameterPackageNameMaskToInclude

Lista de paquetes que se van a incluir durante la operación de revisión de máquina virtual

Propiedades de parámetro

Conjuntos de parámetros

-Location

Ubicación de configuración de mantenimiento.

Propiedades de parámetro

Conjuntos de parámetros

-MaintenanceScope

Ámbito de mantenimiento.

Propiedades de parámetro

Conjuntos de parámetros

-Name

Nombre de configuración de mantenimiento.

Propiedades de parámetro

Conjuntos de parámetros

-PostTask

Lista de tareas ejecutadas después de la programación. [{'source' :'runbook', 'taskScope': 'Resource', 'parameters': { 'arg1': 'value1'}}]. Este parámetro se usa para especificar un comando o script que se debe ejecutar después de realizar las tareas de mantenimiento. Esto se puede usar para realizar las acciones de seguimiento necesarias una vez completadas las tareas de mantenimiento. Este parámetro acepta un valor de cadena que especifica el comando o script que se va a ejecutar. El comando o script se puede especificar como una cadena simple o como una matriz de cadenas. Si se especifica una matriz de cadenas, cada elemento de la matriz se tratará como un comando o script independiente.

Propiedades de parámetro

Conjuntos de parámetros

-PreTask

Lista de tareas ejecutadas antes de la programación. Por ejemplo, [{'source' :'runbook', 'taskScope': 'Global', 'parameters': { 'arg1': 'value1'}}]. Este parámetro se usa para especificar un comando o script que se debe ejecutar antes de que se realicen las tareas de mantenimiento. Esto se puede usar para realizar cualquier preparación necesaria o acciones de limpieza antes de que se ejecuten las tareas de mantenimiento. Este parámetro acepta un valor de cadena que especifica el comando o script que se va a ejecutar. El comando o script se puede especificar como una cadena simple o como una matriz de cadenas. Si se especifica una matriz de cadenas, cada elemento de la matriz se tratará como un comando o script independiente.

Propiedades de parámetro

Conjuntos de parámetros

-RecurEvery

Periodicidad de la programación

Propiedades de parámetro

Conjuntos de parámetros

-ResourceGroupName

Nombre del grupo de recursos.

Propiedades de parámetro

Conjuntos de parámetros

-StartDateTime

StartDateTime de la programación con formato AAAA-MM-DD hh:mm

Propiedades de parámetro

Conjuntos de parámetros

-Tag

Etiquetas arm.

Propiedades de parámetro

Conjuntos de parámetros

-Timezone

La zona horaria

Propiedades de parámetro

Conjuntos de parámetros

-Visibility

Visibilidad del ámbito

Propiedades de parámetro

Conjuntos de parámetros

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Conjuntos de parámetros

-WindowParameterClassificationToInclude

Lista de la clasificación de revisiones de Windows. Los valores permitidos son "Critical", "Security", "UpdateRollup", "FeaturePack", "ServicePack", "Definition", "Tools" y "Updates".

Propiedades de parámetro

Conjuntos de parámetros

-WindowParameterExcludeKbRequiringReboot

Exclusión de kb que requieren reinicio

Propiedades de parámetro

Conjuntos de parámetros

-WindowParameterKbNumberToExclude

Lista de kb que se van a excluir durante la operación de revisión de máquina virtual

Propiedades de parámetro

Conjuntos de parámetros

-WindowParameterKbNumberToInclude

Lista de kb que se van a incluir durante la operación de revisión de máquina virtual

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

String

Salidas

PSMaintenanceConfiguration