Microsoft.Maintenance maintenanceConfigurations

아티클
12/20/2024

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' '호스트' 'InGuestPatch' 'OSImage' '자원' '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: 3주, recurEvery: 주 토요일, 일요일입니다. 월별 일정의 형식은 [Frequency as integer]['Month(s)'] [쉼표로 구분된 월 목록] 또는 [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.	문자열
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' '호스트' 'InGuestPatch' 'OSImage' '자원' '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: 3주, recurEvery: 주 토요일, 일요일입니다. 월별 일정의 형식은 [Frequency as integer]['Month(s)'] [쉼표로 구분된 월 목록] 또는 [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.	문자열
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' '호스트' 'InGuestPatch' 'OSImage' '자원' '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: 3주, recurEvery: 주 토요일, 일요일입니다. 월별 일정의 형식은 [Frequency as integer]['Month(s)'] [쉼표로 구분된 월 목록] 또는 [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.	문자열
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"

다음을 통해 공유

Microsoft.Maintenance maintenanceConfigurations

Bicep 리소스 정의

리소스 형식

속성 값

InputLinuxParameters

InputPatchConfiguration

InputWindowsParameters

MaintenanceConfigurationProperties

MaintenanceConfigurationPropertiesExtensionProperties

MaintenanceConfigurationTags

MaintenanceWindow

Microsoft.Maintenance/maintenanceConfigurations

ARM 템플릿 리소스 정의

리소스 형식

속성 값

InputLinuxParameters

InputPatchConfiguration

InputWindowsParameters

MaintenanceConfigurationProperties

MaintenanceConfigurationPropertiesExtensionProperties

MaintenanceConfigurationTags

MaintenanceWindow

Microsoft.Maintenance/maintenanceConfigurations

Terraform(AzAPI 공급자) 리소스 정의

리소스 형식

속성 값

InputLinuxParameters

InputPatchConfiguration

InputWindowsParameters

MaintenanceConfigurationProperties

MaintenanceConfigurationPropertiesExtensionProperties

MaintenanceConfigurationTags

MaintenanceWindow

Microsoft.Maintenance/maintenanceConfigurations

피드백

추가 리소스