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"
필수 매개 변수
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
리소스 식별자입니다.
선택적 매개 변수
유지 관리 기간(HH:mm 형식)입니다. 제공하지 않으면 제공된 유지 관리 범위에 따라 기본값이 사용됩니다. 예: 05:00.
유지 관리 기간의 유효 만료 날짜(YYYY-MM-DD hh:mm 형식)입니다. 창은 제공된 표준 시간대에 생성되고 해당 표준 시간대에 따라 일광 절약 시간제로 조정됩니다. 만료 날짜는 미래 날짜로 설정해야 합니다. 제공되지 않으면 최대 날짜/시간 9999-12-31 23:59:59로 설정됩니다.
maintenanceConfiguration Expect 값의 extensionProperties를 가져오거나 설정합니다. KEY1=VALUE1 KEY2=VALUE2 ...
위치입니다. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.
구성의 maintenanceScope를 가져오거나 설정합니다.
유지 관리 기간이 되풀이될 것으로 예상되는 속도입니다. 이 속도는 매일, 매주 또는 매월 일정으로 표현할 수 있습니다. 일일 일정은 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.
유지 관리 기간의 유효 시작 날짜(YYYY-MM-DD hh:mm 형식)입니다. 시작 날짜는 현재 날짜 또는 미래 날짜로 설정할 수 있습니다. 창은 제공된 표준 시간대에 생성되고 해당 표준 시간대에 따라 일광 절약 시간제로 조정됩니다.
시간대의 이름입니다. PowerShell에서 [System.TimeZoneInfo]::GetSystemTimeZones()를 실행하여 시간대 목록을 가져올 수 있습니다. 예: 태평양 표준시, UTC, W. 유럽 표준시, 한국 표준시, Cen. 오스트레일리아 표준시.
리소스의 네임스페이스를 가져오거나 설정합니다.
공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.
구성의 표시 여부를 가져오거나 설정합니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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"
필수 매개 변수
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
리소스 식별자입니다.
선택적 매개 변수
확인을 묻는 메시지를 표시하지 마세요.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az maintenance configuration list
구독 내에서 구성 레코드를 가져옵니다.
az maintenance configuration list
예제
MaintenanceConfigurations_List
az maintenance configuration list
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az maintenance configuration show
구성 레코드를 가져옵니다.
az maintenance configuration show --resource-group
--resource-name
예제
MaintenanceConfigurations_GetForResource
az maintenance configuration show --resource-group "examplerg" --resource-name "configuration1"
필수 매개 변수
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
리소스 식별자입니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
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"
필수 매개 변수
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
리소스 식별자입니다.
선택적 매개 변수
유지 관리 기간(HH:mm 형식)입니다. 제공하지 않으면 제공된 유지 관리 범위에 따라 기본값이 사용됩니다. 예: 05:00.
유지 관리 기간의 유효 만료 날짜(YYYY-MM-DD hh:mm 형식)입니다. 창은 제공된 표준 시간대에 생성되고 해당 표준 시간대에 따라 일광 절약 시간제로 조정됩니다. 만료 날짜는 미래 날짜로 설정해야 합니다. 제공되지 않으면 최대 날짜/시간 9999-12-31 23:59:59로 설정됩니다.
maintenanceConfiguration Expect 값의 extensionProperties를 가져오거나 설정합니다. KEY1=VALUE1 KEY2=VALUE2 ...
위치입니다. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.
구성의 maintenanceScope를 가져오거나 설정합니다.
유지 관리 기간이 되풀이될 것으로 예상되는 속도입니다. 이 속도는 매일, 매주 또는 매월 일정으로 표현할 수 있습니다. 일일 일정은 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.
유지 관리 기간의 유효 시작 날짜(YYYY-MM-DD hh:mm 형식)입니다. 시작 날짜는 현재 날짜 또는 미래 날짜로 설정할 수 있습니다. 창은 제공된 표준 시간대에 생성되고 해당 표준 시간대에 따라 일광 절약 시간제로 조정됩니다.
시간대의 이름입니다. PowerShell에서 [System.TimeZoneInfo]::GetSystemTimeZones()를 실행하여 시간대 목록을 가져올 수 있습니다. 예: 태평양 표준시, UTC, W. 유럽 표준시, 한국 표준시, Cen. 오스트레일리아 표준시.
리소스의 네임스페이스를 가져오거나 설정합니다.
공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.
구성의 표시 여부를 가져오거나 설정합니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.