az maintenance configuration

참고

이 참조는 Azure CLI 대한 유지 관리 확장의 일부이며 버전 2.15.0 이상에 필요합니다. az maintenance configuration 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.

유지 관리를 통해 유지 관리 구성을 관리합니다.

명령

az maintenance configuration create

구성 레코드를 만듭니다.

az maintenance configuration delete

구성 레코드를 삭제합니다.

az maintenance configuration list

구독 내에서 구성 레코드를 가져옵니다.

az maintenance configuration show

구성 레코드를 가져옵니다.

az maintenance configuration update

패치 구성 레코드.

az maintenance configuration create

구성 레코드를 만듭니다.

az maintenance configuration create --resource-group
                                    --resource-name
                                    [--duration]
                                    [--expiration-date-time]
                                    [--extension-properties]
                                    [--location]
                                    [--maintenance-scope {All, Extension, Host, InGuestPatch, InResource, OSImage, Resource, SQLDB, SQLManagedInstance}]
                                    [--maintenance-window-recur-every]
                                    [--maintenance-window-start-date-time]
                                    [--maintenance-window-time-zone]
                                    [--namespace]
                                    [--tags]
                                    [--visibility {Custom, Public}]

예제

MaintenanceConfigurations_CreateOrUpdateForResource

az maintenance configuration create --location "westus2" --maintenance-scope "Host" --maintenance-window-duration "05:00" --maintenance-window-expiration-date-time "9999-12-31 00:00" --maintenance-window-recur-every "Day" --maintenance-window-start-date-time "2025-04-30 08:00" --maintenance-window-time-zone "Pacific Standard Time" --namespace "Microsoft.Maintenance" --visibility "Custom" --resource-group "examplerg" --resource-name "configuration1"

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--resource-name

리소스 식별자입니다.

선택적 매개 변수

--duration --maintenance-window-duration

유지 관리 기간(HH:mm 형식)입니다. 제공하지 않으면 제공된 유지 관리 범위에 따라 기본값이 사용됩니다. 예: 05:00.

--expiration-date-time --maintenance-window-expiration-date-time

유지 관리 기간의 유효 만료 날짜(YYYY-MM-DD hh:mm 형식)입니다. 창은 제공된 표준 시간대에 생성되고 해당 표준 시간대에 따라 일광 절약 시간제로 조정됩니다. 만료 날짜는 미래 날짜로 설정해야 합니다. 제공되지 않으면 최대 날짜/시간 9999-12-31 23:59:59로 설정됩니다.

--extension-properties

maintenanceConfiguration Expect 값의 extensionProperties를 가져오거나 설정합니다. KEY1=VALUE1 KEY2=VALUE2 ...

--location -l

위치입니다. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--maintenance-scope

구성의 maintenanceScope를 가져오거나 설정합니다.

허용되는 값: All, Extension, Host, InGuestPatch, InResource, OSImage, Resource, SQLDB, SQLManagedInstance
--maintenance-window-recur-every --recur-every

유지 관리 기간이 되풀이될 것으로 예상되는 속도입니다. 이 속도는 매일, 매주 또는 매월 일정으로 표현할 수 있습니다. 일일 일정은 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)'] [Month(s)] [쉼표로 구분된 월 일 목록] 또는 [Frequency as integer]['Month(s)'] [Week of Month (First, Second, Third, Fourth, Last)] [Weekday Monday-Sunday]로 형식이 지정됩니다. 월별 일정 예제는 recurEvery: Month, recurEvery: 2Months, recurEvery: Month day23,day24, recurEvery: Month Last Sunday, recurEvery: Month Fourth Monday.

--maintenance-window-start-date-time --start-date-time

유지 관리 기간의 유효 시작 날짜(YYYY-MM-DD hh:mm 형식)입니다. 시작 날짜는 현재 날짜 또는 미래 날짜로 설정할 수 있습니다. 창은 제공된 표준 시간대에 생성되고 해당 표준 시간대에 따라 일광 절약 시간제로 조정됩니다.

--maintenance-window-time-zone --time-zone

시간대의 이름입니다. PowerShell에서 [System.TimeZoneInfo]::GetSystemTimeZones()를 실행하여 시간대 목록을 가져올 수 있습니다. 예: 태평양 표준시, UTC, W. 유럽 표준시, 한국 표준시, Cen. 오스트레일리아 표준시.

--namespace

리소스의 네임스페이스를 가져오거나 설정합니다.

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--visibility

구성의 표시 여부를 가져오거나 설정합니다.

허용되는 값: Custom, Public

az maintenance configuration delete

구성 레코드를 삭제합니다.

az maintenance configuration delete --resource-group
                                    --resource-name
                                    [--yes]

예제

MaintenanceConfigurations_DeleteForResource

az maintenance configuration delete --resource-group "examplerg" --resource-name "example1"

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--resource-name

리소스 식별자입니다.

선택적 매개 변수

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

az maintenance configuration list

구독 내에서 구성 레코드를 가져옵니다.

az maintenance configuration list

예제

MaintenanceConfigurations_List

az maintenance configuration list

az maintenance configuration show

구성 레코드를 가져옵니다.

az maintenance configuration show --resource-group
                                  --resource-name

예제

MaintenanceConfigurations_GetForResource

az maintenance configuration show --resource-group "examplerg" --resource-name "configuration1"

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--resource-name

리소스 식별자입니다.

az maintenance configuration update

패치 구성 레코드.

az maintenance configuration update --resource-group
                                    --resource-name
                                    [--duration]
                                    [--expiration-date-time]
                                    [--extension-properties]
                                    [--location]
                                    [--maintenance-scope {All, Extension, Host, InGuestPatch, InResource, OSImage, Resource, SQLDB, SQLManagedInstance}]
                                    [--maintenance-window-recur-every]
                                    [--maintenance-window-start-date-time]
                                    [--maintenance-window-time-zone]
                                    [--namespace]
                                    [--tags]
                                    [--visibility {Custom, Public}]

예제

MaintenanceConfigurations_UpdateForResource

az maintenance configuration update --location "westus2" --maintenance-scope "Host" --maintenance-window-duration "05:00" --maintenance-window-expiration-date-time "9999-12-31 00:00" --maintenance-window-recur-every "Month Third Sunday" --maintenance-window-start-date-time "2025-04-30 08:00" --maintenance-window-time-zone "Pacific Standard Time" --namespace "Microsoft.Maintenance" --visibility "Custom" --resource-group "examplerg" --resource-name "configuration1"

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--resource-name

리소스 식별자입니다.

선택적 매개 변수

--duration --maintenance-window-duration

유지 관리 기간(HH:mm 형식)입니다. 제공하지 않으면 제공된 유지 관리 범위에 따라 기본값이 사용됩니다. 예: 05:00.

--expiration-date-time --maintenance-window-expiration-date-time

유지 관리 기간의 유효 만료 날짜(YYYY-MM-DD hh:mm 형식)입니다. 창은 제공된 표준 시간대에 생성되고 해당 표준 시간대에 따라 일광 절약 시간제로 조정됩니다. 만료 날짜는 미래 날짜로 설정해야 합니다. 제공되지 않으면 최대 날짜/시간 9999-12-31 23:59:59로 설정됩니다.

--extension-properties

maintenanceConfiguration Expect 값의 extensionProperties를 가져오거나 설정합니다. KEY1=VALUE1 KEY2=VALUE2 ...

--location -l

위치입니다. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--maintenance-scope

구성의 maintenanceScope를 가져오거나 설정합니다.

허용되는 값: All, Extension, Host, InGuestPatch, InResource, OSImage, Resource, SQLDB, SQLManagedInstance
--maintenance-window-recur-every --recur-every

유지 관리 기간이 되풀이될 것으로 예상되는 속도입니다. 이 속도는 매일, 매주 또는 매월 일정으로 표현할 수 있습니다. 일일 일정은 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)'] [Month(s)] [쉼표로 구분된 월 일 목록] 또는 [Frequency as integer]['Month(s)'] [Week of Month (First, Second, Third, Fourth, Last)] [Weekday Monday-Sunday]로 형식이 지정됩니다. 월별 일정 예제는 recurEvery: Month, recurEvery: 2Months, recurEvery: Month day23,day24, recurEvery: Month Last Sunday, recurEvery: Month Fourth Monday.

--maintenance-window-start-date-time --start-date-time

유지 관리 기간의 유효 시작 날짜(YYYY-MM-DD hh:mm 형식)입니다. 시작 날짜는 현재 날짜 또는 미래 날짜로 설정할 수 있습니다. 창은 제공된 표준 시간대에 생성되고 해당 표준 시간대에 따라 일광 절약 시간제로 조정됩니다.

--maintenance-window-time-zone --time-zone

시간대의 이름입니다. PowerShell에서 [System.TimeZoneInfo]::GetSystemTimeZones()를 실행하여 시간대 목록을 가져올 수 있습니다. 예: 태평양 표준시, UTC, W. 유럽 표준시, 한국 표준시, Cen. 오스트레일리아 표준시.

--namespace

리소스의 네임스페이스를 가져오거나 설정합니다.

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--visibility

구성의 표시 여부를 가져오거나 설정합니다.

허용되는 값: Custom, Public