New-AzAksArcCluster

참조

모듈:: Az.AksArc

프로비전된 클러스터 인스턴스 만들기

구문

New-AzAksArcCluster
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   [-MinCount <Int32>]
   [-MaxCount <Int32>]
   [-MaxPod <Int32>]
   -CustomLocationName <String>
   -VnetId <String>
   [-ControlPlaneIP <String>]
   [-Location <String>]
   [-AdminGroupObjectID <String[]>]
   [-SshAuthIp <String>]
   [-ControlPlaneCount <Int32>]
   [-ControlPlaneVMSize <String>]
   [-KubernetesVersion <String>]
   [-EnableAzureHybridBenefit]
   [-EnableAzureRbac]
   [-LoadBalancerCount <Int32>]
   [-PodCidr <String>]
   [-NfCsiDriverEnabled]
   [-SmbCsiDriverEnabled]
   [-SshKeyValue <String>]
   [-EnableAutoScaling]
   [-NodeLabel <Hashtable>]
   [-NodeTaint <String[]>]
   [-AutoScalerProfileBalanceSimilarNodeGroup <String>]
   [-AutoScalerProfileExpander <String>]
   [-AutoScalerProfileMaxEmptyBulkDelete <String>]
   [-AutoScalerProfileMaxGracefulTerminationSec <String>]
   [-AutoScalerProfileMaxNodeProvisionTime <String>]
   [-AutoScalerProfileMaxTotalUnreadyPercentage <String>]
   [-AutoScalerProfileNewPodScaleUpDelay <String>]
   [-AutoScalerProfileOkTotalUnreadyCount <String>]
   [-AutoScalerProfileScaleDownDelayAfterAdd <String>]
   [-AutoScalerProfileScaleDownDelayAfterDelete <String>]
   [-AutoScalerProfileScaleDownDelayAfterFailure <String>]
   [-AutoScalerProfileScaleDownUnneededTime <String>]
   [-AutoScalerProfileScaleDownUnreadyTime <String>]
   [-AutoScalerProfileScaleDownUtilizationThreshold <String>]
   [-AutoScalerProfileScanInterval <String>]
   [-AutoScalerProfileSkipNodesWithLocalStorage <String>]
   [-AutoScalerProfileSkipNodesWithSystemPod <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzAksArcCluster
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -MinCount <Int32>
   -MaxCount <Int32>
   -MaxPod <Int32>
   -CustomLocationName <String>
   -VnetId <String>
   [-ControlPlaneIP <String>]
   [-Location <String>]
   [-AdminGroupObjectID <String[]>]
   [-EnableAzureHybridBenefit]
   [-EnableAzureRbac]
   [-EnableAutoScaling]
   [-NodeLabel <Hashtable>]
   [-NodeTaint <String[]>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzAksArcCluster
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -CustomLocationName <String>
   -VnetId <String>
   [-ControlPlaneIP <String>]
   [-Location <String>]
   [-AdminGroupObjectID <String[]>]
   [-EnableAzureHybridBenefit]
   [-EnableAzureRbac]
   [-NodeLabel <Hashtable>]
   [-NodeTaint <String[]>]
   -JsonFilePath <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzAksArcCluster
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -CustomLocationName <String>
   -VnetId <String>
   [-ControlPlaneIP <String>]
   [-Location <String>]
   [-AdminGroupObjectID <String[]>]
   [-EnableAzureHybridBenefit]
   [-EnableAzureRbac]
   [-NodeLabel <Hashtable>]
   [-NodeTaint <String[]>]
   -JsonString <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

프로비전된 클러스터 인스턴스 만들기

예제

예제 1: 컨트롤 플레인 수 확장

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -ControlPlaneCount 3

컨트롤 플레인 수를 3개 노드로 늘입니다.

예제 2: 자동 크기 조정 사용

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -EnableAutoScaling -MinCount 1 -MaxCount 5

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

예제 3: NfCsiDriver 사용

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -NfCsiDriverEnabled

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

예제 4: SmbCsiDriver 사용

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -SmbCsiDriverEnabled

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

예제 5: Azure 하이브리드 혜택 사용

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -EnableAzureHybridBenefit

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

예제 6: Azure 하이브리드 혜택 사용 안 함

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -EnableAzureHybridBenefit:$false

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

예제 7: 자동 크기 조정 사용 안 함

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -EnableAutoScaling:$false

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

예제 8: NfCsiDriver 사용 안 함

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -NfCsiDriverEnabled:$false

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

예제 9: SmbCsiDriver 사용 안 함

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -SmbCsiDriverEnabled:$false

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

예제 10: 새 aad 관리자 GUID

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -AdminGroupObjectID @("2e00cb64-66d8-4c9c-92d8-6462caf99e33", "1b28ff4f-f7c5-4aaa-aa79-ba8b775ab443")

새 aad 관리자 GUID입니다.

매개 변수

-AdminGroupObjectID

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AsJob

작업으로 명령 실행

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutoScalerProfileBalanceSimilarNodeGroup

유효한 값은 'true' 및 'false'입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutoScalerProfileExpander

지정하지 않으면 기본값은 'random'입니다. 자세한 내용은 확장기 참조하세요.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutoScalerProfileMaxEmptyBulkDelete

기본값은 10입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutoScalerProfileMaxGracefulTerminationSec

기본값은 600입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutoScalerProfileMaxNodeProvisionTime

기본값은 '15m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutoScalerProfileMaxTotalUnreadyPercentage

기본값은 45입니다. 최대값은 100이고 최소값은 0입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutoScalerProfileNewPodScaleUpDelay

kubernetes 스케줄러가 모든 Pod를 예약하기 전에 CA가 작동하지 않도록 하는 버스트/일괄 처리 확장과 같은 시나리오의 경우 특정 기간이 되기 전에 예약되지 않은 Pod를 무시하도록 CA에 지시할 수 있습니다. 기본값은 '0s'입니다. 값은 정수 다음에 단위(초의 경우 's', 분은 'm', 시간 단위는 'h' 등)여야 합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutoScalerProfileOkTotalUnreadyCount

정수여야 합니다. 기본값은 3입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutoScalerProfileScaleDownDelayAfterAdd

기본값은 '10m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutoScalerProfileScaleDownDelayAfterDelete

기본값은 검색 간격입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutoScalerProfileScaleDownDelayAfterFailure

기본값은 '3m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutoScalerProfileScaleDownUnneededTime

기본값은 '10m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutoScalerProfileScaleDownUnreadyTime

기본값은 '20m'입니다. 값은 정수 뒤에 'm'이어야 합니다. 분(m) 이외의 시간 단위는 지원되지 않습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutoScalerProfileScaleDownUtilizationThreshold

기본값은 '0.5'입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutoScalerProfileScanInterval

기본값은 '10'입니다. 값은 정수(초)여야 합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutoScalerProfileSkipNodesWithLocalStorage

기본값은 true입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutoScalerProfileSkipNodesWithSystemPod

기본값은 true입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ClusterName

가져오기가 호출되는 Kubernetes 클러스터의 이름입니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ControlPlaneCount

컨트롤 플레인 노드 수입니다. 기본값은 1이고 개수는 홀수여야 합니다.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ControlPlaneIP

Kubernetes API 서버의 IP 주소

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ControlPlaneVMSize

컨트롤 플레인 노드의 VM sku 크기

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CustomLocationName

확장된 위치의 ARM ID입니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DefaultProfile

DefaultProfile 매개 변수가 작동하지 않습니다. 다른 구독에 대해 cmdlet을 실행하는 경우 사용 가능한 경우 SubscriptionId 매개 변수를 사용합니다.

형식:	PSObject
별칭:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EnableAutoScaling

NFS CSI 드라이버를 사용하도록 설정할지 여부를 나타냅니다. 기본값은 true입니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EnableAzureHybridBenefit

Azure 하이브리드 혜택이 옵트인되는지 여부를 나타냅니다. 기본값은 false입니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EnableAzureRbac

Azure rbac를 사용할 수 있는지 여부를 나타냅니다. 기본값은 false입니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-JsonFilePath

만들기 작업에 제공된 Json 파일의 경로

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-JsonString

만들기 작업에 제공된 Json 문자열

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-KubernetesVersion

프로비전된 클러스터에서 사용 중인 Kubernetes 버전입니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-LoadBalancerCount

HA 프록시 부하 분산 장치 VM 수입니다. 기본값은 0입니다.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Location

위치

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MaxCount

형식:	Int32
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MaxPod

형식:	Int32
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MinCount

형식:	Int32
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NfCsiDriverEnabled

NFS CSI 드라이버를 사용하도록 설정할지 여부를 나타냅니다. 기본값은 true입니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NodeLabel

에이전트 풀의 모든 노드에서 유지할 노드 레이블입니다.

형식:	Hashtable
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NodeTaint

노드 풀 만들기 및 크기 조정 중에 새 노드에 추가된 Taints입니다. 예를 들어 key=value:NoSchedule입니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NoWait

명령을 비동기적으로 실행

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PodCidr

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

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ResourceGroupName

리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SmbCsiDriverEnabled

SMB CSI 드라이버를 사용할지 여부를 나타냅니다. 기본값은 true입니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SshAuthIp

프로비전된 클러스터의 VM에 대한 SSH 액세스를 위한 IP 주소 또는 CIDR

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SshKeyValue

VM으로 인증하는 데 사용되는 SSH 공개 키 목록입니다. 최대 1키를 지정할 수 있습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SubscriptionId

대상 구독의 ID입니다.

형식:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-VnetId

인프라 네트워크 개체에 대한 ARM 리소스 ID(최대 1) 목록(예: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName}

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

출력

IProvisionedCluster

다음을 통해 공유

New-AzAksArcCluster

구문

Description

예제

예제 1: 컨트롤 플레인 수 확장

예제 2: 자동 크기 조정 사용

예제 3: NfCsiDriver 사용

예제 4: SmbCsiDriver 사용

예제 5: Azure 하이브리드 혜택 사용

예제 6: Azure 하이브리드 혜택 사용 안 함

예제 7: 자동 크기 조정 사용 안 함

예제 8: NfCsiDriver 사용 안 함

예제 9: SmbCsiDriver 사용 안 함

예제 10: 새 aad 관리자 GUID

매개 변수

-AdminGroupObjectID

-AsJob

-AutoScalerProfileBalanceSimilarNodeGroup

-AutoScalerProfileExpander

-AutoScalerProfileMaxEmptyBulkDelete

-AutoScalerProfileMaxGracefulTerminationSec

-AutoScalerProfileMaxNodeProvisionTime

-AutoScalerProfileMaxTotalUnreadyPercentage

-AutoScalerProfileNewPodScaleUpDelay

-AutoScalerProfileOkTotalUnreadyCount

-AutoScalerProfileScaleDownDelayAfterAdd

-AutoScalerProfileScaleDownDelayAfterDelete

-AutoScalerProfileScaleDownDelayAfterFailure

-AutoScalerProfileScaleDownUnneededTime

-AutoScalerProfileScaleDownUnreadyTime

-AutoScalerProfileScaleDownUtilizationThreshold

-AutoScalerProfileScanInterval

-AutoScalerProfileSkipNodesWithLocalStorage

-AutoScalerProfileSkipNodesWithSystemPod

-ClusterName

-Confirm

-ControlPlaneCount

-ControlPlaneIP

-ControlPlaneVMSize

-CustomLocationName

-DefaultProfile

-EnableAutoScaling

-EnableAzureHybridBenefit

-EnableAzureRbac

-JsonFilePath

-JsonString

-KubernetesVersion

-LoadBalancerCount

-Location

-MaxCount

-MaxPod

-MinCount

-NfCsiDriverEnabled

-NodeLabel

-NodeTaint

-NoWait

-PodCidr

-ResourceGroupName

-SmbCsiDriverEnabled

-SshAuthIp

-SshKeyValue

-SubscriptionId

-VnetId

-WhatIf

출력

추가 리소스