New-AzNetworkCloudAgentPool

참조

모듈:: Az.NetworkCloud

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

구문

New-AzNetworkCloudAgentPool
   -KubernetesClusterName <String>
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Count <Int64>
   -Location <String>
   -Mode <AgentPoolMode>
   -VMSkuName <String>
   [-AdministratorConfigurationAdminUsername <String>]
   [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
   [-AgentOptionHugepagesCount <Int64>]
   [-AgentOptionHugepagesSize <HugepagesSize>]
   [-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
   [-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
   [-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
   [-AvailabilityZone <String[]>]
   [-ExtendedLocationName <String>]
   [-ExtendedLocationType <String>]
   [-Label <IKubernetesLabel[]>]
   [-Tag <Hashtable>]
   [-Taint <IKubernetesLabel[]>]
   [-UpgradeSettingDrainTimeout <Int64>]
   [-UpgradeSettingMaxSurge <String>]
   [-UpgradeSettingMaxUnavailable <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

예제

예제 1: Kubernetes 클러스터의 에이전트 풀 만들기

$networkAttachment = @{
        AttachedNetworkId = "l3NetworkId"
    }
    $labels = @{
        Key = "key"
        Value = "value"
    }
    $taints = @{
        Key = "key"
        Value = "value"
    }
    $sshPublicKey = @{
        KeyData = "ssh-rsa aaaKyfsdx= fakekey@vm"
    }

    New-AzNetworkCloudAgentPool -KubernetesClusterName clusterName -Name agentPoolName -ResourceGroupName resourceGroup -Count count -Location location -Mode agentPoolMode -VMSkuName vmSkuName -SubscriptionId subscriptionId -AdministratorConfigurationAdminUsername adminUsername -AdministratorConfigurationSshPublicKey $sshPublicKey -AgentOptionHugepagesCount hugepagesCount -AgentOptionHugepagesSize hugepagesSize -AttachedNetworkConfigurationL3Network $networkAttachment -AvailabilityZone availabilityZones -ExtendedLocationName clusterExtendedLocation -ExtendedLocationType "CustomLocation " -Tag @{tags = "tag"} -Label $labels -Taint $taints -UpgradeSettingMaxSurge maxSurge

Location  Name           SystemDataCreatedAt SystemDataCreatedBy    SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy
--------       ----                -------------------              -------------------                   -----------------------                    ------------------------                ------------
westus3  agentpool1 07/18/2023 17:44:02 <identity>                            User                                            07/18/2023 17:46:45         <identity>

이 명령은 지정된 Kubernetes 클러스터에 대한 에이전트 풀을 만듭니다.

매개 변수

-AdministratorConfigurationAdminUsername

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

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

-AdministratorConfigurationSshPublicKey

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

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

-AgentOptionHugepagesCount

할당할 거대한 페이지 수입니다.

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

-AgentOptionHugepagesSize

할당할 거대한 페이지의 크기입니다.

형식:	HugepagesSize
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

-AvailabilityZone

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

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

-Confirm

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

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

-Count

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

형식:	Int64
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
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ExtendedLocationType

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

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

-KubernetesClusterName

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

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

-Label

이 에이전트 풀의 노드에 적용된 레이블입니다. 생성하려면 LABEL 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-Location

리소스가 있는 지리적 위치

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

-Mode

이 에이전트 풀을 시스템 풀 또는 사용자 풀로 사용하는 방법의 선택입니다. 시스템 풀은 Kubernetes 클러스터에 대한 기능 및 중요한 서비스를 실행하고 사용자 풀은 사용자 워크로드 전용입니다. 모든 Kubernetes 클러스터에는 하나 이상의 노드가 있는 하나 이상의 시스템 노드 풀이 포함되어야 합니다.

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

-Name

Kubernetes 클러스터 에이전트 풀의 이름입니다.

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

-NoWait

명령을 비동기적으로 실행

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

-ResourceGroupName

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

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	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

-Taint

이 에이전트 풀의 노드에 적용되는 taint입니다. 생성하려면 TAINT 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-UpgradeSettingDrainTimeout

에이전트 풀 업그레이드를 진행하기 전에 노드 드레이닝이 완료될 수 있는 최대 시간(초)입니다. 만드는 동안 지정하지 않으면 1800초 값이 사용됩니다.

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

-UpgradeSettingMaxSurge

업그레이드 중에 급증한 노드의 최대 수 또는 백분율입니다. 정수(예: '5') 또는 백분율(예: '50%')으로 설정할 수 있습니다. 백분율을 지정하면 업그레이드 시 총 에이전트 풀 크기의 백분율입니다. 백분율의 경우 소수 노드가 반올림됩니다. 만드는 동안 지정하지 않으면 값 1이 사용됩니다. MaxSurge 및 MaxUnavailable 중 하나는 0보다 커야 합니다.

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

-UpgradeSettingMaxUnavailable

업그레이드하는 동안 사용할 수 없는 노드의 최대 수 또는 백분율입니다. 정수(예: '5') 또는 백분율(예: '50%')으로 설정할 수 있습니다. 백분율을 지정하면 업그레이드 시 총 에이전트 풀 크기의 백분율입니다. 백분율의 경우 소수 노드가 반올림됩니다. 만드는 동안 지정하지 않으면 값 0이 사용됩니다. MaxSurge 및 MaxUnavailable 중 하나는 0보다 커야 합니다.

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

-VMSkuName

노드 VM에 할당된 리소스의 크기를 결정하는 VM SKU의 이름입니다.

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

-WhatIf

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

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

출력

IAgentPool

다음을 통해 공유