az stack-hci extension

Note

이 참조는 Azure CLI(버전 2.54.0 이상)에 대한 stack-hci 확장의 일부입니다. az stack-hci extension 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

스택 hci를 사용하여 확장을 관리합니다.

명령

Name	Description	형식	상태
az stack-hci extension create	HCI 클러스터에 대한 확장을 만듭니다.	Extension	GA
az stack-hci extension delete	HCI 클러스터의 특정 호 확장을 삭제합니다.	Extension	GA
az stack-hci extension list	호 설정 리소스 아래에 모든 확장을 나열합니다.	Extension	GA
az stack-hci extension show	HCI 클러스터의 특정 호 확장을 가져옵니다.	Extension	GA
az stack-hci extension wait	조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.	Extension	GA

az stack-hci extension create

HCI 클러스터에 대한 확장을 만듭니다.

az stack-hci extension create --arc-setting-name
                              --cluster-name
                              --extension-name --name
                              --resource-group
                              [--auto-upgrade {0, 1, f, false, n, no, t, true, y, yes}]
                              [--force-update-tag]
                              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                              [--protected-settings]
                              [--publisher]
                              [--settings]
                              [--type]
                              [--type-handler-version]

예제

호 확장 만들기

az stack-hci extension create --arc-setting-name "default" --cluster-name "myCluster" --type "MicrosoftMonitoringAgent" --protected-settings '{"workspaceId": "xx", "port": "6516"}' --publisher "Microsoft.Compute" --settings '{"workspaceKey": "xx"}' --type-handler-version "1.10" --name "MicrosoftMonitoringAgent" --resource-group "test-rg"

필수 매개 변수

--arc-setting-name

HCI ArcSetting 정보의 세부 정보를 보유하는 프록시 리소스의 이름입니다.

--cluster-name

클러스터의 이름입니다.

--extension-name --name -n

컴퓨터 확장의 이름입니다.

--resource-group -g

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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--auto-upgrade

배포 시 사용할 수 있는 경우 확장에서 최신 부 버전을 사용해야 하는지 여부를 나타냅니다. 그러나 배포된 후에는 이 속성이 true로 설정되어 있더라도 재배포하지 않는 한 확장은 부 버전을 업그레이드하지 않습니다.

속성	값
매개 변수 그룹:	ExtensionParameters Arguments
허용되는 값:	0, 1, f, false, n, no, t, true, y, yes

--force-update-tag

확장 구성이 변경되지 않은 경우에도 확장 처리기를 강제로 업데이트해야 하는 방법입니다.

속성	값
매개 변수 그룹:	ExtensionParameters Arguments

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

속성	값
허용되는 값:	0, 1, f, false, n, no, t, true, y, yes

--protected-settings

보호된 설정(비밀을 포함할 수 있음). 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

속성	값
매개 변수 그룹:	ExtensionParameters Arguments

--publisher

확장 처리기 게시자의 이름입니다.

속성	값
매개 변수 그룹:	ExtensionParameters Arguments

--settings

확장에 대한 Json 형식의 공용 설정입니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

속성	값
매개 변수 그룹:	ExtensionParameters Arguments

--type

확장의 형식을 지정합니다. 예를 들어 "CustomScriptExtension"이 있습니다.

속성	값
매개 변수 그룹:	ExtensionParameters Arguments

--type-handler-version

스크립트 처리기의 버전을 지정합니다. 지정하지 않으면 최신 버전이 사용됩니다.

속성	값
매개 변수 그룹:	ExtensionParameters Arguments

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az stack-hci extension delete

HCI 클러스터의 특정 호 확장을 삭제합니다.

az stack-hci extension delete [--arc-setting-name]
                              [--cluster-name]
                              [--extension-name --name]
                              [--ids]
                              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                              [--resource-group]
                              [--subscription]
                              [--yes]

예제

호 확장 삭제

az stack-hci extension delete --arc-setting-name "default" --cluster-name "myCluster" --name "MicrosoftMonitoringAgent" --resource-group "test-rg"

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--arc-setting-name

HCI ArcSetting 정보의 세부 정보를 보유하는 프록시 리소스의 이름입니다.

속성	값
매개 변수 그룹:	Resource Id Arguments

--cluster-name

클러스터의 이름입니다.

속성	값
매개 변수 그룹:	Resource Id Arguments

--extension-name --name -n

컴퓨터 확장의 이름입니다.

속성	값
매개 변수 그룹:	Resource Id Arguments

--ids

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

속성	값
매개 변수 그룹:	Resource Id Arguments

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

속성	값
허용되는 값:	0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

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

속성	값
매개 변수 그룹:	Resource Id Arguments

--subscription

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

속성	값
매개 변수 그룹:	Resource Id Arguments

--yes -y

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

속성	값
Default value:	False

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az stack-hci extension list

호 설정 리소스 아래에 모든 확장을 나열합니다.

az stack-hci extension list --arc-setting-name
                            --cluster-name
                            --resource-group
                            [--max-items]
                            [--next-token]

예제

Arc 설정 리소스 아래의 확장 목록

az stack-hci extension list --arc-setting-name "default" --cluster-name "myCluster" --resource-group "test-rg"

필수 매개 변수

--arc-setting-name

HCI ArcSetting 정보의 세부 정보를 보유하는 프록시 리소스의 이름입니다.

--cluster-name

클러스터의 이름입니다.

--resource-group -g

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

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--max-items

명령의 출력에서 반환할 총 항목 수입니다. 사용 가능한 총 항목 수가 지정된 값보다 많으면 명령의 출력에 토큰이 제공됩니다. 페이지 매김을 다시 시작하려면 후속 명령의 --next-token 인수에 토큰 값을 제공합니다.

속성	값
매개 변수 그룹:	Pagination Arguments

--next-token

페이지 매김을 시작할 위치를 지정하는 토큰입니다. 이는 이전에 잘린 응답의 토큰 값입니다.

속성	값
매개 변수 그룹:	Pagination Arguments

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az stack-hci extension show

HCI 클러스터의 특정 호 확장을 가져옵니다.

az stack-hci extension show [--arc-setting-name]
                            [--cluster-name]
                            [--extension-name --name]
                            [--ids]
                            [--resource-group]
                            [--subscription]

예제

호 설정 확장 가져오기

az stack-hci extension show --arc-setting-name "default" --cluster-name "myCluster" --name "MicrosoftMonitoringAgent" --resource-group "test-rg"

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--arc-setting-name

HCI ArcSetting 정보의 세부 정보를 보유하는 프록시 리소스의 이름입니다.

속성	값
매개 변수 그룹:	Resource Id Arguments

--cluster-name

클러스터의 이름입니다.

속성	값
매개 변수 그룹:	Resource Id Arguments

--extension-name --name -n

컴퓨터 확장의 이름입니다.

속성	값
매개 변수 그룹:	Resource Id Arguments

--ids

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

속성	값
매개 변수 그룹:	Resource Id Arguments

--resource-group -g

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

속성	값
매개 변수 그룹:	Resource Id Arguments

--subscription

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

속성	값
매개 변수 그룹:	Resource Id Arguments

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az stack-hci extension wait

조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

az stack-hci extension wait [--arc-setting-name]
                            [--cluster-name]
                            [--created]
                            [--custom]
                            [--deleted]
                            [--exists]
                            [--extension-name --name]
                            [--ids]
                            [--interval]
                            [--resource-group]
                            [--subscription]
                            [--timeout]
                            [--updated]

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--arc-setting-name

HCI ArcSetting 정보의 세부 정보를 보유하는 프록시 리소스의 이름입니다.

속성	값
매개 변수 그룹:	Resource Id Arguments

--cluster-name

클러스터의 이름입니다.

속성	값
매개 변수 그룹:	Resource Id Arguments

--created

'Succeeded'에서 'provisioningState'를 사용하여 생성될 때까지 기다립니다.

속성	값
매개 변수 그룹:	Wait Condition Arguments
Default value:	False

--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

속성	값
매개 변수 그룹:	Wait Condition Arguments

--deleted

삭제될 때까지 기다립니다.

속성	값
매개 변수 그룹:	Wait Condition Arguments
Default value:	False

--exists

리소스가 존재할 때까지 기다립니다.

속성	값
매개 변수 그룹:	Wait Condition Arguments
Default value:	False

--extension-name --name -n

컴퓨터 확장의 이름입니다.

속성	값
매개 변수 그룹:	Resource Id Arguments

--ids

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

속성	값
매개 변수 그룹:	Resource Id Arguments

--interval

폴링 간격(초)입니다.

속성	값
매개 변수 그룹:	Wait Condition Arguments
Default value:	30

--resource-group -g

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

속성	값
매개 변수 그룹:	Resource Id Arguments

--subscription

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

속성	값
매개 변수 그룹:	Resource Id Arguments

--timeout

최대 대기 시간(초)입니다.

속성	값
매개 변수 그룹:	Wait Condition Arguments
Default value:	3600

--updated

'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.

속성	값
매개 변수 그룹:	Wait Condition Arguments
Default value:	False

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

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

--only-show-errors

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

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False