New-AzNetworkCloudKubernetesCluster

참조

모듈:: Az.NetworkCloud

새 Kubernetes 클러스터를 만들거나 기존 클러스터의 속성을 업데이트합니다.

구문

New-AzNetworkCloudKubernetesCluster
   -KubernetesClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -ControlPlaneNodeConfigurationCount <Int64>
   -ControlPlaneNodeConfigurationVMSkuName <String>
   -ExtendedLocationName <String>
   -ExtendedLocationType <String>
   -InitialAgentPoolConfiguration <IInitialAgentPoolConfiguration[]>
   -KubernetesVersion <String>
   -Location <String>
   -NetworkConfigurationCloudServicesNetworkId <String>
   -NetworkConfigurationCniNetworkId <String>
   [-AadConfigurationAdminGroupObjectId <String[]>]
   [-AdminUsername <String>]
   [-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
   [-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
   [-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
   [-BgpAdvertisement <IBgpAdvertisement[]>]
   [-BgpIPAddressPool <IIPAddressPool[]>]
   [-BgpPeer <IServiceLoadBalancerBgpPeer[]>]
   [-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled <FabricPeeringEnabled>]
   [-ControlPlaneNodeConfigurationAdminPublicKey <ISshPublicKey[]>]
   [-ControlPlaneNodeConfigurationAdminUsername <String>]
   [-ControlPlaneNodeConfigurationAvailabilityZone <String[]>]
   [-L2ServiceLoadBalancerConfigurationIPAddressPool <IIPAddressPool[]>]
   [-ManagedResourceGroupConfigurationLocation <String>]
   [-ManagedResourceGroupConfigurationName <String>]
   [-NetworkConfigurationDnsServiceIP <String>]
   [-NetworkConfigurationPodCidr <String[]>]
   [-NetworkConfigurationServiceCidr <String[]>]
   [-SshPublicKey <ISshPublicKey[]>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

새 Kubernetes 클러스터를 만들거나 기존 클러스터의 속성을 업데이트합니다.

예제

예제 1: Kubernetes 클러스터 만들기

$tagHash = @{tags = "tag1" }
$agentPoolConfiguration = @{
    count = 1
    mode = "System"
    name = "agentPoolName"
    vmSkuName = "vmSkuName"
    administratorConfiguration = "administratorConfiguration"
}
$sshPublicKey = @{
    KeyData = "ssh-rsa aaaKyfsdx= fakekey@vm"
}
New-AzNetworkCloudKubernetesCluster -ResourceGroupName resourceGroupName `
                -KubernetesClusterName default -Location location `
                -ExtendedLocationName extendedLocationName `
                -ExtendedLocationType "CustomLocation" `
                -KubernetesVersion kubernetesVersion `
                -AadConfigurationAdminGroupObjectId adminGroupObjectIds `
                -AdminUsername "azureuser" `
                -SshPublicKey $sshPublicKey `
                -InitialAgentPoolConfiguration $agentPoolConfiguration `
                -NetworkConfigurationCloudServicesNetworkId cloudServicesNetworkId `
                -NetworkConfigurationCniNetworkId cniNetworkId `
                -SubscriptionId subscriptionId `
                -Tag $tagHash

Location Name    SystemDataCreatedAt SystemDataCreatedBy    SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy             SystemDataLastModifiedByType ResourceGroupName
-------- ----    ------------------- -------------------    ----------------------- ------------------------ ------------------------             ---------------------------- -----------------
eastus   default 08/09/2023 20:23:17 <identity>             User                    08/09/2023 20:44:27      <identity>                            Application                 resourceGroupName

이 명령은 Kubernetes 클러스터를 만듭니다.

매개 변수

-AadConfigurationAdminGroupObjectId

Kubernetes 클러스터에서 관리 역할을 맡게 될 Azure Active Directory 그룹 개체 ID 목록입니다.

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

-AdminUsername

Kubernetes 노드를 실행하는 운영 체제에 적용할 관리자의 사용자 이름입니다. 제공되지 않으면 서비스에서 사용자 이름을 선택합니다.

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

-AsJob

작업으로 명령 실행

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

-AttachedNetworkConfigurationL2Network

계층 2 네트워크 목록 및 첨부 파일에 대한 관련 구성입니다. 생성하려면 ATTACHEDNETWORKCONFIGURATIONL2NETWORK 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-AttachedNetworkConfigurationL3Network

계층 3 네트워크 목록 및 첨부 파일에 대한 관련 구성입니다. 생성하려면 ATTACHEDNETWORKCONFIGURATIONL3NETWORK 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-AttachedNetworkConfigurationTrunkedNetwork

트렁크 네트워크 목록 및 첨부 파일에 대한 관련 구성입니다. 생성하려면 ATTACHEDNETWORKCONFIGURATIONTRUNKEDNETWORK 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-BgpAdvertisement

IP 주소 풀을 커뮤니티 및 피어에 연결하여 IP를 공지할 수 있습니다. 생성하려면 BGPADVERTISEMENT 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-BgpIPAddressPool

부하 분산 장치 서비스에 할당할 수 있는 IP 주소 풀 목록입니다. 생성하려면 BGPIPADDRESSPOOL 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-BgpPeer

Kubernetes 클러스터가 피어로 연결할 추가 BgpPeer 엔터티 목록입니다. 모든 피어링을 명시적으로 정의해야 합니다. 생성하려면 BGPPEER 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled

부하 분산 장치가 네트워크 패브릭과 피어링되는지 여부를 지정하는 표시기입니다.

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

-Confirm

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

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

-ControlPlaneNodeConfigurationAdminPublicKey

Kubernetes 클러스터에서 노드를 실행하는 운영 체제에 대한 SSH 구성입니다. 경우에 따라 작업 환경을 생성하기 위해 퍼블릭 키의 사양이 필요할 수 있습니다. 생성하려면 CONTROLPLANENODECONFIGURATIONADMINPUBLICKEY 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-ControlPlaneNodeConfigurationAdminUsername

Kubernetes 노드를 실행하는 운영 체제에 적용할 관리자의 사용자 이름입니다. 제공되지 않으면 서비스에서 사용자 이름을 선택합니다.

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

-ControlPlaneNodeConfigurationAvailabilityZone

제어 평면에서 노드를 프로비전하는 데 사용할 네트워크 클라우드 클러스터의 가용성 영역 목록입니다. 지정하지 않으면 모든 가용성 영역이 사용됩니다.

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

-ControlPlaneNodeConfigurationCount

이 구성을 사용하는 가상 머신의 수입니다.

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

-ControlPlaneNodeConfigurationVMSkuName

만드는 동안 제공된 VM SKU의 이름입니다.

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

-DefaultProfile

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

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

-ExtendedLocationName

리소스를 만들 확장 위치의 리소스 ID입니다.

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

-ExtendedLocationType

확장된 위치 유형(예: CustomLocation)입니다.

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

-InitialAgentPoolConfiguration

중요한 시스템 서비스 및 워크로드를 실행하기 위해 이 Kubernetes 클러스터를 사용하여 만든 에이전트 풀입니다. 이 필드의 이 데이터는 만드는 동안에만 사용되며 Kubernetes 클러스터를 만든 후에는 필드가 비어 있습니다. 에이전트 풀을 만든 후 agentPools 하위 리소스를 사용하여 관리합니다. 생성하려면 INITIALAGENTPOOLCONFIGURATION 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-KubernetesClusterName

Kubernetes 클러스터의 이름입니다.

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

-KubernetesVersion

이 클러스터의 Kubernetes 버전입니다.

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

-L2ServiceLoadBalancerConfigurationIPAddressPool

부하 분산 장치 서비스에 할당할 수 있는 IP 주소 풀 목록입니다. 생성하려면 L2SERVICELOADBALANCERCONFIGURATIONIPADDRESSPOOL 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-Location

리소스가 있는 지리적 위치

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

-ManagedResourceGroupConfigurationLocation

관리되는 리소스 그룹의 위치입니다. 지정하지 않으면 부모 리소스의 위치가 선택됩니다.

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

-ManagedResourceGroupConfigurationName

관리되는 리소스 그룹의 이름입니다. 지정하지 않으면 고유 이름이 자동으로 생성됩니다.

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

-NetworkConfigurationCloudServicesNetworkId

연결된 Cloud Services 네트워크의 리소스 ID입니다.

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

-NetworkConfigurationCniNetworkId

컨테이너 네트워킹 인터페이스 네트워크를 만드는 데 사용되는 계층 3 네트워크의 리소스 ID입니다.

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

-NetworkConfigurationDnsServiceIP

Kubernetes DNS 서비스에 할당된 IP 주소입니다. 서비스 CIDR에 지정된 Kubernetes 서비스 주소 범위 내에 있어야 합니다.

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

-NetworkConfigurationPodCidr

CIDR 표기법 IP 범위는 Pod IP를 할당할 범위입니다. 단일 스택 네트워킹에는 하나의 IPv4 CIDR이 필요합니다. 이중 스택 네트워킹에는 각 IP 패밀리(IPv4/IPv6)에 하나씩 두 개의 CIDR이 필요합니다.

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

-NetworkConfigurationServiceCidr

CIDR 표기법 IP 범위는 서비스 IP를 할당할 범위입니다. 단일 스택 네트워킹에는 하나의 IPv4 CIDR이 필요합니다. 이중 스택 네트워킹에는 각 IP 패밀리(IPv4/IPv6)에 하나씩 두 개의 CIDR이 필요합니다.

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

-NoWait

명령을 비동기적으로 실행

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

-ResourceGroupName

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

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

-SshPublicKey

Kubernetes 클러스터에서 노드를 실행하는 운영 체제에 대한 SSH 구성입니다. 경우에 따라 작업 환경을 생성하기 위해 퍼블릭 키의 사양이 필요할 수 있습니다. 생성하려면 SSHPUBLICKEY 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-SubscriptionId

대상 구독의 ID입니다. 값은 UUID여야 합니다.

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

-Tag

리소스 태그.

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

-WhatIf

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

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

출력

IKubernetesCluster

다음을 통해 공유