az maintenance configuration

메모

이 참조는 Azure CLI(버전 2.67.0 이상)에 대한 유지 관리 확장의 일부입니다. az maintenance configuration 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대한 자세한 알아봅니다.

유지 관리를 사용하여 유지 관리 구성을 관리합니다.

명령

Name	Description	형식	상태
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 --name
                                    --resource-group
                                    [--duration]
                                    [--expiration-date-time]
                                    [--extension-properties]
                                    [--install-patches-linux-parameters]
                                    [--install-patches-windows-parameters]
                                    [--location]
                                    [--maintenance-scope {Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance}]
                                    [--maintenance-window-recur-every]
                                    [--maintenance-window-start-date-time]
                                    [--maintenance-window-time-zone]
                                    [--namespace]
                                    [--reboot-setting {Always, IfRequired, Never}]
                                    [--tags]
                                    [--visibility {Custom, Public}]

예제

MaintenanceConfigurations_CreateOrUpdateForResource

az maintenance configuration create --location "westus2" --maintenance-scope "OSImage" --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 "2020-04-30 08:00" --maintenance-window-time-zone "Pacific Standard Time" --namespace "Microsoft.Maintenance" --visibility "Custom" --resource-group "examplerg" --resource-name "configuration1"

필수 매개 변수

--name --resource-name -n

유지 관리 구성 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<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 Support shorthand-syntax, json-file 및 yaml-file의 extensionProperties를 가져오거나 설정합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--install-patches-linux-parameters --linux-parameters

Linux 머신 패치와 관련된 입력 매개 변수입니다. Windows 컴퓨터의 경우 이 속성을 전달하지 마세요. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--install-patches-windows-parameters --windows-parameters

Windows 컴퓨터 패치와 관련된 입력 매개 변수입니다. Linux 컴퓨터의 경우 이 속성을 전달하지 마세요. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--location -l

리소스의 위치를 가져오거나 설정합니다.

--maintenance-scope

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

허용되는 값: Extension, Host, InGuestPatch, 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: 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.

--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

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

--reboot-setting

패치 작업이 완료된 후 컴퓨터를 다시 부팅할지 여부에 따라 사용자가 정의한 대로 가능한 다시 부팅 기본 설정입니다.

허용되는 값: Always, IfRequired, Never

--tags

리소스 지원 약식 구문, json-file 및 yaml-file의 태그를 가져오거나 설정합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--visibility

구성의 표시 여부를 가져오거나 설정합니다. 기본값은 'Custom'입니다.

허용되는 값: Custom, Public

전역 매개 변수

--debug

로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅 세부 정보를 늘립니다. 전체 디버그 로그에 --debug를 사용합니다.

az maintenance configuration delete

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

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

예제

MaintenanceConfigurations_DeleteForResource

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

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name --resource-name -n

유지 관리 구성 이름입니다.

--resource-group -g

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

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--yes -y

확인 메시지를 표시하지 않습니다.

Default value: False

전역 매개 변수

--debug

로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅 세부 정보를 늘립니다. 전체 디버그 로그에 --debug를 사용합니다.

az maintenance configuration list

구독 및 리소스 그룹 내의 구성 레코드를 나열합니다.

az maintenance configuration list [--resource-group]

예제

MaintenanceConfigurations_List

az maintenance configuration list

선택적 매개 변수

--resource-group -g

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

전역 매개 변수

--debug

로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅 세부 정보를 늘립니다. 전체 디버그 로그에 --debug를 사용합니다.

az maintenance configuration show

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

az maintenance configuration show [--ids]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]

예제

MaintenanceConfigurations_GetForResource

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

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name --resource-name -n

유지 관리 구성 이름입니다.

--resource-group -g

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

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

전역 매개 변수

--debug

로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅 세부 정보를 늘립니다. 전체 디버그 로그에 --debug를 사용합니다.

az maintenance configuration update

구성 레코드를 업데이트합니다.

az maintenance configuration update [--duration]
                                    [--expiration-date-time]
                                    [--extension-properties]
                                    [--ids]
                                    [--install-patches-linux-parameters]
                                    [--install-patches-windows-parameters]
                                    [--location]
                                    [--maintenance-scope {Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance}]
                                    [--maintenance-window-recur-every]
                                    [--maintenance-window-start-date-time]
                                    [--maintenance-window-time-zone]
                                    [--name]
                                    [--namespace]
                                    [--reboot-setting {Always, IfRequired, Never}]
                                    [--resource-group]
                                    [--subscription]
                                    [--tags]
                                    [--visibility {Custom, Public}]

예제

MaintenanceConfigurations_UpdateForResource

az maintenance configuration update --location "westus2" --maintenance-scope "OSImage" --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 "2020-04-30 08:00" --maintenance-window-time-zone "Pacific Standard Time" --namespace "Microsoft.Maintenance" --visibility "Custom" --resource-group "examplerg" --resource-name "configuration1"

선택적 매개 변수

--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 Support shorthand-syntax, json-file 및 yaml-file의 extensionProperties를 가져오거나 설정합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--install-patches-linux-parameters --linux-parameters

Linux 머신 패치와 관련된 입력 매개 변수입니다. Windows 컴퓨터의 경우 이 속성을 전달하지 마세요. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--install-patches-windows-parameters --windows-parameters

Windows 컴퓨터 패치와 관련된 입력 매개 변수입니다. Linux 컴퓨터의 경우 이 속성을 전달하지 마세요. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--location -l

리소스의 위치를 가져오거나 설정합니다.

--maintenance-scope

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

허용되는 값: Extension, Host, InGuestPatch, 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: 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.

--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. 오스트레일리아 표준시.

--name --resource-name -n

유지 관리 구성 이름입니다.

--namespace

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

--reboot-setting

패치 작업이 완료된 후 컴퓨터를 다시 부팅할지 여부에 따라 사용자가 정의한 대로 가능한 다시 부팅 기본 설정입니다.

허용되는 값: Always, IfRequired, Never

--resource-group -g

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

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--tags

리소스 지원 약식 구문, json-file 및 yaml-file의 태그를 가져오거나 설정합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--visibility

구성의 표시 여부를 가져오거나 설정합니다. 기본값은 'Custom'입니다.

허용되는 값: Custom, Public

전역 매개 변수

--debug

로깅 세부 정보를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅 세부 정보를 늘립니다. 전체 디버그 로그에 --debug를 사용합니다.