Microsoft.Maintenance maintenanceConfigurations 2022-11-01-preview
Bicep 資源定義
maintenanceConfigurations 資源類型可以使用目標作業來部署：
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
若要建立 Microsoft.Maintenance/maintenanceConfigurations 資源，請將下列 Bicep 新增至範本。
resource symbolicname 'Microsoft.Maintenance/maintenanceConfigurations@2022-11-01-preview' = {
location: 'string'
name: 'string'
properties: {
extensionProperties: {
{customized property}: 'string'
}
installPatches: {
linuxParameters: {
classificationsToInclude: [
'string'
]
packageNameMasksToExclude: [
'string'
]
packageNameMasksToInclude: [
'string'
]
}
rebootSetting: 'string'
tasks: {
postTasks: [
{
parameters: {
{customized property}: 'string'
}
source: 'string'
taskScope: 'string'
}
]
preTasks: [
{
parameters: {
{customized property}: 'string'
}
source: 'string'
taskScope: 'string'
}
]
}
windowsParameters: {
classificationsToInclude: [
'string'
]
excludeKbsRequiringReboot: bool
kbNumbersToExclude: [
'string'
]
kbNumbersToInclude: [
'string'
]
}
}
maintenanceScope: 'string'
maintenanceWindow: {
duration: 'string'
expirationDateTime: 'string'
recurEvery: 'string'
startDateTime: 'string'
timeZone: 'string'
}
namespace: 'string'
overrides: {
overrides: [
{
endDateTime: 'string'
overrideProperties: {
{customized property}: 'string'
}
startDateTime: 'string'
timeZone: 'string'
}
]
}
visibility: 'string'
}
tags: {
{customized property}: 'string'
}
}
屬性值
| 名字 |
描述 |
價值 |
| classificationsToInclude |
要修補的修補程式分類類別 |
string[] |
| packageNameMasksToExclude |
要排除用於修補的套件名稱。 |
string[] |
| packageNameMasksToInclude |
要包含在修補的套件名稱。 |
string[] |
| 名字 |
描述 |
價值 |
| classificationsToInclude |
要修補的修補程式分類類別 |
string[] |
| excludeKbsRequiringReboot |
排除需要重新啟動的修補程式 |
bool |
| kbNumbersToExclude |
要排除以進行修補的 Windows KBID。 |
string[] |
| kbNumbersToInclude |
要包含用於修補的 Windows KBID。 |
string[] |
MaintenanceConfigurationOverrides
MaintenanceConfigurationProperties
MaintenanceConfigurationPropertiesExtensionProperties
MaintenanceConfigurationTags
MaintenanceOverrideProperties
| 名字 |
描述 |
價值 |
| endDateTime |
YYYY-MM-DD hh：mm 格式之維護覆寫視窗的有效結束日期。 視窗將會在提供的時區中建立，並根據該時區調整為日光節約。 到期日必須設定為未來的日期。 如果未提供，則會將它設定為日期時間上限 9999-12-31 23：59：59。 |
字串 |
| overrideProperties |
取得或設定 maintenanceConfiguration 的 overrideProperties |
MaintenanceOverrideProperties |
| startDateTime |
YYYY-MM-DD hh：mm 格式之維護覆寫視窗的有效開始日期。 開始日期可以設定為目前的日期或未來的日期。 視窗將會在提供的時區中建立，並根據該時區調整為日光節約。 |
字串 |
| timeZone |
時區的名稱。 您可以在 PowerShell 中執行 [System.TimeZoneInfo]：：GetSystemTimeZones（） 來取得時區清單。 範例：太平洋標準時間、UTC、W. 歐洲標準時間、韓國標準時間、Cen。 澳大利亞標準時間。 |
字串 |
MaintenanceOverrideProperties
MaintenanceWindow
| 名字 |
描述 |
價值 |
| 期間 |
HH：mm 格式的維護期間。 如果未提供，則會根據提供的維護範圍使用預設值。 範例：05：00。 |
字串 |
| expirationDateTime |
YYYY-MM-DD hh：mm 格式之維護時段的有效到期日。 視窗將會在提供的時區中建立，並根據該時區調整為日光節約。 到期日必須設定為未來的日期。 如果未提供，則會將它設定為日期時間上限 9999-12-31 23：59：59。 |
字串 |
| recurEvery |
維護期間預期會遞迴的速率。 速率可以表示為每日、每周或每月排程。 每日排程會格式化為 recurEvery： [Frequency as integer]['Day（s）']。 如果未提供任何頻率，則默認頻率為1。 每日排程範例為 recurEvery：Day、recurEvery：3Days。 每周排程的格式為 recurEvery： [Frequency as integer]['Week（s）'] [週一-星期日的選擇性逗號分隔列表]。 每周排程範例為 recurEvery：3Weeks、recurEvery：Week Saturday、Sunday。 每月排程的格式為 [Frequency as integer]['Month（s）'] [以逗號分隔的月份天數列表] 或 [Frequency as integer]['Month（s）] [Month of Month （First， Second， Third， Fourth， Last）] [Weekday Monday-Sunday] [Optional Offset（No. of days）]。 位移值必須介於 -6 到 6 之間。 每月排程範例為 recurEvery：Month、recurEvery：2Months、recurEvery：Month day23，day24、recurEvery：Month Last Sunday、recurEvery：Month Fourth Monday、recurEvery：Month Last Sunday Offset-3、recurEvery：Month Third Sunday Offset6。 |
字串 |
| startDateTime |
YYYY-MM-DD hh：mm 格式之維護期間的有效開始日期。 開始日期可以設定為目前的日期或未來的日期。 視窗將會在提供的時區中建立，並根據該時區調整為日光節約。 |
字串 |
| timeZone |
時區的名稱。 您可以在 PowerShell 中執行 [System.TimeZoneInfo]：：GetSystemTimeZones（） 來取得時區清單。 範例：太平洋標準時間、UTC、W. 歐洲標準時間、韓國標準時間、Cen。 澳大利亞標準時間。 |
字串 |
Microsoft.Maintenance/maintenanceConfigurations
SoftwareUpdateConfigurationTasks
| 名字 |
描述 |
價值 |
| postTasks |
文章工作清單。 例如 [{'source' ：'runbook'， 'taskScope'： 'Resource'， 'parameters'： { 'arg1'： 'value1'}}] |
TaskProperties[] |
| preTasks |
前置工作的清單。 例如 [{'source' ：'Runbook'， 'taskScope'： 'Global'， 'parameters'： { 'arg1'： 'value1'}}] |
TaskProperties[] |
TaskProperties
| 名字 |
描述 |
價值 |
| 參數 |
取得或設定工作的參數。 |
TaskPropertiesParameters |
| 源 |
取得或設定 Runbook 的名稱。 |
字串 |
| taskScope |
當排程觸發程式時，全域工作會執行一次。 針對每個 VM 執行資源工作。 |
'Global'
'Resource' |
TaskPropertiesParameters
ARM 樣本資源定義
maintenanceConfigurations 資源類型可以使用目標作業來部署：
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
若要建立 Microsoft.Maintenance/maintenanceConfigurations 資源，請將下列 JSON 新增至範本。
{
"type": "Microsoft.Maintenance/maintenanceConfigurations",
"apiVersion": "2022-11-01-preview",
"name": "string",
"location": "string",
"properties": {
"extensionProperties": {
"{customized property}": "string"
},
"installPatches": {
"linuxParameters": {
"classificationsToInclude": [ "string" ],
"packageNameMasksToExclude": [ "string" ],
"packageNameMasksToInclude": [ "string" ]
},
"rebootSetting": "string",
"tasks": {
"postTasks": [
{
"parameters": {
"{customized property}": "string"
},
"source": "string",
"taskScope": "string"
}
],
"preTasks": [
{
"parameters": {
"{customized property}": "string"
},
"source": "string",
"taskScope": "string"
}
]
},
"windowsParameters": {
"classificationsToInclude": [ "string" ],
"excludeKbsRequiringReboot": "bool",
"kbNumbersToExclude": [ "string" ],
"kbNumbersToInclude": [ "string" ]
}
},
"maintenanceScope": "string",
"maintenanceWindow": {
"duration": "string",
"expirationDateTime": "string",
"recurEvery": "string",
"startDateTime": "string",
"timeZone": "string"
},
"namespace": "string",
"overrides": {
"overrides": [
{
"endDateTime": "string",
"overrideProperties": {
"{customized property}": "string"
},
"startDateTime": "string",
"timeZone": "string"
}
]
},
"visibility": "string"
},
"tags": {
"{customized property}": "string"
}
}
屬性值
| 名字 |
描述 |
價值 |
| classificationsToInclude |
要修補的修補程式分類類別 |
string[] |
| packageNameMasksToExclude |
要排除用於修補的套件名稱。 |
string[] |
| packageNameMasksToInclude |
要包含在修補的套件名稱。 |
string[] |
| 名字 |
描述 |
價值 |
| classificationsToInclude |
要修補的修補程式分類類別 |
string[] |
| excludeKbsRequiringReboot |
排除需要重新啟動的修補程式 |
bool |
| kbNumbersToExclude |
要排除以進行修補的 Windows KBID。 |
string[] |
| kbNumbersToInclude |
要包含用於修補的 Windows KBID。 |
string[] |
MaintenanceConfigurationOverrides
MaintenanceConfigurationProperties
MaintenanceConfigurationPropertiesExtensionProperties
MaintenanceConfigurationTags
MaintenanceOverrideProperties
| 名字 |
描述 |
價值 |
| endDateTime |
YYYY-MM-DD hh：mm 格式之維護覆寫視窗的有效結束日期。 視窗將會在提供的時區中建立，並根據該時區調整為日光節約。 到期日必須設定為未來的日期。 如果未提供，則會將它設定為日期時間上限 9999-12-31 23：59：59。 |
字串 |
| overrideProperties |
取得或設定 maintenanceConfiguration 的 overrideProperties |
MaintenanceOverrideProperties |
| startDateTime |
YYYY-MM-DD hh：mm 格式之維護覆寫視窗的有效開始日期。 開始日期可以設定為目前的日期或未來的日期。 視窗將會在提供的時區中建立，並根據該時區調整為日光節約。 |
字串 |
| timeZone |
時區的名稱。 您可以在 PowerShell 中執行 [System.TimeZoneInfo]：：GetSystemTimeZones（） 來取得時區清單。 範例：太平洋標準時間、UTC、W. 歐洲標準時間、韓國標準時間、Cen。 澳大利亞標準時間。 |
字串 |
MaintenanceOverrideProperties
MaintenanceWindow
| 名字 |
描述 |
價值 |
| 期間 |
HH：mm 格式的維護期間。 如果未提供，則會根據提供的維護範圍使用預設值。 範例：05：00。 |
字串 |
| expirationDateTime |
YYYY-MM-DD hh：mm 格式之維護時段的有效到期日。 視窗將會在提供的時區中建立，並根據該時區調整為日光節約。 到期日必須設定為未來的日期。 如果未提供，則會將它設定為日期時間上限 9999-12-31 23：59：59。 |
字串 |
| recurEvery |
維護期間預期會遞迴的速率。 速率可以表示為每日、每周或每月排程。 每日排程會格式化為 recurEvery： [Frequency as integer]['Day（s）']。 如果未提供任何頻率，則默認頻率為1。 每日排程範例為 recurEvery：Day、recurEvery：3Days。 每周排程的格式為 recurEvery： [Frequency as integer]['Week（s）'] [週一-星期日的選擇性逗號分隔列表]。 每周排程範例為 recurEvery：3Weeks、recurEvery：Week Saturday、Sunday。 每月排程的格式為 [Frequency as integer]['Month（s）'] [以逗號分隔的月份天數列表] 或 [Frequency as integer]['Month（s）] [Month of Month （First， Second， Third， Fourth， Last）] [Weekday Monday-Sunday] [Optional Offset（No. of days）]。 位移值必須介於 -6 到 6 之間。 每月排程範例為 recurEvery：Month、recurEvery：2Months、recurEvery：Month day23，day24、recurEvery：Month Last Sunday、recurEvery：Month Fourth Monday、recurEvery：Month Last Sunday Offset-3、recurEvery：Month Third Sunday Offset6。 |
字串 |
| startDateTime |
YYYY-MM-DD hh：mm 格式之維護期間的有效開始日期。 開始日期可以設定為目前的日期或未來的日期。 視窗將會在提供的時區中建立，並根據該時區調整為日光節約。 |
字串 |
| timeZone |
時區的名稱。 您可以在 PowerShell 中執行 [System.TimeZoneInfo]：：GetSystemTimeZones（） 來取得時區清單。 範例：太平洋標準時間、UTC、W. 歐洲標準時間、韓國標準時間、Cen。 澳大利亞標準時間。 |
字串 |
Microsoft.Maintenance/maintenanceConfigurations
| 名字 |
描述 |
價值 |
| apiVersion |
API 版本 |
'2022-11-01-preview' |
| 位置 |
取得或設定資源的位置 |
字串 |
| 名字 |
資源名稱 |
字串 （必要） |
| 性能 |
取得或設定資源的屬性 |
MaintenanceConfigurationProperties |
| 標籤 |
資源標籤 |
標記名稱和值的字典。 請參閱範本中的 標籤 |
| 類型 |
資源類型 |
'Microsoft.Maintenance/maintenanceConfigurations' |
SoftwareUpdateConfigurationTasks
| 名字 |
描述 |
價值 |
| postTasks |
文章工作清單。 例如 [{'source' ：'runbook'， 'taskScope'： 'Resource'， 'parameters'： { 'arg1'： 'value1'}}] |
TaskProperties[] |
| preTasks |
前置工作的清單。 例如 [{'source' ：'Runbook'， 'taskScope'： 'Global'， 'parameters'： { 'arg1'： 'value1'}}] |
TaskProperties[] |
TaskProperties
| 名字 |
描述 |
價值 |
| 參數 |
取得或設定工作的參數。 |
TaskPropertiesParameters |
| 源 |
取得或設定 Runbook 的名稱。 |
字串 |
| taskScope |
當排程觸發程式時，全域工作會執行一次。 針對每個 VM 執行資源工作。 |
'Global'
'Resource' |
TaskPropertiesParameters
maintenanceConfigurations 資源類型可以使用目標作業來部署：
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
若要建立 Microsoft.Maintenance/maintenanceConfigurations 資源，請將下列 Terraform 新增至範本。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Maintenance/maintenanceConfigurations@2022-11-01-preview"
name = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
extensionProperties = {
{customized property} = "string"
}
installPatches = {
linuxParameters = {
classificationsToInclude = [
"string"
]
packageNameMasksToExclude = [
"string"
]
packageNameMasksToInclude = [
"string"
]
}
rebootSetting = "string"
tasks = {
postTasks = [
{
parameters = {
{customized property} = "string"
}
source = "string"
taskScope = "string"
}
]
preTasks = [
{
parameters = {
{customized property} = "string"
}
source = "string"
taskScope = "string"
}
]
}
windowsParameters = {
classificationsToInclude = [
"string"
]
excludeKbsRequiringReboot = bool
kbNumbersToExclude = [
"string"
]
kbNumbersToInclude = [
"string"
]
}
}
maintenanceScope = "string"
maintenanceWindow = {
duration = "string"
expirationDateTime = "string"
recurEvery = "string"
startDateTime = "string"
timeZone = "string"
}
namespace = "string"
overrides = {
overrides = [
{
endDateTime = "string"
overrideProperties = {
{customized property} = "string"
}
startDateTime = "string"
timeZone = "string"
}
]
}
visibility = "string"
}
})
}
屬性值
| 名字 |
描述 |
價值 |
| classificationsToInclude |
要修補的修補程式分類類別 |
string[] |
| packageNameMasksToExclude |
要排除用於修補的套件名稱。 |
string[] |
| packageNameMasksToInclude |
要包含在修補的套件名稱。 |
string[] |
| 名字 |
描述 |
價值 |
| classificationsToInclude |
要修補的修補程式分類類別 |
string[] |
| excludeKbsRequiringReboot |
排除需要重新啟動的修補程式 |
bool |
| kbNumbersToExclude |
要排除以進行修補的 Windows KBID。 |
string[] |
| kbNumbersToInclude |
要包含用於修補的 Windows KBID。 |
string[] |
MaintenanceConfigurationOverrides
MaintenanceConfigurationProperties
MaintenanceConfigurationPropertiesExtensionProperties
MaintenanceConfigurationTags
MaintenanceOverrideProperties
| 名字 |
描述 |
價值 |
| endDateTime |
YYYY-MM-DD hh：mm 格式之維護覆寫視窗的有效結束日期。 視窗將會在提供的時區中建立，並根據該時區調整為日光節約。 到期日必須設定為未來的日期。 如果未提供，則會將它設定為日期時間上限 9999-12-31 23：59：59。 |
字串 |
| overrideProperties |
取得或設定 maintenanceConfiguration 的 overrideProperties |
MaintenanceOverrideProperties |
| startDateTime |
YYYY-MM-DD hh：mm 格式之維護覆寫視窗的有效開始日期。 開始日期可以設定為目前的日期或未來的日期。 視窗將會在提供的時區中建立，並根據該時區調整為日光節約。 |
字串 |
| timeZone |
時區的名稱。 您可以在 PowerShell 中執行 [System.TimeZoneInfo]：：GetSystemTimeZones（） 來取得時區清單。 範例：太平洋標準時間、UTC、W. 歐洲標準時間、韓國標準時間、Cen。 澳大利亞標準時間。 |
字串 |
MaintenanceOverrideProperties
MaintenanceWindow
| 名字 |
描述 |
價值 |
| 期間 |
HH：mm 格式的維護期間。 如果未提供，則會根據提供的維護範圍使用預設值。 範例：05：00。 |
字串 |
| expirationDateTime |
YYYY-MM-DD hh：mm 格式之維護時段的有效到期日。 視窗將會在提供的時區中建立，並根據該時區調整為日光節約。 到期日必須設定為未來的日期。 如果未提供，則會將它設定為日期時間上限 9999-12-31 23：59：59。 |
字串 |
| recurEvery |
維護期間預期會遞迴的速率。 速率可以表示為每日、每周或每月排程。 每日排程會格式化為 recurEvery： [Frequency as integer]['Day（s）']。 如果未提供任何頻率，則默認頻率為1。 每日排程範例為 recurEvery：Day、recurEvery：3Days。 每周排程的格式為 recurEvery： [Frequency as integer]['Week（s）'] [週一-星期日的選擇性逗號分隔列表]。 每周排程範例為 recurEvery：3Weeks、recurEvery：Week Saturday、Sunday。 每月排程的格式為 [Frequency as integer]['Month（s）'] [以逗號分隔的月份天數列表] 或 [Frequency as integer]['Month（s）] [Month of Month （First， Second， Third， Fourth， Last）] [Weekday Monday-Sunday] [Optional Offset（No. of days）]。 位移值必須介於 -6 到 6 之間。 每月排程範例為 recurEvery：Month、recurEvery：2Months、recurEvery：Month day23，day24、recurEvery：Month Last Sunday、recurEvery：Month Fourth Monday、recurEvery：Month Last Sunday Offset-3、recurEvery：Month Third Sunday Offset6。 |
字串 |
| startDateTime |
YYYY-MM-DD hh：mm 格式之維護期間的有效開始日期。 開始日期可以設定為目前的日期或未來的日期。 視窗將會在提供的時區中建立，並根據該時區調整為日光節約。 |
字串 |
| timeZone |
時區的名稱。 您可以在 PowerShell 中執行 [System.TimeZoneInfo]：：GetSystemTimeZones（） 來取得時區清單。 範例：太平洋標準時間、UTC、W. 歐洲標準時間、韓國標準時間、Cen。 澳大利亞標準時間。 |
字串 |
Microsoft.Maintenance/maintenanceConfigurations
| 名字 |
描述 |
價值 |
| 位置 |
取得或設定資源的位置 |
字串 |
| 名字 |
資源名稱 |
字串 （必要） |
| 性能 |
取得或設定資源的屬性 |
MaintenanceConfigurationProperties |
| 標籤 |
資源標籤 |
標記名稱和值的字典。 |
| 類型 |
資源類型 |
“Microsoft.Maintenance/maintenanceConfigurations@2022-11-01-preview” |
SoftwareUpdateConfigurationTasks
| 名字 |
描述 |
價值 |
| postTasks |
文章工作清單。 例如 [{'source' ：'runbook'， 'taskScope'： 'Resource'， 'parameters'： { 'arg1'： 'value1'}}] |
TaskProperties[] |
| preTasks |
前置工作的清單。 例如 [{'source' ：'Runbook'， 'taskScope'： 'Global'， 'parameters'： { 'arg1'： 'value1'}}] |
TaskProperties[] |
TaskProperties
| 名字 |
描述 |
價值 |
| 參數 |
取得或設定工作的參數。 |
TaskPropertiesParameters |
| 源 |
取得或設定 Runbook 的名稱。 |
字串 |
| taskScope |
當排程觸發程式時，全域工作會執行一次。 針對每個 VM 執行資源工作。 |
'Global'
'Resource' |
TaskPropertiesParameters