次の方法で共有


Microsoft.Maintenance maintenanceConfigurations

Bicep リソース定義

maintenanceConfigurations リソースの種類は、次をターゲットとする操作でデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

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

リソースの形式

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

resource symbolicname 'Microsoft.Maintenance/maintenanceConfigurations@2023-10-01-preview' = {
  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 メンテナンス期間が繰り返されると予想されるレート。 料金は、毎日、毎週、または毎月のスケジュールとして表すことができます。 1 日のスケジュールは recurEvery として書式設定されます。[Frequency as integer]['Day(s)']。 頻度が指定されていない場合、既定の頻度は 1 です。 毎日のスケジュールの例は recurEvery: Day、recurEvery: 3Days です。 週単位のスケジュールは recurEvery として書式設定されます。[Frequency as integer]['Week(s)'] [Optional comma separated list of weekdays monday-sunday]\ (週単位のスケジュールは、整数としての頻度]['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 までの範囲である必要があります。 月次スケジュールの例は、繰り返しです。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

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

ARM テンプレート リソース定義

maintenanceConfigurations リソースの種類は、次をターゲットとする操作でデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

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

リソースの形式

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

{
  "type": "Microsoft.Maintenance/maintenanceConfigurations",
  "apiVersion": "2023-10-01-preview",
  "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 メンテナンス期間が繰り返されると予想されるレート。 料金は、毎日、毎週、または毎月のスケジュールとして表すことができます。 1 日のスケジュールは recurEvery として書式設定されます。[Frequency as integer]['Day(s)']。 頻度が指定されていない場合、既定の頻度は 1 です。 毎日のスケジュールの例は recurEvery: Day、recurEvery: 3Days です。 週単位のスケジュールは recurEvery として書式設定されます。[Frequency as integer]['Week(s)'] [Optional comma separated list of weekdays monday-sunday]\ (週単位のスケジュールは、整数としての頻度]['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 までの範囲である必要があります。 月次スケジュールの例は、繰り返しです。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-10-01-preview'
場所 リソースの場所を取得または設定します。
名前 リソース名 string (必須)
プロパティ リソースのプロパティを取得または設定します。 MaintenanceConfigurationProperties
タグ リソース タグ タグ名と値のディクショナリ。 テンプレート の タグを参照してください
種類 リソースの種類 'Microsoft.Maintenance/maintenanceConfigurations'

Terraform (AzAPI プロバイダー) リソース定義

maintenanceConfigurations リソースの種類は、次をターゲットとする操作でデプロイできます。

  • リソース グループの

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

リソースの形式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Maintenance/maintenanceConfigurations@2023-10-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"
        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 メンテナンス期間が繰り返されると予想されるレート。 料金は、毎日、毎週、または毎月のスケジュールとして表すことができます。 1 日のスケジュールは recurEvery として書式設定されます。[Frequency as integer]['Day(s)']。 頻度が指定されていない場合、既定の頻度は 1 です。 毎日のスケジュールの例は recurEvery: Day、recurEvery: 3Days です。 週単位のスケジュールは recurEvery として書式設定されます。[Frequency as integer]['Week(s)'] [Optional comma separated list of weekdays monday-sunday]\ (週単位のスケジュールは、整数としての頻度]['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 までの範囲である必要があります。 月次スケジュールの例は、繰り返しです。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

名前 形容 価値
場所 リソースの場所を取得または設定します。
名前 リソース名 string (必須)
プロパティ リソースのプロパティを取得または設定します。 MaintenanceConfigurationProperties
タグ リソース タグ タグ名と値のディクショナリ。
種類 リソースの種類 "Microsoft.Maintenance/maintenanceConfigurations@2023-10-01-preview"