Microsoft.Maintenance maintenanceConfigurations

  • [アーティクル]

Bicep リソース定義

maintenanceConfigurations リソースの種類は、次を対象とする操作と共にデプロイできます。

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.Maintenance/maintenanceConfigurations リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.Maintenance/maintenanceConfigurations@2023-04-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    extensionProperties: {}
    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'
  }
}

プロパティ値

maintenanceConfigurations

名前 説明 値
name リソース名 string (必須)
location リソースの場所を取得または設定します string
tags リソースのタグを取得または設定します タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください
properties リソースのプロパティを取得または設定します MaintenanceConfigurationProperties

MaintenanceConfigurationProperties

名前 説明 値
extensionProperties maintenanceConfiguration の extensionProperties を取得または設定します object
installPatches パッチ実行操作に渡される入力パラメーター。 InputPatchConfiguration
maintenanceScope 構成の maintenanceScope を取得または設定します 'Extension'
'Host'
'InGuestPatch'
'OSImage'
'Resource'
'SQLDB'
'SQLManagedInstance'
maintenanceWindow MaintenanceWindow の定義 MaintenanceWindow
namespace リソースの名前空間を取得または設定します string
参照可能範囲 構成の可視性を取得または設定します。 既定値は、「Custom」です 'Custom'
'Public'

InputPatchConfiguration

名前 説明 値
linuxParameters Linux マシンのパッチ適用に固有の入力パラメーター。 Windows マシンの場合は、このプロパティを渡さないでください。 InputLinuxParameters
rebootSetting パッチ操作が完了した後にマシンを再起動するかどうかに基づいて、ユーザーが定義した再起動設定の可能性があります。 'Always'
'IfRequired'
'Never'
windowsParameters Windows マシンの修正プログラムの適用に固有の入力パラメーター。 Linux マシンの場合は、このプロパティを渡さないでください。 InputWindowsParameters

InputLinuxParameters

名前 説明 値
classificationsToInclude パッチを適用するパッチの分類カテゴリ string[]
packageNameMasksToExclude パッチ適用のために除外するパッケージ名。 string[]
packageNameMasksToInclude 修正プログラムを適用するために含めるパッケージ名。 string[]

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": "2023-04-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "extensionProperties": {},
    "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"
  }
}

プロパティ値

maintenanceConfigurations

名前 説明 値
type リソースの種類 'Microsoft.Maintenance/maintenanceConfigurations'
apiVersion リソース API のバージョン '2023-04-01'
name リソース名 string (必須)
location リソースの場所を取得または設定します string
tags リソースのタグを取得または設定します タグ名と値のディクショナリ。 「テンプレートのタグ」を参照してください
properties リソースのプロパティを取得または設定します MaintenanceConfigurationProperties

MaintenanceConfigurationProperties

名前 説明 値
extensionProperties maintenanceConfiguration の extensionProperties を取得または設定します object
installPatches パッチ実行操作に渡される入力パラメーター。 InputPatchConfiguration
maintenanceScope 構成の maintenanceScope を取得または設定します 'Extension'
'Host'
'InGuestPatch'
'OSImage'
'Resource'
'SQLDB'
'SQLManagedInstance'
maintenanceWindow MaintenanceWindow の定義 MaintenanceWindow
namespace リソースの名前空間を取得または設定します string
参照可能範囲 構成の可視性を取得または設定します。 既定値は、「Custom」です 'Custom'
'Public'

InputPatchConfiguration

名前 説明 値
linuxParameters Linux マシンのパッチ適用に固有の入力パラメーター。 Windows マシンの場合は、このプロパティを渡さないでください。 InputLinuxParameters
rebootSetting パッチ操作が完了した後にマシンを再起動するかどうかに基づいて、ユーザーが定義した再起動設定の可能性があります。 'Always'
'IfRequired'
'Never'
windowsParameters Windows マシンの修正プログラムの適用に固有の入力パラメーター。 Linux マシンの場合は、このプロパティを渡さないでください。 InputWindowsParameters

InputLinuxParameters

名前 説明 値
classificationsToInclude パッチを適用するパッチの分類カテゴリ string[]
packageNameMasksToExclude パッチ適用のために除外するパッケージ名。 string[]
packageNameMasksToInclude 修正プログラムを適用するために含めるパッケージ名。 string[]

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@2023-04-01"
  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"
        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@2023-04-01"
name リソース名 string (必須)
location リソースの場所を取得または設定します string
parent_id リソース グループにデプロイするには、そのリソース グループの ID を使用します。 string (必須)
tags リソースのタグを取得または設定します タグ名と値のディクショナリ。
properties リソースのプロパティを取得または設定します MaintenanceConfigurationProperties

MaintenanceConfigurationProperties

名前 説明 値
extensionProperties maintenanceConfiguration の extensionProperties を取得または設定します object
installPatches パッチ実行操作に渡される入力パラメーター。 InputPatchConfiguration
maintenanceScope 構成の maintenanceScope を取得または設定します "Extension"
"Host"
"InGuestPatch"
"OSImage"
"Resource"
"SQLDB"
"SQLManagedInstance"
maintenanceWindow MaintenanceWindow の定義 MaintenanceWindow
namespace リソースの名前空間を取得または設定します string
参照可能範囲 構成の可視性を取得または設定します。 既定値は、「Custom」です "Custom"
"パブリック"

InputPatchConfiguration

名前 説明 値
linuxParameters Linux マシンの修正プログラムに固有の入力パラメーター。 Windows マシンの場合は、このプロパティを渡さないでください。 InputLinuxParameters
rebootSetting パッチ操作が完了した後にマシンを再起動するかどうかに基づいて、ユーザーが定義した再起動優先設定が可能です。 "Always"
"IfRequired"
"Never"
windowsParameters Windows マシンの修正プログラムの適用に固有の入力パラメーター。 Linux マシンの場合は、このプロパティを渡さないでください。 InputWindowsParameters

InputLinuxParameters

名前 説明 値
classificationsToInclude パッチを適用するパッチの分類カテゴリ string[]
packageNameMasksToExclude パッチ適用のために除外するパッケージ名。 string[]
packageNameMasksToInclude 修正プログラムを適用するために含めるパッケージ名。 string[]

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