az stack-hci cluster

Note

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

스택 hci를 사용하여 클러스터를 관리합니다.

명령

Name	Description	형식	상태
az stack-hci cluster create	HCI 클러스터를 만듭니다.	Extension	GA
az stack-hci cluster create-identity	클러스터 ID를 만듭니다.	Extension	GA
az stack-hci cluster delete	HCI 클러스터를 삭제합니다.	Extension	GA
az stack-hci cluster extend-software-assurance-benefit	Software Assurance 혜택을 클러스터로 확장합니다.	Extension	GA
az stack-hci cluster identity	ID를 관리합니다.	Extension	GA
az stack-hci cluster identity assign	ID를 할당합니다.	Extension	GA
az stack-hci cluster identity remove	ID를 제거합니다.	Extension	GA
az stack-hci cluster list	구독의 모든 HCI 클러스터를 나열합니다.	Extension	GA
az stack-hci cluster show	HCI 클러스터를 가져옵니다.	Extension	GA
az stack-hci cluster update	HCI 클러스터를 업데이트합니다.	Extension	GA
az stack-hci cluster wait	조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.	Extension	GA

az stack-hci cluster create

HCI 클러스터를 만듭니다.

az stack-hci cluster create --cluster-name --name
                            --resource-group
                            [--aad-application-object-id]
                            [--aad-client-id]
                            [--aad-service-principal-object-id]
                            [--aad-tenant-id]
                            [--desired-properties]
                            [--endpoint]
                            [--location]
                            [--mi-system-assigned {0, 1, f, false, n, no, t, true, y, yes}]
                            [--tags]

예제

클러스터 만들기

az stack-hci cluster create --location "East US" --aad-client-id "24a6e53d-04e5-44d2-b7cc-1b732a847dfc" --aad-tenant-id "7e589cc1-a8b6-4dff-91bd-5ec0fa18db94" --endpoint "https://98294836-31be-4668-aeae-698667faf99b.waconazure.com" --name "myCluster" --resource- group "test-rg"

필수 매개 변수

--cluster-name --name -n

클러스터의 이름입니다.

--resource-group -g

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

선택적 매개 변수

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

--aad-application-object-id

클러스터 AAD ID의 개체 ID입니다.

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

--aad-client-id

클러스터 AAD ID의 앱 ID입니다.

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

--aad-service-principal-object-id

클러스터 ID 서비스 주체의 ID입니다.

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

--aad-tenant-id

클러스터 AAD ID의 테넌트 ID입니다.

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

--desired-properties

클러스터의 Desired 속성입니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

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

--endpoint

Azure Portal에서 관리를 위해 구성된 엔드포인트입니다.

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

--location -l

리소스가 있는 지리적 위치(지정되지 않은 경우) 리소스 그룹의 위치가 사용됩니다.

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

--mi-system-assigned

시스템 할당 ID를 사용하도록 설정합니다.

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

--tags

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

속성	값
매개 변수 그룹:	Cluster 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 cluster create-identity

클러스터 ID를 만듭니다.

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

예제

클러스터 ID 만들기

az stack-hci cluster create-identity --name "myCluster" --resource-group "test-rg"

선택적 매개 변수

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

--cluster-name

클러스터의 이름입니다.

속성	값
매개 변수 그룹:	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

전역 매개 변수

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

HCI 클러스터를 삭제합니다.

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

예제

클러스터 삭제

az stack-hci cluster delete --name "myCluster" --resource-group "test-rg"

선택적 매개 변수

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

--cluster-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 cluster extend-software-assurance-benefit

Software Assurance 혜택을 클러스터로 확장합니다.

az stack-hci cluster extend-software-assurance-benefit [--cluster-name]
                                                       [--ids]
                                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                       [--resource-group]
                                                       [--software-assurance-intent {Disable, Enable}]
                                                       [--subscription]

예제

소프트웨어 보증 혜택 확장

az stack-hci cluster extend-software-assurance-benefit --cluster-name name -g rg --software-assurance-intent enable

선택적 매개 변수

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

--cluster-name

클러스터의 이름입니다.

속성	값
매개 변수 그룹:	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

--software-assurance-intent

Software Assurance 혜택에 대한 고객의 의도입니다.

속성	값
매개 변수 그룹:	Properties Arguments
허용되는 값:	Disable, Enable

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

구독의 모든 HCI 클러스터를 나열합니다.

az stack-hci cluster list [--max-items]
                          [--next-token]
                          [--resource-group]

예제

지정된 리소스 그룹의 클러스터 나열

az stack-hci cluster list --resource-group "test-rg"

지정된 구독의 클러스터 나열

az stack-hci cluster list

선택적 매개 변수

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

--max-items

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

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

--next-token

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

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

--resource-group -g

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

전역 매개 변수

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

HCI 클러스터를 가져옵니다.

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

예제

클러스터 가져오기

az stack-hci cluster show --name "myCluster" --resource-group "test-rg"

선택적 매개 변수

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

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

HCI 클러스터를 업데이트합니다.

az stack-hci cluster update [--aad-client-id]
                            [--aad-tenant-id]
                            [--add]
                            [--cluster-name --name]
                            [--desired-properties]
                            [--endpoint]
                            [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                            [--ids]
                            [--remove]
                            [--resource-group]
                            [--set]
                            [--subscription]
                            [--tags]

예제

클러스터 업데이트

az stack-hci cluster update --endpoint "https://98294836-31be-4668-aeae-698667faf99b.waconazure.com" --desired-properties "{diagnosticLevel:Basic,windowsServerSubscription:Enabled}" --tags "tag:"value" --name "myCluster" --resource-group "test-rg"

선택적 매개 변수

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

--aad-client-id

클러스터 AAD ID의 앱 ID입니다.

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

--aad-tenant-id

클러스터 AAD ID의 테넌트 ID입니다.

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

--add

경로 및 키 값 쌍을 지정하여 개체 목록에 개체를 추가합니다. 예: --add property.listProperty <key=value, string or JSON string>.

속성	값
매개 변수 그룹:	Generic Update Arguments

--cluster-name --name -n

클러스터의 이름입니다.

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

--desired-properties

클러스터의 Desired 속성입니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

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

--endpoint

Azure Portal에서 관리를 위해 구성된 엔드포인트입니다.

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

--force-string

'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.

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

--ids

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

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

--remove

목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list <indexToRemove> OR --remove propertyToRemove.

속성	값
매개 변수 그룹:	Generic Update Arguments

--resource-group -g

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

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

--set

설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=<value>.

속성	값
매개 변수 그룹:	Generic Update Arguments

--subscription

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

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

--tags

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

속성	값
매개 변수 그룹:	Cluster 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 cluster wait

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

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

선택적 매개 변수

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

--cluster-name --name -n

클러스터의 이름입니다.

속성	값
매개 변수 그룹:	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

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