az aksarc

Note

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

프로비전된 클러스터를 관리합니다.

명령

속성	Description	형식	상태
az aksarc create	프로비전된 클러스터를 만듭니다.	Extension	GA
az aksarc delete	프로비전된 클러스터를 삭제합니다.	Extension	GA
az aksarc deploy	하나 이상의 기존 Arc-for-Servers(BareMetal) 호스트에 전체 AKS 베어메탈 클러스터를 배포합니다.	Extension	GA
az aksarc get-credentials	프로비전된 클러스터의 로컬 kubeconfig를 가져옵니다.	Extension	GA
az aksarc get-logs	프로비전된 클러스터 및 기본 인프라에서 로그를 수집합니다.	Extension	GA
az aksarc get-upgrades	프로비전된 클러스터에 사용할 수 있는 업그레이드 버전을 가져옵니다.	Extension	GA
az aksarc get-versions	지정된 사용자 지정 위치에 지원되는 Kubernetes 버전을 나열합니다.	Extension	GA
az aksarc list	리소스 그룹 또는 구독에서 프로비전된 클러스터를 나열합니다.	Extension	GA
az aksarc logs	Deprecated. 대신 'az aksarc get-logs'를 사용합니다.	Extension	GA
az aksarc logs hci	프로비전된 클러스터 및 기본 인프라에서 로그를 수집합니다.	Extension	Deprecated
az aksarc nodepool	프로비전된 클러스터에서 nodepool을 관리합니다.	Extension	GA
az aksarc nodepool add	프로비전된 클러스터에 nodepool을 추가합니다.	Extension	GA
az aksarc nodepool delete	프로비전된 클러스터에서 nodepool을 삭제합니다.	Extension	GA
az aksarc nodepool list	프로비전된 클러스터의 모든 노드 풀을 나열합니다.	Extension	GA
az aksarc nodepool scale	프로비전된 클러스터에서 nodepool의 크기를 조정합니다.	Extension	GA
az aksarc nodepool show	프로비전된 클러스터의 nodepool을 가져옵니다.	Extension	GA
az aksarc nodepool update	프로비전된 클러스터에서 nodepool을 업데이트합니다.	Extension	GA
az aksarc notice	사용자가 지정한 파일 경로에 알림 파일을 출력합니다.	Extension	GA
az aksarc release	프로비전된 클러스터에 대한 VHD 이미지를 관리합니다.	Extension	Preview
az aksarc release download	릴리스에서 VHD 이미지를 다운로드합니다.	Extension	Preview
az aksarc release save	다운로드한 VHD 이미지를 아크 리소스 브리지에 프로비전합니다.	Extension	Preview
az aksarc show	프로비전된 클러스터를 가져옵니다.	Extension	GA
az aksarc undeploy	이전에 'az aksarc deploy'에서 만든 AKS baremetal 클러스터를 분해합니다.	Extension	GA
az aksarc update	프로비전된 클러스터를 업데이트합니다.	Extension	GA
az aksarc upgrade	프로비전된 클러스터를 업그레이드합니다.	Extension	GA
az aksarc vmsize	프로비전된 클러스터에 대한 가상 머신 SKU를 관리합니다.	Extension	GA
az aksarc vmsize list	지정된 사용자 지정 위치에 지원되는 가상 머신 크기를 나열합니다.	Extension	GA
az aksarc vnet	프로비전된 클러스터에 대한 가상 네트워크를 관리합니다.	Extension	GA
az aksarc vnet create	가상 네트워크를 만듭니다.	Extension	GA
az aksarc vnet delete	가상 네트워크를 삭제합니다.	Extension	GA
az aksarc vnet list	리소스 그룹 또는 구독별로 가상 네트워크를 나열합니다.	Extension	GA
az aksarc vnet show	가상 네트워크를 가져옵니다.	Extension	GA

az aksarc create

프로비전된 클러스터를 만듭니다.

az aksarc create --custom-location
                 --name
                 --resource-group
                 --vnet-id --vnet-ids
                 [--aad-admin-group-object-ids]
                 [--acquire-policy-token]
                 [--ca-certs --custom-ca-trust-certificates]
                 [--ca-profile --cluster-autoscaler-profile]
                 [--change-reference]
                 [--control-plane-count --control-plane-node-count]
                 [--control-plane-ip]
                 [--control-plane-vm-size]
                 [--disable-nfs-driver]
                 [--disable-smb-driver]
                 [--enable-ahub]
                 [--enable-ai-toolchain-operator --enable-kaito]
                 [--enable-azure-rbac]
                 [--enable-cluster-autoscaler]
                 [--enable-oidc-issuer]
                 [--enable-wi --enable-workload-identity]
                 [--gateway-id]
                 [--generate-ssh-keys]
                 [--gpu-count-per-node]
                 [--kubernetes-version]
                 [--load-balancer-count]
                 [--location]
                 [--max-count]
                 [--max-pods]
                 [--min-count]
                 [--no-wait]
                 [--node-count]
                 [--node-vm-size]
                 [--nodepool-labels]
                 [--nodepool-taints]
                 [--pod-cidr]
                 [--ssh-auth-ips --ssh-authorized-ip-ranges]
                 [--ssh-key-value]
                 [--tags]
                 [--validate]

예제

PutProvisionedCluster

az aksarc create --resource-group sample-rg --custom-location sample-cl --name sample-aksarccluster --vnet-ids "vnet-arm-id"

필수 매개 변수

--custom-location

프로비전된 클러스터에 사용할 사용자 지정 위치의 이름 또는 ID입니다.

--name -n

프로비전된 클러스터의 이름입니다.

--resource-group -g

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

--vnet-id --vnet-ids

aksarc 가상 네트워크 또는 Azure 로컬 논리 네트워크의 ARM 리소스 ID입니다.

선택적 매개 변수

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

--aad-admin-group-object-ids -i

프로비전된 클러스터에서 클러스터 관리자로 설정될 aad 그룹 개체 ID의 쉼표로 구분된 목록입니다.

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--ca-certs --custom-ca-trust-certificates

보안 프로필에 대한 사용자 지정 CA 트러스트 인증서가 포함된 파일의 경로입니다. 파일에는 여러 PEM 형식 인증서(최대 10개)가 포함될 수 있습니다. 각 인증서는 base64로 인코딩되고 모든 노드의 트러스트 저장소에 추가됩니다.

--ca-profile --cluster-autoscaler-profile

클러스터 자동 크기 조정기를 구성하기 위한 키=값 쌍의 공백으로 구분된 목록입니다. 빈 문자열을 전달하여 프로필을 지웁다.

--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--control-plane-count --control-plane-node-count

컨트롤 플레인 노드 수입니다.

--control-plane-ip

Kubernetes APIServer IPAddress. IPAddress는 Azure Resource Bridge 어플라이언스에서 라우팅할 수 있어야 VM.It 참조되는 네트워크 서브넷의 일부여야 합니다. 라우팅할 수 없는 IPAddress가 전달되면 클러스터 만들기가 실패하거나 시간 제한이 발생할 수 있습니다.

--control-plane-vm-size

제어 평면의 VM 크기입니다.

--disable-nfs-driver

프로비전된 클러스터에 대해 NFS 드라이버를 사용하지 않도록 설정합니다.

속성	값
Default value:	False

--disable-smb-driver

프로비전된 클러스터에 대해 SMB 드라이버를 사용하지 않도록 설정합니다.

속성	값
Default value:	False

--enable-ahub

프로비전된 클러스터에 Azure AHUB(하이브리드 사용자 혜택)를 사용하도록 설정합니다.

속성	값
Default value:	False

--enable-ai-toolchain-operator --enable-kaito

프로비전된 클러스터에 대해 AI 도구 체인 연산자를 사용하도록 설정합니다.

속성	값
Default value:	False

--enable-azure-rbac

Azure RBAC를 사용하도록 설정하여 클러스터에서 권한 부여 검사를 제어합니다.

속성	값
Default value:	False

--enable-cluster-autoscaler -e

프로비전된 클러스터에 대해 클러스터 자동 크기 조정기를 사용하도록 설정합니다.

속성	값
Default value:	False

--enable-oidc-issuer

OIDC 발급자를 사용하도록 설정합니다.

속성	값
Default value:	False

--enable-wi --enable-workload-identity

워크로드 ID 추가 기능을 사용하도록 설정합니다.

속성	값
Default value:	False

--gateway-id

프로비전된 클러스터의 게이트웨이 Arm ID입니다.

--generate-ssh-keys

ssh 키 쌍이 없으면 생성합니다.

속성	값
Default value:	False

--gpu-count-per-node

노드에 연결된 gpus의 수입니다.

--kubernetes-version -k

프로비전된 클러스터의 kubernetes 버전입니다.

--load-balancer-count

부하 분산 장치 노드 수입니다.

--location -l

Location. 값 출처: az account list-locations. az configure --defaults location=<location>사용하여 기본 위치를 구성할 수 있습니다.

--max-count

자동 크기 조정을 위한 최대 노드 수입니다.

--max-pods -m

노드에서 실행할 수 있는 최대 Pod 수입니다.

--min-count

자동 크기 조정을 위한 최소 노드 수입니다.

--no-wait

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

속성	값
Default value:	False

--node-count -c

nodepool에서 만들 노드 수입니다.

속성	값
Default value:	1

--node-vm-size

nodepool에 있는 노드의 VM 크기입니다.

--nodepool-labels

공백으로 구분된 레이블: key[=value] [key[=value] ...].

--nodepool-taints

nodepool taint의 쉼표로 구분된 목록입니다.

--pod-cidr

CIDR 표기법 IP 범위는 Pod IP를 할당할 범위입니다.

--ssh-auth-ips --ssh-authorized-ip-ranges

클러스터 vm에 ssh할 수 있는 IP 주소 또는 CIDR의 쉼표로 구분된 목록입니다.

--ssh-key-value

제어 평면에 삽입할 ssh 공개 키의 경로입니다.

속성	값
Default value:	~\.ssh\id_rsa.pub

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--validate

실제로 클러스터를 만들지 않고 클러스터의 입력 매개 변수의 유효성을 검사합니다.

속성	값
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/ 참조하세요.

--subscription

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

--verbose

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

속성	값
Default value:	False

az aksarc delete

프로비전된 클러스터를 삭제합니다.

az aksarc delete --name
                 --resource-group
                 [--acquire-policy-token]
                 [--change-reference]
                 [--no-wait]
                 [--yes]

예제

DeleteProvisionedCluster

az aksarc delete --name "sample-aksarccluster" --resource-group "sample-rg"

필수 매개 변수

--name -n

프로비전된 클러스터의 이름입니다.

--resource-group -g

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

선택적 매개 변수

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

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--no-wait

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

속성	값
Default value:	False

--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/ 참조하세요.

--subscription

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

--verbose

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

속성	값
Default value:	False

az aksarc deploy

하나 이상의 기존 Arc-for-Servers(BareMetal) 호스트에 전체 AKS 베어메탈 클러스터를 배포합니다.

하나 이상의 기존 Arc-for-Servers(BareMetal) 호스트에 완전한 AKS 베어메탈 클러스터를 배포합니다. 필요한 유일한 입력은 클러스터를 구성하는 Arc 지원 컴퓨터 이름 목록입니다. 호스트는 이미 Arc-for-Servers를 사용하도록 설정되어 있어야 합니다.

az aksarc deploy --arc-machine-name --arc-machine-names --machine-names
                 --resource-group
                 [--acquire-policy-token]
                 [--change-reference]
                 [--enable-wi --enable-workload-identity]
                 [--hci-rp-object-id]
                 [--kubernetes-version]
                 [--no-wait]
                 [--validate]
                 [--yes]

예제

단일 노드 AKS 베어메탈 클러스터 배포

az aksarc deploy --resource-group sample-rg --arc-machine-names myArcHost

다중 노드 AKS baremetal 클러스터 배포

az aksarc deploy --resource-group sample-rg --arc-machine-names host1 host2 host3

WorkloadIdentity 지원을 사용하도록 설정된 배포

az aksarc deploy --resource-group sample-rg --arc-machine-names myArcHost --enable-workload-identity

특정 Kubernetes 버전이 지정된 번들 배포

az aksarc deploy --resource-group sample-rg --arc-machine-names myArcHost --kubernetes-version 1.35.5-20260701

Microsoft Graph 조회 없이 배포

az aksarc deploy --resource-group sample-rg --arc-machine-names myArcHost --hci-rp-object-id <hci-rp-object-id>

배포하지 않고 유효성 검사

az aksarc deploy --resource-group sample-rg --arc-machine-names host1 host2 --validate

필수 매개 변수

--arc-machine-name --arc-machine-names --machine-names -m

클러스터 디바이스 풀을 형성하기 위해 리소스 그룹에 있는 기존 Arc 지원(Arc-for-Servers) 컴퓨터의 공백으로 구분된 이름입니다. 단일 노드 풀에 대해 하나 또는 다중 노드 풀에 대해 여러 개의 풀을 제공합니다. 이것이 유일한 필수 입력입니다. 다른 모든 클러스터 리소스는 자동으로 파생됩니다.

--resource-group -g

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

선택적 매개 변수

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

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--enable-wi --enable-workload-identity

Azure IoT 작업 데 필요한 워크로드 ID 및 OIDC 발급자를 사용하도록 설정합니다.

속성	값
Default value:	False

--hci-rp-object-id

Microsoft 테넌트별 개체 ID입니다. AzureStackHCI 리소스 공급자 서비스 주체. 생략하면 CLI는 설정된 경우 HCI_RP_OBJECT_ID 사용한 다음, Microsoft Graph 돌아갑니다.

--kubernetes-version -k

클러스터에 대한 Kubernetes 버전 번들(예: 1.35.5-20260701). 생략하면 AKS Arc 연산자는 현재 기본 버전을 선택합니다.

--no-wait

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

속성	값
Default value:	False

--validate

실제로 배포하지 않고 배포 템플릿의 유효성을 검사합니다.

속성	값
Default value:	False

--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/ 참조하세요.

--subscription

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

--verbose

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

속성	값
Default value:	False

az aksarc get-credentials

프로비전된 클러스터의 로컬 kubeconfig를 가져옵니다.

az aksarc get-credentials --name
                          --resource-group
                          [--acquire-policy-token]
                          [--admin]
                          [--change-reference]
                          [--context]
                          [--file]
                          [--overwrite-existing]

예제

GetAdminCredential

az aksarc get-credentials --name "sample-aksarccluster" --resource-group "sample-rg" --admin

GetAADUserCredential

az aksarc get-credentials --name "sample-aksarccluster" --resource-group "sample-rg"

필수 매개 변수

--name -n

프로비전된 클러스터의 이름입니다.

--resource-group -g

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

선택적 매개 변수

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

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--admin -a

클러스터 관리자 자격 증명을 가져옵니다.

속성	값
Default value:	False

--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--context

지정한 경우 기본 컨텍스트 이름을 덮어씁 수 있습니다.

--file -f

업데이트할 Kubernetes 구성 파일입니다. 제공되지 않으면 '~/.kube/config' 파일을 업데이트합니다.

속성	값
Default value:	~\.kube\config

--overwrite-existing

동일한 이름으로 기존 클러스터 항목을 덮어씁 수 있습니다.

속성	값
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/ 참조하세요.

--subscription

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

--verbose

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

속성	값
Default value:	False

az aksarc get-logs

프로비전된 클러스터 및 기본 인프라에서 로그를 수집합니다.

az aksarc get-logs [--acquire-policy-token]
                   [--change-reference]
                   [--credentials-dir --ssh-key]
                   [--ip --ips]
                   [--kubeconfig]
                   [--out-dir]

예제

IP 주소 및 SSH 자격 증명을 사용하여 로그 수집

az aksarc get-logs --ip 192.168.200.31 192.168.200.32 --ssh-key ~/.ssh --out-dir ./logs

kubeconfig 및 SSH 자격 증명을 사용하여 로그를 수집하고, kubeconfig는 IP 주소를 수집하는 데만 사용되며, ssh 키 파일 경로는 디렉터리 대신 사용됩니다.

az aksarc get-logs --kubeconfig ~/.kube/config --ssh-key ~/.ssh/id_rsa --out-dir ./logs

선택적 매개 변수

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

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--credentials-dir --ssh-key

id_rsa 파일 또는 디렉터리 중 하나를 노드에 연결할 SSH 자격 증명의 경로가 허용됩니다.

--ip --ips

로그를 수집해야 하는 노드(컨트롤 플레인 노드 또는 작업자 노드)의 IP 주소입니다.

--kubeconfig

클러스터에 연결할 kubeconfig 파일의 경로입니다.

--out-dir

수집된 로그를 저장할 출력 디렉터리입니다. 지정하지 않으면 로그가 현재 디렉터리에 저장됩니다.

전역 매개 변수

--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 aksarc get-upgrades

프로비전된 클러스터에 사용할 수 있는 업그레이드 버전을 가져옵니다.

az aksarc get-upgrades --name
                       --resource-group
                       [--acquire-policy-token]
                       [--change-reference]

예제

하이브리드 AKS 프로비저닝된 클러스터에 사용할 수 있는 업그레이드 버전 가져오기

az aksarc get-upgrades --name "samplecluster" --resource-group "sample-rg"

필수 매개 변수

--name -n

프로비전된 클러스터의 이름입니다.

--resource-group -g

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

선택적 매개 변수

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

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성	값
매개 변수 그룹:	Global Policy 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 aksarc get-versions

지정된 사용자 지정 위치에 지원되는 Kubernetes 버전을 나열합니다.

az aksarc get-versions --custom-location
                       [--acquire-policy-token]
                       [--change-reference]
                       [--resource-group]

예제

VMListSkus

az aksarc get-versions -g sample-rg --custom-location sample-cl

필수 매개 변수

--custom-location

지원되는 k8s 버전을 표시하는 데 사용할 사용자 지정 위치의 이름입니다.

선택적 매개 변수

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

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

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

리소스 그룹 또는 구독에서 프로비전된 클러스터를 나열합니다.

az aksarc list [--resource-group]

예제

ListProvisionedClusterByResourceGroup

az aksarc list --resource-group "sample-rg"

ListProvisionedClusterBySubscription

az aksarc list

선택적 매개 변수

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

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

사용자가 지정한 파일 경로에 알림 파일을 출력합니다.

az aksarc notice --output-filepath
                 [--acquire-policy-token]
                 [--change-reference]

예제

GetNoticeFile

az aksarc notice --output-filepath "./Notice"

필수 매개 변수

--output-filepath

NOTICE 파일에 대한 출력 파일 경로입니다.

선택적 매개 변수

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

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

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

프로비전된 클러스터를 가져옵니다.

az aksarc show --name
               --resource-group

예제

GetProvisionedCluster

az aksarc show --name "sample-aksarccluster" --resource-group "sample-rg"

필수 매개 변수

--name -n

프로비전된 클러스터의 이름입니다.

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

이전에 'az aksarc deploy'에서 만든 AKS baremetal 클러스터를 분해합니다.

이전에 'az aksarc deploy'에서 만든 AKS 베어메탈 클러스터를 제거하여 연결된 모든 리소스를 제거합니다. 중단이 완료되지 않은 상태로 남아 있는 경우 명령을 다시 실행하여 다시 시도합니다.

az aksarc undeploy --arc-machine-name --arc-machine-names --machine-names
                   --resource-group
                   [--acquire-policy-token]
                   [--change-reference]
                   [--yes]

예제

지정된 Arc 머신에 대한 AKS Arc 리소스 배포 취소

az aksarc undeploy --resource-group sample-rg --arc-machine-names host1 host2 host3

필수 매개 변수

--arc-machine-name --arc-machine-names --machine-names -m

AKS Arc 배포를 중단해야 하는 Arc 머신의 공백으로 구분된 이름입니다. 리소스 이름은 해당 이름에서 자동으로 파생됩니다.

--resource-group -g

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

선택적 매개 변수

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

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성	값
매개 변수 그룹:	Global Policy 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/ 참조하세요.

--subscription

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

--verbose

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

속성	값
Default value:	False

az aksarc update

프로비전된 클러스터를 업데이트합니다.

az aksarc update --name
                 --resource-group
                 [--aad-admin-group-object-ids]
                 [--acquire-policy-token]
                 [--ca-certs --custom-ca-trust-certificates]
                 [--ca-profile --cluster-autoscaler-profile]
                 [--change-reference]
                 [--control-plane-count --control-plane-node-count]
                 [--control-plane-vm-size]
                 [--disable-ahub]
                 [--disable-ai-toolchain-operator --disable-kaito]
                 [--disable-cluster-autoscaler]
                 [--disable-gateway]
                 [--disable-nfs-driver]
                 [--disable-smb-driver]
                 [--enable-ahub]
                 [--enable-ai-toolchain-operator --enable-kaito]
                 [--enable-cluster-autoscaler]
                 [--enable-nfs-driver]
                 [--enable-smb-driver]
                 [--gateway-id]
                 [--max-count]
                 [--min-count]
                 [--tags]
                 [--update-cluster-autoscaler]
                 [--yes]

예제

UpdateProvisionedCluster

az aksarc update --tags additionalProperties="sample" --name "sample-aksarccluster" --resource-group "sample-rg"

프로비전된 클러스터에 Azure 하이브리드 사용자 혜택 기능을 사용하도록 설정합니다.

az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg" --enable-ahub

프로비저닝된 클러스터에 Azure 하이브리드 사용자 혜택 기능을 사용하지 않도록 설정합니다.

az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg"--disable-ahub

컨트롤 플레인 노드를 강화합니다.

az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg" --control-plane-node-count 5

필수 매개 변수

--name -n

프로비전된 클러스터의 이름입니다.

--resource-group -g

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

선택적 매개 변수

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

--aad-admin-group-object-ids -i

프로비전된 클러스터에서 클러스터 관리자로 설정될 aad 그룹 개체 ID의 쉼표로 구분된 목록입니다.

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--ca-certs --custom-ca-trust-certificates

보안 프로필에 대한 사용자 지정 CA 트러스트 인증서가 포함된 파일의 경로입니다. 파일에는 여러 PEM 형식 인증서(최대 10개)가 포함될 수 있습니다. 각 인증서는 base64로 인코딩되고 모든 노드의 트러스트 저장소에 추가됩니다.

--ca-profile --cluster-autoscaler-profile

클러스터 자동 크기 조정기를 구성하기 위한 키=값 쌍의 공백으로 구분된 목록입니다. 빈 문자열을 전달하여 프로필을 지웁다.

--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--control-plane-count --control-plane-node-count

컨트롤 플레인의 크기를 조정할 노드 수입니다.

--control-plane-vm-size

제어 평면의 VM 크기입니다.

--disable-ahub

프로비전된 클러스터에 Azure AHUB(하이브리드 사용자 혜택)를 사용하지 않도록 설정합니다.

속성	값
Default value:	False

--disable-ai-toolchain-operator --disable-kaito

프로비전된 클러스터에 대해 AI 도구 체인 연산자를 사용하지 않도록 설정합니다.

속성	값
Default value:	False

--disable-cluster-autoscaler -d

프로비전된 클러스터에 대해 클러스터 자동 크기 조정기를 사용하지 않도록 설정합니다.

속성	값
Default value:	False

--disable-gateway

프로비전된 클러스터에 대한 게이트웨이를 사용하지 않도록 설정합니다.

속성	값
Default value:	False

--disable-nfs-driver

프로비전된 클러스터에 대해 NFS 드라이버를 사용하지 않도록 설정합니다.

속성	값
Default value:	False

--disable-smb-driver

프로비전된 클러스터에 대해 SMB 드라이버를 사용하지 않도록 설정합니다.

속성	값
Default value:	False

--enable-ahub

프로비전된 클러스터에 Azure AHUB(하이브리드 사용자 혜택)를 사용하도록 설정합니다.

속성	값
Default value:	False

--enable-ai-toolchain-operator --enable-kaito

프로비전된 클러스터에 대해 AI 도구 체인 연산자를 사용하도록 설정합니다.

속성	값
Default value:	False

--enable-cluster-autoscaler -e

프로비전된 클러스터에 대해 클러스터 자동 크기 조정기를 사용하도록 설정합니다.

속성	값
Default value:	False

--enable-nfs-driver

프로비전된 클러스터에 대해 NFS 드라이버를 사용하도록 설정합니다.

속성	값
Default value:	False

--enable-smb-driver

프로비전된 클러스터에 대해 SMB 드라이버를 사용하도록 설정합니다.

속성	값
Default value:	False

--gateway-id

프로비전된 클러스터의 게이트웨이 Arm ID입니다.

--max-count

자동 크기 조정을 위한 최대 노드 수입니다.

--min-count

자동 크기 조정을 위한 최소 노드 수입니다.

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--update-cluster-autoscaler -u

프로비전된 클러스터에 대한 클러스터 자동 크기 조정기를 업데이트합니다.

속성	값
Default value:	False

--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/ 참조하세요.

--subscription

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

--verbose

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

속성	값
Default value:	False

az aksarc upgrade

프로비전된 클러스터를 업그레이드합니다.

az aksarc upgrade --name
                  --resource-group
                  [--acquire-policy-token]
                  [--change-reference]
                  [--kubernetes-version]
                  [--no-wait]
                  [--yes]

예제

UpgradeProvisionedCluster

az aksarc upgrade --name "sample-aksarccluster" --resource-group "sample-rg" --kubernetes-version "1.22.2"

필수 매개 변수

--name -n

프로비전된 클러스터의 이름입니다.

--resource-group -g

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

선택적 매개 변수

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

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성	값
매개 변수 그룹:	Global Policy Arguments

--kubernetes-version -k

프로비전된 클러스터의 kubernetes 버전입니다.

--no-wait

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

속성	값
Default value:	False

--yes

확인 프롬프트를 사용하지 않도록 설정하는 플래그입니다.

속성	값
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/ 참조하세요.

--subscription

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

--verbose

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

속성	값
Default value:	False