다음을 통해 공유


Update-AzNetworkCloudAgentPool

제공된 Kubernetes 클러스터 에이전트 풀의 속성을 패치하거나 Kubernetes 클러스터 에이전트 풀과 연결된 태그를 업데이트합니다. 속성 및 태그 업데이트는 독립적으로 수행할 수 있습니다.

구문

Update-AzNetworkCloudAgentPool
      -KubernetesClusterName <String>
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
      [-Count <Int64>]
      [-Tag <Hashtable>]
      [-UpgradeSettingDrainTimeout <Int64>]
      [-UpgradeSettingMaxSurge <String>]
      [-UpgradeSettingMaxUnavailable <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzNetworkCloudAgentPool
      -InputObject <INetworkCloudIdentity>
      [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
      [-Count <Int64>]
      [-Tag <Hashtable>]
      [-UpgradeSettingDrainTimeout <Int64>]
      [-UpgradeSettingMaxSurge <String>]
      [-UpgradeSettingMaxUnavailable <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

제공된 Kubernetes 클러스터 에이전트 풀의 속성을 패치하거나 Kubernetes 클러스터 에이전트 풀과 연결된 태그를 업데이트합니다. 속성 및 태그 업데이트는 독립적으로 수행할 수 있습니다.

예제

예제 1: Kubernetes 클러스터의 에이전트 풀 업데이트

Update-AzNetworkCloudAgentPool -Name agentPoolName -KubernetesClusterName clusterName -ResourceGroupName resourceGroup -Count updatedCount -Tag @{tags = "newTag"} -UpgradeSettingMaxSurge updatedMaxSurge

Location Name           SystemDataCreatedAt SystemDataCreatedBy    SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy
--------      ----                -------------------               -------------------                  -----------------------                   ------------------------                  --
westus3  agentpool1 07/17/2023 18:14:59 <identity>                           Application                              07/18/2023 17:06:24           <identity>

이 명령은 Kubernetes 클러스터 에이전트 풀의 속성을 업데이트합니다.

매개 변수

-AdministratorConfigurationSshPublicKey

SshPublicKey는 SSH를 통해 리소스로 인증하는 데 사용되는 공개 키를 나타냅니다. 생성하려면 ADMINISTRATORCONFIGURATIONSSHPUBLICKEY 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-AsJob

작업으로 명령 실행

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

-DefaultProfile

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

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

-InputObject

생성할 ID 매개 변수는 INPUTOBJECT 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-KubernetesClusterName

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

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

기존 리소스 태그를 대체할 Azure 리소스 태그입니다.

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

-WhatIf

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

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

입력

출력