az maintenance configuration

참고 항목

이 참조는 azure CLI(버전 2.56.0 이상)에 대한 기본 테넌트 확장의 일부입니다. 확장은 az 기본tenance 구성 명령을 처음 실행할 때 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

기본 테넌스를 사용하여 기본 테넌트 구성을 관리합니다.

명령

Name	Description	형식	상태
az maintenance configuration create	구성 레코드를 만듭니다.	내선 번호	GA
az maintenance configuration delete	구성 레코드를 삭제합니다.	내선 번호	GA
az maintenance configuration list	구독 및 리소스 그룹 내의 구성 레코드를 나열합니다.	내선 번호	GA
az maintenance configuration show	구성 레코드를 가져옵니다.	내선 번호	GA
az maintenance configuration update	구성 레코드를 업데이트합니다.	내선 번호	GA

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

기본tenanceConfiguration 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

구성의 기본tenanceScope를 가져오거나 설정합니다.

허용되는 값: 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)'] [선택적 쉼표로 구분된 평일 목록 Monday-Sunday] 형식으로 지정됩니다. 주별 일정의 예는 recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday입니다. 월별 일정의 형식은 [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()를 실행하여 가져올 수 있습니다. 예: Standard Time, UTC, W. Europe Standard Time, Korea Standard Time, Cen. Australia Standard Time

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

기본값: 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

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

기본값: False

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

기본값: 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

기본값: 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

기본값: 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

기본tenanceConfiguration 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

구성의 기본tenanceScope를 가져오거나 설정합니다.

허용되는 값: 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)'] [선택적 쉼표로 구분된 평일 목록 Monday-Sunday] 형식으로 지정됩니다. 주별 일정의 예는 recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday입니다. 월별 일정의 형식은 [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()를 실행하여 가져올 수 있습니다. 예: Standard Time, UTC, W. Europe Standard Time, Korea Standard Time, Cen. Australia Standard Time

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

기본값: json

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.