Microsoft.Maintenance maintenanceConfigurations 2023-04-01
Bicep 資源定義
maintenanceConfigurations 資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.Maintenance/maintenanceConfigurations 資源，請將下列 Bicep 新增至範本。
resource symbolicname 'Microsoft.Maintenance/maintenanceConfigurations@2023-04-01' = {
location: 'string'
name: 'string'
properties: {
extensionProperties: {
{customized property}: 'string'
}
installPatches: {
linuxParameters: {
classificationsToInclude: [
'string'
]
packageNameMasksToExclude: [
'string'
]
packageNameMasksToInclude: [
'string'
]
}
rebootSetting: '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'
visibility: 'string'
}
tags: {
{customized property}: 'string'
}
}
屬性值
InputLinuxParameters
| 名字 | 描述 | 價值 |
|---|---|---|
| classificationsToInclude | 要修補的修補程式分類類別 | string[] |
| packageNameMasksToExclude | 要排除用於修補的套件名稱。 | string[] |
| packageNameMasksToInclude | 要包含在修補的套件名稱。 | string[] |
InputPatchConfiguration
| 名字 | 描述 | 價值 |
|---|---|---|
| linuxParameters | 修補 Linux 計算機特有的輸入參數。 若為 Windows 計算機，請勿傳遞此屬性。 | InputLinuxParameters |
| rebootSetting | 根據使用者所定義的可能重新啟動喜好設定，決定在修補作業完成之後，將機器重新啟動。 | 'Always' 'IfRequired' 'Never' |
| windowsParameters | 修補 Windows 電腦的特定輸入參數。 針對Linux機器，請勿傳遞此屬性。 | InputWindowsParameters |
InputWindowsParameters
| 名字 | 描述 | 價值 |
|---|---|---|
| classificationsToInclude | 要修補的修補程式分類類別 | string[] |
| excludeKbsRequiringReboot | 排除需要重新啟動的修補程式 | bool |
| kbNumbersToExclude | 要排除以進行修補的 Windows KBID。 | string[] |
| kbNumbersToInclude | 要包含用於修補的 Windows KBID。 | string[] |
MaintenanceConfigurationProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| extensionProperties | 取得或設定 maintenanceConfiguration 的 extensionProperties | MaintenanceConfigurationPropertiesExtensionProperties |
| installPatches | 要傳遞至修補程式執行作業的輸入參數。 | InputPatchConfiguration |
| maintenanceScope | 取得或設定組態的 maintenanceScope | 'Extension' 'Host' 'InGuestPatch' 'OSImage' 'Resource' 'SQLDB' 'SQLManagedInstance' |
| maintenanceWindow | MaintenanceWindow 的定義 | MaintenanceWindow |
| Namespace | 取得或設定資源的命名空間 | 字串 |
| 能見度 | 取得或設定組態的可見性。 預設值為 'Custom' | 'Custom' 'Public' |
MaintenanceConfigurationPropertiesExtensionProperties
| 名字 | 描述 | 價值 |
|---|
MaintenanceConfigurationTags
| 名字 | 描述 | 價值 |
|---|
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 |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
ARM 樣本資源定義
maintenanceConfigurations 資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.Maintenance/maintenanceConfigurations 資源，請將下列 JSON 新增至範本。
{
"type": "Microsoft.Maintenance/maintenanceConfigurations",
"apiVersion": "2023-04-01",
"name": "string",
"location": "string",
"properties": {
"extensionProperties": {
"{customized property}": "string"
},
"installPatches": {
"linuxParameters": {
"classificationsToInclude": [ "string" ],
"packageNameMasksToExclude": [ "string" ],
"packageNameMasksToInclude": [ "string" ]
},
"rebootSetting": "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",
"visibility": "string"
},
"tags": {
"{customized property}": "string"
}
}
屬性值
InputLinuxParameters
| 名字 | 描述 | 價值 |
|---|---|---|
| classificationsToInclude | 要修補的修補程式分類類別 | string[] |
| packageNameMasksToExclude | 要排除用於修補的套件名稱。 | string[] |
| packageNameMasksToInclude | 要包含在修補的套件名稱。 | string[] |
InputPatchConfiguration
| 名字 | 描述 | 價值 |
|---|---|---|
| linuxParameters | 修補 Linux 計算機特有的輸入參數。 若為 Windows 計算機，請勿傳遞此屬性。 | InputLinuxParameters |
| rebootSetting | 根據使用者所定義的可能重新啟動喜好設定，決定在修補作業完成之後，將機器重新啟動。 | 'Always' 'IfRequired' 'Never' |
| windowsParameters | 修補 Windows 電腦的特定輸入參數。 針對Linux機器，請勿傳遞此屬性。 | InputWindowsParameters |
InputWindowsParameters
| 名字 | 描述 | 價值 |
|---|---|---|
| classificationsToInclude | 要修補的修補程式分類類別 | string[] |
| excludeKbsRequiringReboot | 排除需要重新啟動的修補程式 | bool |
| kbNumbersToExclude | 要排除以進行修補的 Windows KBID。 | string[] |
| kbNumbersToInclude | 要包含用於修補的 Windows KBID。 | string[] |
MaintenanceConfigurationProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| extensionProperties | 取得或設定 maintenanceConfiguration 的 extensionProperties | MaintenanceConfigurationPropertiesExtensionProperties |
| installPatches | 要傳遞至修補程式執行作業的輸入參數。 | InputPatchConfiguration |
| maintenanceScope | 取得或設定組態的 maintenanceScope | 'Extension' 'Host' 'InGuestPatch' 'OSImage' 'Resource' 'SQLDB' 'SQLManagedInstance' |
| maintenanceWindow | MaintenanceWindow 的定義 | MaintenanceWindow |
| Namespace | 取得或設定資源的命名空間 | 字串 |
| 能見度 | 取得或設定組態的可見性。 預設值為 'Custom' | 'Custom' 'Public' |
MaintenanceConfigurationPropertiesExtensionProperties
| 名字 | 描述 | 價值 |
|---|
MaintenanceConfigurationTags
| 名字 | 描述 | 價值 |
|---|
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 版本 | '2023-04-01' |
| 位置 | 取得或設定資源的位置 | 字串 |
| 名字 | 資源名稱 | 字串 （必要） |
| 性能 | 取得或設定資源的屬性 | MaintenanceConfigurationProperties |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
| 類型 | 資源類型 | 'Microsoft.Maintenance/maintenanceConfigurations' |
Terraform （AzAPI 提供者） 資源定義
maintenanceConfigurations 資源類型可以使用目標作業來部署：
- 資源群組
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.Maintenance/maintenanceConfigurations 資源，請將下列 Terraform 新增至範本。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Maintenance/maintenanceConfigurations@2023-04-01"
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"
windowsParameters = {
classificationsToInclude = [
"string"
]
excludeKbsRequiringReboot = bool
kbNumbersToExclude = [
"string"
]
kbNumbersToInclude = [
"string"
]
}
}
maintenanceScope = "string"
maintenanceWindow = {
duration = "string"
expirationDateTime = "string"
recurEvery = "string"
startDateTime = "string"
timeZone = "string"
}
namespace = "string"
visibility = "string"
}
})
}
屬性值
InputLinuxParameters
| 名字 | 描述 | 價值 |
|---|---|---|
| classificationsToInclude | 要修補的修補程式分類類別 | string[] |
| packageNameMasksToExclude | 要排除用於修補的套件名稱。 | string[] |
| packageNameMasksToInclude | 要包含在修補的套件名稱。 | string[] |
InputPatchConfiguration
| 名字 | 描述 | 價值 |
|---|---|---|
| linuxParameters | 修補 Linux 計算機特有的輸入參數。 若為 Windows 計算機，請勿傳遞此屬性。 | InputLinuxParameters |
| rebootSetting | 根據使用者所定義的可能重新啟動喜好設定，決定在修補作業完成之後，將機器重新啟動。 | 'Always' 'IfRequired' 'Never' |
| windowsParameters | 修補 Windows 電腦的特定輸入參數。 針對Linux機器，請勿傳遞此屬性。 | InputWindowsParameters |
InputWindowsParameters
| 名字 | 描述 | 價值 |
|---|---|---|
| classificationsToInclude | 要修補的修補程式分類類別 | string[] |
| excludeKbsRequiringReboot | 排除需要重新啟動的修補程式 | bool |
| kbNumbersToExclude | 要排除以進行修補的 Windows KBID。 | string[] |
| kbNumbersToInclude | 要包含用於修補的 Windows KBID。 | string[] |
MaintenanceConfigurationProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| extensionProperties | 取得或設定 maintenanceConfiguration 的 extensionProperties | MaintenanceConfigurationPropertiesExtensionProperties |
| installPatches | 要傳遞至修補程式執行作業的輸入參數。 | InputPatchConfiguration |
| maintenanceScope | 取得或設定組態的 maintenanceScope | 'Extension' 'Host' 'InGuestPatch' 'OSImage' 'Resource' 'SQLDB' 'SQLManagedInstance' |
| maintenanceWindow | MaintenanceWindow 的定義 | MaintenanceWindow |
| Namespace | 取得或設定資源的命名空間 | 字串 |
| 能見度 | 取得或設定組態的可見性。 預設值為 'Custom' | 'Custom' 'Public' |
MaintenanceConfigurationPropertiesExtensionProperties
| 名字 | 描述 | 價值 |
|---|
MaintenanceConfigurationTags
| 名字 | 描述 | 價值 |
|---|
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@2023-04-01” |