Microsoft.Maintenance maintenanceConfigurations 2022-07-01-preview
Bicep リソース定義
maintenanceConfigurations リソースの種類は、次を対象とする操作と共にデプロイできます。
- リソース グループ - リソース グループのデプロイ コマンドを参照してください
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.Maintenance/maintenanceConfigurations リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.Maintenance/maintenanceConfigurations@2022-07-01-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
properties: {
extensionProperties: {}
installPatches: {
linuxParameters: {
classificationsToInclude: [
'string'
]
packageNameMasksToExclude: [
'string'
]
packageNameMasksToInclude: [
'string'
]
}
rebootSetting: 'string'
tasks: {
postTasks: [
{
parameters: {}
source: 'string'
taskScope: 'string'
}
]
preTasks: [
{
parameters: {}
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'
visibility: 'string'
}
}
プロパティ値
maintenanceConfigurations
名前 | 説明 | 値 |
---|---|---|
name | リソース名 | string (必須) |
location | リソースの場所を取得または設定します | string |
tags | リソースのタグを取得または設定します | タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください |
properties | リソースのプロパティを取得または設定します | MaintenanceConfigurationProperties |
MaintenanceConfigurationProperties
名前 | 説明 | 値 |
---|---|---|
extensionProperties | maintenanceConfiguration の extensionProperties を取得または設定します | object |
installPatches | パッチ実行操作に渡される入力パラメーター。 このプロパティは、Guest (InGuestPatch) スコープにのみ適用されます。 | InputPatchConfiguration |
maintenanceScope | 構成の maintenanceScope を取得または設定します | 'Extension' 'Host' 'InGuestPatch' 'OSImage' 'Resource' 'SQLDB' 'SQLManagedInstance' |
maintenanceWindow | MaintenanceWindow の定義 | MaintenanceWindow |
namespace | リソースの名前空間を取得または設定します | string |
参照可能範囲 | 構成の可視性を取得または設定します。 既定値は、「Custom」です | 'Custom' 'Public' |
InputPatchConfiguration
名前 | 説明 | 値 |
---|---|---|
linuxParameters | Linux マシンのパッチ適用に固有の入力パラメーター。 Windows マシンの場合は、このプロパティを渡さないでください。 このプロパティは、Guest (InGuestPatch) スコープにのみ適用されます。 | InputLinuxParameters |
rebootSetting | パッチ操作が完了した後にマシンを再起動するかどうかに基づいて、ユーザーが定義した再起動設定の可能性があります。 このプロパティは、Guest (InGuestPatch) スコープにのみ適用されます。 | 'Always' 'IfRequired' 'Never' |
tasks | [サポートされていません]ソフトウェア更新プログラムの構成に関するタスク情報。 | SoftwareUpdateConfigurationTasks |
windowsParameters | Windows マシンの修正プログラムの適用に固有の入力パラメーター。 Linux マシンの場合は、このプロパティを渡さないでください。 このプロパティは、Guest (InGuestPatch) スコープにのみ適用されます。 | InputWindowsParameters |
InputLinuxParameters
名前 | 説明 | 値 |
---|---|---|
classificationsToInclude | パッチを適用するパッチの分類カテゴリ | string[] |
packageNameMasksToExclude | パッチ適用のために除外するパッケージ名。 | string[] |
packageNameMasksToInclude | 修正プログラムを適用するために含めるパッケージ名。 | string[] |
SoftwareUpdateConfigurationTasks
名前 | 説明 | 値 |
---|---|---|
postTasks | [サポートされていません]投稿タスクの一覧。 例: [{'source' :'Runbook', 'taskScope': 'Resource', 'parameters': { 'arg1': 'value1'}}] | TaskProperties[] |
preTasks | [サポートされていません]事前タスクの一覧。 例: [{'source' :'runbook', 'taskScope': 'Global', 'parameters': { 'arg1': 'value1'}}] | TaskProperties[] |
TaskProperties
名前 | 説明 | 値 |
---|---|---|
parameters | [サポートされていません]タスクのパラメーターを取得または設定します。 | object |
source | [サポートされていません]Runbook の名前を取得または設定します。 | string |
taskScope | [サポートされていません]グローバル タスクは、スケジュール トリガー時に 1 回実行されます。 リソース タスクは、VM ごとに実行されます。 | 'Global' 'Resource' |
InputWindowsParameters
名前 | 説明 | 値 |
---|---|---|
classificationsToInclude | パッチを適用するパッチの分類カテゴリ | string[] |
excludeKbsRequiringReboot | 再起動が必要なパッチを除外する | [bool] |
kbNumbersToExclude | 修正プログラムを適用するために除外される Windows KBID。 | string[] |
kbNumbersToInclude | 修正プログラムを適用するために含める Windows KBID。 | string[] |
MaintenanceWindow
名前 | 説明 | 値 |
---|---|---|
duration | HH:mm 形式のメンテナンス期間。 指定しない場合は、指定されたメンテナンス範囲に基づいて既定値が使用されます。 例: 05:00。 | string |
expirationDateTime | メンテナンス期間の有効な有効期限 (YYYY-MM-DD hh:mm 形式)。 ウィンドウは、指定されたタイム ゾーンに作成され、そのタイム ゾーンに応じて夏時間に調整されます。 有効期限は、将来の日付に設定する必要があります。 指定しない場合は、最大日時 9999-12-31 23:59:59 に設定されます。 | string |
recurEvery | メンテナンス期間が繰り返されると予想されるレート。 レートは日、週、月のスケジュールで表すことができます。 毎日のスケジュールは recurEvery として書式設定されます: [頻度 (整数値)]['Day(s)']。 頻度が指定されていない場合、既定の頻度は 1 です。 日単位のスケジュールは、たとえば、recurEvery: Day, recurEvery:3Days になります。 週間スケジュールは recurEvery のフ書式設定されます: [頻度 (整数値)]['Week(s)'] [月曜日から日曜日までの平日をカンマで区切ったリスト(オプション)]。 週単位のスケジュールは、たとえば、recurEvery: 3Weeks, recurEvery:Week Saturday,Sunday になります。 月単位のスケジュールは、[Frequency as integer]['Month(s)'] [Comma separated list of month days] または [Frequency as integer]['Month(s)'] [Week 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 です。 | string |
startDateTime | メンテナンス期間の有効な開始日 (YYYY-MM-DD hh:mm 形式)。 開始日は、現在の日付または将来の日付に設定できます。 ウィンドウは、指定されたタイム ゾーンに作成され、そのタイム ゾーンに応じて夏時間に調整されます。 | string |
timeZone | タイムゾーンの名前。 タイムゾーンの一覧は、PowerShell で [System.TimeZoneInfo]::GetSystemTimeZones() を実行することで取得できます。 例: 太平洋標準時、UTC、W. ヨーロッパ標準時、韓国標準時、Cen。 オーストラリア標準時。 | string |
ARM テンプレート リソース定義
maintenanceConfigurations リソースの種類は、次を対象とする操作でデプロイできます。
- リソース グループ - リソース グループのデプロイ コマンドに関するページを参照してください
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.Maintenance/maintenanceConfigurations リソースを作成するには、次の JSON をテンプレートに追加します。
{
"type": "Microsoft.Maintenance/maintenanceConfigurations",
"apiVersion": "2022-07-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"extensionProperties": {},
"installPatches": {
"linuxParameters": {
"classificationsToInclude": [ "string" ],
"packageNameMasksToExclude": [ "string" ],
"packageNameMasksToInclude": [ "string" ]
},
"rebootSetting": "string",
"tasks": {
"postTasks": [
{
"parameters": {},
"source": "string",
"taskScope": "string"
}
],
"preTasks": [
{
"parameters": {},
"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",
"visibility": "string"
}
}
プロパティ値
maintenanceConfigurations
名前 | 説明 | 値 |
---|---|---|
type | リソースの種類 | 'Microsoft.Maintenance/maintenanceConfigurations' |
apiVersion | リソース API のバージョン | '2022-07-01-preview' |
name | リソース名 | string (必須) |
location | リソースの場所を取得または設定します | string |
tags | リソースのタグを取得または設定します | タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください |
properties | リソースのプロパティを取得または設定します | MaintenanceConfigurationProperties |
MaintenanceConfigurationProperties
名前 | 説明 | 値 |
---|---|---|
extensionProperties | maintenanceConfiguration の extensionProperties を取得または設定します | object |
installPatches | パッチ実行操作に渡される入力パラメーター。 このプロパティは、Guest (InGuestPatch) スコープにのみ適用されます。 | InputPatchConfiguration |
maintenanceScope | 構成の maintenanceScope を取得または設定します | 'Extension' 'Host' 'InGuestPatch' 'OSImage' 'Resource' 'SQLDB' 'SQLManagedInstance' |
maintenanceWindow | MaintenanceWindow の定義 | MaintenanceWindow |
namespace | リソースの名前空間を取得または設定します | string |
参照可能範囲 | 構成の可視性を取得または設定します。 既定値は、「Custom」です | 'Custom' 'Public' |
InputPatchConfiguration
名前 | 説明 | 値 |
---|---|---|
linuxParameters | Linux マシンのパッチ適用に固有の入力パラメーター。 Windows マシンの場合は、このプロパティを渡さないでください。 このプロパティは、Guest (InGuestPatch) スコープにのみ適用されます。 | InputLinuxParameters |
rebootSetting | パッチ操作が完了した後にマシンを再起動するかどうかに基づいて、ユーザーが定義した再起動設定の可能性があります。 このプロパティは、Guest (InGuestPatch) スコープにのみ適用されます。 | 'Always' 'IfRequired' 'Never' |
tasks | [サポートされていません]ソフトウェア更新プログラムの構成に関するタスク情報。 | SoftwareUpdateConfigurationTasks |
windowsParameters | Windows マシンの修正プログラムの適用に固有の入力パラメーター。 Linux マシンの場合は、このプロパティを渡さないでください。 このプロパティは、Guest (InGuestPatch) スコープにのみ適用されます。 | InputWindowsParameters |
InputLinuxParameters
名前 | 説明 | 値 |
---|---|---|
classificationsToInclude | パッチを適用するパッチの分類カテゴリ | string[] |
packageNameMasksToExclude | パッチ適用のために除外するパッケージ名。 | string[] |
packageNameMasksToInclude | 修正プログラムを適用するために含めるパッケージ名。 | string[] |
SoftwareUpdateConfigurationTasks
名前 | 説明 | 値 |
---|---|---|
postTasks | [サポートされていません]投稿タスクの一覧。 例: [{'source' :'runbook', 'taskScope': 'Resource', 'parameters': { 'arg1': 'value1'}}] | TaskProperties[] |
preTasks | [サポートされていません]事前タスクの一覧。 例: [{'source' :'Runbook', 'taskScope': 'Global', 'parameters': { 'arg1': 'value1'}}] | TaskProperties[] |
TaskProperties
名前 | 説明 | 値 |
---|---|---|
parameters | [サポートされていません]タスクのパラメーターを取得または設定します。 | object |
source | [サポートされていません]Runbook の名前を取得または設定します。 | string |
taskScope | [サポートされていません]グローバル タスクは、スケジュール トリガー時に 1 回実行されます。 リソース タスクは、VM ごとに実行されます。 | 'Global' 'Resource' |
InputWindowsParameters
名前 | 説明 | 値 |
---|---|---|
classificationsToInclude | パッチを適用するパッチの分類カテゴリ | string[] |
excludeKbsRequiringReboot | 再起動が必要なパッチを除外する | [bool] |
kbNumbersToExclude | 修正プログラムを適用するために除外される Windows KBID。 | string[] |
kbNumbersToInclude | 修正プログラムを適用するために含める Windows KBID。 | string[] |
MaintenanceWindow
名前 | 説明 | 値 |
---|---|---|
duration | HH:mm 形式のメンテナンス期間。 指定しない場合は、指定されたメンテナンス範囲に基づいて既定値が使用されます。 例: 05:00。 | string |
expirationDateTime | メンテナンス期間の有効な有効期限 (YYYY-MM-DD hh:mm 形式)。 ウィンドウは、指定されたタイム ゾーンに作成され、そのタイム ゾーンに応じて夏時間に調整されます。 有効期限は、将来の日付に設定する必要があります。 指定しない場合は、最大日時 9999-12-31 23:59:59 に設定されます。 | string |
recurEvery | メンテナンス期間が繰り返されると予想されるレート。 レートは日、週、月のスケジュールで表すことができます。 毎日のスケジュールは recurEvery として書式設定されます: [頻度 (整数値)]['Day(s)']。 頻度が指定されていない場合、既定の頻度は 1 です。 日単位のスケジュールは、たとえば、recurEvery: Day, recurEvery:3Days になります。 週間スケジュールは recurEvery のフ書式設定されます: [頻度 (整数値)]['Week(s)'] [月曜日から日曜日までの平日をカンマで区切ったリスト(オプション)]。 週単位のスケジュールは、たとえば、recurEvery: 3Weeks, recurEvery:Week Saturday,Sunday になります。 月単位のスケジュールは、[Frequency as integer]['Month(s)'] [Comma separated list of month days] または [Frequency as integer]['Month(s)'] [Week 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 です。 | string |
startDateTime | メンテナンス期間の有効な開始日 (YYYY-MM-DD hh:mm 形式)。 開始日は、現在の日付または将来の日付に設定できます。 ウィンドウは、指定されたタイム ゾーンに作成され、そのタイム ゾーンに応じて夏時間に調整されます。 | string |
timeZone | タイムゾーンの名前。 タイムゾーンの一覧は、PowerShell で [System.TimeZoneInfo]::GetSystemTimeZones() を実行することで取得できます。 例: 太平洋標準時、UTC、W. ヨーロッパ標準時、韓国標準時、Cen。 オーストラリア標準時。 | string |
Terraform (AzAPI プロバイダー) リソース定義
maintenanceConfigurations リソースの種類は、次を対象とする操作でデプロイできます。
- リソース グループ
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.Maintenance/maintenanceConfigurations リソースを作成するには、次の Terraform をテンプレートに追加します。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Maintenance/maintenanceConfigurations@2022-07-01-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
extensionProperties = {}
installPatches = {
linuxParameters = {
classificationsToInclude = [
"string"
]
packageNameMasksToExclude = [
"string"
]
packageNameMasksToInclude = [
"string"
]
}
rebootSetting = "string"
tasks = {
postTasks = [
{
parameters = {}
source = "string"
taskScope = "string"
}
]
preTasks = [
{
parameters = {}
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"
visibility = "string"
}
})
}
プロパティ値
maintenanceConfigurations
名前 | 説明 | 値 |
---|---|---|
type | リソースの種類 | "Microsoft.Maintenance/maintenanceConfigurations@2022-07-01-preview" |
name | リソース名 | string (必須) |
location | リソースの場所を取得または設定します | string |
parent_id | リソース グループにデプロイするには、そのリソース グループの ID を使用します。 | string (必須) |
tags | リソースのタグを取得または設定します | タグ名と値のディクショナリ。 |
properties | リソースのプロパティを取得または設定します | MaintenanceConfigurationProperties |
MaintenanceConfigurationProperties
名前 | 説明 | 値 |
---|---|---|
extensionProperties | maintenanceConfiguration の extensionProperties を取得または設定します | object |
installPatches | パッチ実行操作に渡される入力パラメーター。 このプロパティは、Guest (InGuestPatch) スコープにのみ適用されます。 | InputPatchConfiguration |
maintenanceScope | 構成の maintenanceScope を取得または設定します | "Extension" "Host" "InGuestPatch" "OSImage" "Resource" "SQLDB" "SQLManagedInstance" |
maintenanceWindow | MaintenanceWindow の定義 | MaintenanceWindow |
namespace | リソースの名前空間を取得または設定します | string |
参照可能範囲 | 構成の可視性を取得または設定します。 既定値は、「Custom」です | "Custom" "Public" |
InputPatchConfiguration
名前 | 説明 | 値 |
---|---|---|
linuxParameters | Linux マシンのパッチ適用に固有の入力パラメーター。 Windows マシンの場合は、このプロパティを渡さないでください。 このプロパティは、Guest (InGuestPatch) スコープにのみ適用されます。 | InputLinuxParameters |
rebootSetting | パッチ操作が完了した後にマシンを再起動するかどうかに基づいて、ユーザーが定義した再起動設定の可能性があります。 このプロパティは、Guest (InGuestPatch) スコープにのみ適用されます。 | "Always" "IfRequired" "Never" |
tasks | [サポートされていません]ソフトウェア更新プログラムの構成に関するタスク情報。 | SoftwareUpdateConfigurationTasks |
windowsParameters | Windows マシンの修正プログラムの適用に固有の入力パラメーター。 Linux マシンの場合は、このプロパティを渡さないでください。 このプロパティは、Guest (InGuestPatch) スコープにのみ適用されます。 | InputWindowsParameters |
InputLinuxParameters
名前 | 説明 | 値 |
---|---|---|
classificationsToInclude | パッチを適用するパッチの分類カテゴリ | string[] |
packageNameMasksToExclude | パッチ適用のために除外するパッケージ名。 | string[] |
packageNameMasksToInclude | 修正プログラムを適用するために含めるパッケージ名。 | string[] |
SoftwareUpdateConfigurationTasks
名前 | 説明 | 値 |
---|---|---|
postTasks | [サポートされていません]投稿タスクの一覧。 例: [{'source' :'runbook', 'taskScope': 'Resource', 'parameters': { 'arg1': 'value1'}}] | TaskProperties[] |
preTasks | [サポートされていません]事前タスクの一覧。 例: [{'source' :'Runbook', 'taskScope': 'Global', 'parameters': { 'arg1': 'value1'}}] | TaskProperties[] |
TaskProperties
名前 | 説明 | 値 |
---|---|---|
parameters | [サポートされていません]タスクのパラメーターを取得または設定します。 | object |
source | [サポートされていません]Runbook の名前を取得または設定します。 | string |
taskScope | [サポートされていません]スケジュール トリガー時にグローバル タスクが 1 回実行されます。 各 VM に対してリソース タスクが実行されます。 | "Global" "Resource" |
InputWindowsParameters
名前 | 説明 | 値 |
---|---|---|
classificationsToInclude | パッチを適用するパッチの分類カテゴリ | string[] |
excludeKbsRequiringReboot | 再起動が必要なパッチを除外する | [bool] |
kbNumbersToExclude | 修正プログラムを適用するために除外する Windows KBID。 | string[] |
kbNumbersToInclude | 修正プログラムを適用するために含める Windows KBID。 | string[] |
MaintenanceWindow
名前 | 説明 | 値 |
---|---|---|
duration | HH:mm 形式のメンテナンス期間。 指定しない場合は、指定されたメンテナンス範囲に基づいて既定値が使用されます。 例: 05:00。 | string |
expirationDateTime | メンテナンス期間の有効な有効期限 (YYYY-MM-DD hh:mm 形式)。 ウィンドウは、指定されたタイム ゾーンに作成され、そのタイム ゾーンに応じて夏時間に調整されます。 有効期限は、将来の日付に設定する必要があります。 指定しない場合は、最大日時 9999-12-31 23:59:59 に設定されます。 | string |
recurEvery | メンテナンス期間が繰り返されると予想されるレート。 レートは日、週、月のスケジュールで表すことができます。 毎日のスケジュールは recurEvery として書式設定されます: [頻度 (整数値)]['Day(s)']。 頻度が指定されていない場合、既定の頻度は 1 です。 日単位のスケジュールは、たとえば、recurEvery: Day, recurEvery:3Days になります。 週間スケジュールは recurEvery のフ書式設定されます: [頻度 (整数値)]['Week(s)'] [月曜日から日曜日までの平日をカンマで区切ったリスト(オプション)]。 週単位のスケジュールは、たとえば、recurEvery: 3Weeks, recurEvery:Week Saturday,Sunday になります。 月単位のスケジュールは、[Frequency as integer]['Month(s)'] [Comma separated list of month days] または [Frequency as integer]['Month(s)'] [Week 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. | string |
startDateTime | メンテナンス期間の有効な開始日 (YYYY-MM-DD hh:mm 形式)。 開始日は、現在の日付または将来の日付に設定できます。 ウィンドウは、指定されたタイム ゾーンに作成され、そのタイム ゾーンに応じて夏時間に調整されます。 | string |
timeZone | タイムゾーンの名前。 タイムゾーンの一覧は、PowerShell で [System.TimeZoneInfo]::GetSystemTimeZones() を実行することで取得できます。 例: 太平洋標準時、UTC、W. ヨーロッパ標準時、韓国標準時、Cen。 オーストラリア標準時。 | string |