Sdílet prostřednictvím

New-AzMaintenanceConfiguration

  • Reference
Modul:
Az.Maintenance

Vytvoření nebo aktualizace záznamu konfigurace

Syntaxe

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

Vytvoření nebo aktualizace záznamu konfigurace

Příklady

Příklad 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

Vytvoření konfigurace údržby s oborem Hostitel

Příklad 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

Vytvoření konfigurace údržby s oborem InGuest

Parametry

-AsJob

Spuštění rutiny na pozadí

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Duration

Doba trvání

Typ:TimeSpan
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ExpirationDateTime

Datum vypršení platnosti plánu ve formátu RRRR-MM-DD hh:mm

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ExtensionProperty

Vlastnosti rozšíření na prostředek.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InstallPatchRebootSetting

Možnost instalace restartování opravy Povolené hodnoty Never, IfRequired, Always

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LinuxParameterClassificationToInclude

Seznam klasifikací oprav linuxu Povolené hodnoty jsou Kritické, Zabezpečení a Jiné.

Typ:HashSet<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LinuxParameterPackageNameMaskToExclude

Seznam balíčků, které se mají vyloučit během operace opravy virtuálních počítačů

Typ:HashSet<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LinuxParameterPackageNameMaskToInclude

Seznam balíčků, které se mají zahrnout během operace opravy virtuálních počítačů

Typ:HashSet<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Location

Umístění konfigurace údržby.

Typ:String
Position:2
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-MaintenanceScope

Obor údržby.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Název konfigurace údržby.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PostTask

Seznam úkolů spuštěných po plánu [{'source' :'runbook', 'taskScope': 'Resource', 'parameters': { 'arg1': 'value1'}}]. Tento parametr slouží k zadání příkazu nebo skriptu, který by se měl spustit po provedení úloh údržby. Můžete ho použít k provedení jakýchkoli nezbytných následných akcí po dokončení úloh údržby. Tento parametr přijímá řetězcovou hodnotu, která určuje příkaz nebo skript, který se má spustit. Příkaz nebo skript lze zadat jako jednoduchý řetězec nebo jako pole řetězců. Pokud je zadáno pole řetězců, bude každý prvek v poli považován za samostatný příkaz nebo skript.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PreTask

Seznam úkolů spuštěných před plánem například [{'source' :'runbook', 'taskScope': 'Global', 'parameters': { 'arg1': 'value1'}]. Tento parametr slouží k zadání příkazu nebo skriptu, který by se měl spustit před provedením úloh údržby. Můžete ho použít k provedení všech potřebných příprav nebo akcí čištění před spuštěním úloh údržby. Tento parametr přijímá řetězcovou hodnotu, která určuje příkaz nebo skript, který se má spustit. Příkaz nebo skript lze zadat jako jednoduchý řetězec nebo jako pole řetězců. Pokud je zadáno pole řetězců, bude každý prvek v poli považován za samostatný příkaz nebo skript.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RecurEvery

Opakování plánu

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceGroupName

Název skupiny prostředků.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-StartDateTime

StartDateTime plánu ve formátu RRRR-MM-DD hh:mm

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Tag

Značky ARM.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Timezone

Časové pásmo

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Visibility

Viditelnost oboru

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WindowParameterClassificationToInclude

Seznam klasifikace oprav systému Windows Povolené hodnoty jsou Kritické, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools a Updates.

Typ:HashSet<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WindowParameterExcludeKbRequiringReboot

Vyloučení databází, které vyžadují restartování

Typ:Nullable<T>[Boolean]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WindowParameterKbNumberToExclude

Seznam databází, které se mají vyloučit během operace opravy virtuálních počítačů

Typ:HashSet<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WindowParameterKbNumberToInclude

Seznam databází, které se mají zahrnout během operace opravy virtuálních počítačů

Typ:HashSet<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Výstupy

PSMaintenanceConfiguration