Compartilhar via

New-AzMaintenanceConfiguration

  • Referência
Módulo:
Az.Maintenance

Criar ou atualizar o registro de configuração

Sintaxe

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

Criar ou atualizar o registro de configuração

Exemplos

Exemplo 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

Criar uma configuração de manutenção com o host de escopo

Exemplo 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

Criar uma configuração de manutenção com o escopo InGuest

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Duration

A duração

Tipo:TimeSpan
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ExpirationDateTime

O expirationDateTime do agendamento no formato YYYY-MM-DD hh:mm

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ExtensionProperty

As propriedades de extensão por recurso.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InstallPatchRebootSetting

Opção Instalar Reinicialização de Patch. Valores permitidos Never, IfRequired, Always

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LinuxParameterClassificationToInclude

Lista de classificações de patch do Linux. Os valores permitidos são 'Crítico', 'Segurança' e 'Outro'.

Tipo:HashSet<T>[String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LinuxParameterPackageNameMaskToExclude

Lista de pacotes a serem excluídos durante a operação de patch de vm

Tipo:HashSet<T>[String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LinuxParameterPackageNameMaskToInclude

Lista de pacotes a serem incluídos durante a operação de patch de VM

Tipo:HashSet<T>[String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Location

O local de configuração de manutenção.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-MaintenanceScope

O escopo de manutenção.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

O nome da configuração de manutenção.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PostTask

Lista de tarefas executadas após o agendamento. [{'source' :'runbook', 'taskScope': 'Resource', 'parameters': { 'arg1': 'value1'}}]. Esse parâmetro é usado para especificar um comando ou script que deve ser executado após a execução das tarefas de manutenção. Isso pode ser usado para executar todas as ações de acompanhamento necessárias após a conclusão das tarefas de manutenção. Esse parâmetro aceita um valor de cadeia de caracteres que especifica o comando ou o script a ser executado. O comando ou script pode ser especificado como uma cadeia de caracteres simples ou como uma matriz de cadeias de caracteres. Se uma matriz de cadeias de caracteres for especificada, cada elemento na matriz será tratado como um comando ou script separado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PreTask

Lista de tarefas executadas antes do agendamento. por exemplo, [{'source' :'runbook', 'taskScope': 'Global', 'parameters': { 'arg1': 'value1'}}]. Esse parâmetro é usado para especificar um comando ou script que deve ser executado antes que as tarefas de manutenção sejam executadas. Isso pode ser usado para executar as preparações necessárias ou ações de limpeza antes que as tarefas de manutenção sejam executadas. Esse parâmetro aceita um valor de cadeia de caracteres que especifica o comando ou o script a ser executado. O comando ou script pode ser especificado como uma cadeia de caracteres simples ou como uma matriz de cadeias de caracteres. Se uma matriz de cadeias de caracteres for especificada, cada elemento na matriz será tratado como um comando ou script separado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RecurEvery

A recorrência de agendamento

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

O nome do grupo de recursos.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-StartDateTime

O StartDateTime da agenda no formato YYYY-MM-DD hh:mm

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Tag

As marcas ARM.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Timezone

O fuso horário

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Visibility

A visibilidade do escopo

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WindowParameterClassificationToInclude

Lista de classificação de patch do Windows. Os valores permitidos são 'Critical', 'Security', 'UpdateRollup', 'FeaturePack', 'ServicePack', 'Definition', 'Tools' e 'Updates'.

Tipo:HashSet<T>[String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WindowParameterExcludeKbRequiringReboot

Excluir KBs que exigem reinicialização

Tipo:Nullable<T>[Boolean]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WindowParameterKbNumberToExclude

Lista de KBs a serem excluídos durante a operação de patch de VM

Tipo:HashSet<T>[String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WindowParameterKbNumberToInclude

Lista de KBs a serem incluídos durante a operação de patch de VM

Tipo:HashSet<T>[String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Saídas

PSMaintenanceConfiguration