通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzMaintenanceConfiguration

  • 参考
模块:
Az.Maintenance

创建或更新配置记录

语法

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>]

说明

创建或更新配置记录

示例

示例 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

使用范围主机创建维护配置

示例 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

使用 InGuest 范围创建维护配置

参数

-AsJob

在后台运行 cmdlet

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Duration

持续时间

类型:TimeSpan
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ExpirationDateTime

计划的 expirationDateTime 格式为 YYYY -MM-DD hh：mm

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ExtensionProperty

每个资源的扩展属性。

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InstallPatchRebootSetting

安装修补程序重新启动选项。 允许的值 Never、IfRequired、Always

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-LinuxParameterClassificationToInclude

Linux 修补程序分类列表。 允许的值为“Critical”、“Security”和“Other”。

类型:HashSet<T>[String]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-LinuxParameterPackageNameMaskToExclude

在 VM 修补操作期间要排除的包列表

类型:HashSet<T>[String]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-LinuxParameterPackageNameMaskToInclude

Vm 修补操作期间要包括的包列表

类型:HashSet<T>[String]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Location

维护配置位置。

类型:String
Position:2
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-MaintenanceScope

维护范围。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

维护配置名称。

类型:String
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-PostTask

计划后执行的任务列表。 [{'source' ：'runbook'， 'taskScope'： 'Resource'， 'parameters'： { 'arg1'： 'value1'}}]。 此参数用于指定应在执行维护任务后运行的命令或脚本。 这可用于在完成维护任务后执行任何必要的后续操作。 此参数接受一个字符串值，该值指定要运行的命令或脚本。 命令或脚本可以指定为简单字符串或字符串数组。 如果指定字符串数组，数组中的每个元素将被视为单独的命令或脚本。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PreTask

计划前执行的任务列表。 例如 [{'source' ：'runbook'， 'taskScope'： 'Global'， 'parameters'： { 'arg1'： 'value1'}}]。 此参数用于指定应在执行维护任务之前运行的命令或脚本。 这可用于在运行维护任务之前执行任何必要的准备或清理操作。 此参数接受一个字符串值，该值指定要运行的命令或脚本。 命令或脚本可以指定为简单字符串或字符串数组。 如果指定字符串数组，数组中的每个元素将被视为单独的命令或脚本。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RecurEvery

计划重复周期

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ResourceGroupName

资源组名称。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-StartDateTime

计划的 StartDateTime 格式为 YYYY -MM-DD hh：mm

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Tag

ARM 标记。

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Timezone

时区

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Visibility

范围的可见性

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WindowParameterClassificationToInclude

Windows 修补程序分类列表。 允许的值为“Critical”、“Security”、“UpdateRollup”、“FeaturePack”、“ServicePack”、“Definition”、“Tools”和“Updates”。

类型:HashSet<T>[String]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WindowParameterExcludeKbRequiringReboot

排除需要重新启动的 KB

类型:Nullable<T>[Boolean]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WindowParameterKbNumberToExclude

在 VM 修补操作期间要排除的 KB 列表

类型:HashSet<T>[String]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WindowParameterKbNumberToInclude

VM 修补操作期间要包括的 KB 列表

类型:HashSet<T>[String]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

String

输出

PSMaintenanceConfiguration