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[]>]
   [-UpgradeSettingMaxSurge <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
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AdministratorConfigurationSshPublicKey

執行 Kubernetes 叢集中節點之作業系統的 SSH 組態。在某些情況下，可能需要公鑰規格才能產生工作環境。若要建構，請參閱 ADMINISTRATORCONFIGURATIONSSHPUBLICKEY 屬性的 NOTES 一節，並建立哈希表。

類型:	ISshPublicKey[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AgentOptionHugepagesCount

要配置的大量頁面數目。

類型:	Int64
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AgentOptionHugepagesSize

要配置的巨量頁面大小。

類型:	HugepagesSize
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AsJob

以作業身分執行命令

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AttachedNetworkConfigurationL2Network

第 2 層網路和相關設定的附件清單。若要建構，請參閱 notes 一節以瞭解ATTACHEDNETWORKCONFIGURATIONL2NETWORK屬性並建立哈希表。

類型:	IL2NetworkAttachmentConfiguration[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AttachedNetworkConfigurationL3Network

第 3 層網路和相關設定的附件清單。若要建構，請參閱ATTACHEDNETWORKCONFIGURATIONL3NETWORK屬性和建立哈希表的 NOTES 一節。

類型:	IL3NetworkAttachmentConfiguration[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AttachedNetworkConfigurationTrunkedNetwork

主幹網路和附件的相關組態清單。若要建構，請參閱 ATTACHEDNETWORKCONFIGURATIONTRUNKEDNETWORK 屬性的 NOTES 區段，並建立哈希表。

類型:	ITrunkedNetworkAttachmentConfiguration[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AvailabilityZone

用於布建此代理程式集區中節點的網路雲端叢集可用性區域清單。如果未指定，則會使用所有可用性區域。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Count

使用此組態的虛擬機數目。

類型:	Int64
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

DefaultProfile 參數無法運作。如果針對不同的訂用帳戶執行 Cmdlet，請使用 SubscriptionId 參數。

類型:	PSObject
別名:	AzureRMContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ExtendedLocationName

要在其中建立資源之擴充位置的資源標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ExtendedLocationType

擴充位置類型，例如 CustomLocation。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-KubernetesClusterName

Kubernetes 叢集的名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Label

套用至此代理程式集區中節點的標籤。若要建構，請參閱 LABEL 屬性和建立哈希表的 NOTES 一節。

類型:	IKubernetesLabel[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Location

資源所在的地理位置

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Mode

選取此代理程式集區的方式，無論是作為系統集區還是使用者集區。系統集區會執行 Kubernetes 叢集的功能和重要服務，而使用者集區則專用於使用者工作負載。每個 Kubernetes 叢集都必須包含至少一個具有至少一個節點的系統節點集區。

類型:	AgentPoolMode
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Name

Kubernetes 叢集代理程式集區的名稱。

類型:	String
別名:	AgentPoolName
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-NoWait

以異步方式執行命令

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

資源群組的名稱。名稱不區分大小寫。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SubscriptionId

目標訂用帳戶的標識碼。此值必須是 UUID。

類型:	String
Position:	Named
預設值:	(Get-AzContext).Subscription.Id
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Tag

資源標籤。

類型:	Hashtable
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Taint

套用至此代理程式集區中節點的污點。若要建構，請參閱 TAINT 屬性的 NOTES 區段並建立哈希表。

類型:	IKubernetesLabel[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UpgradeSettingMaxSurge

升級期間激增的節點數目或百分比上限。這可以設定為整數（例如 '5'）或百分比（例如 '50%'）。如果指定了百分比，則它是升級時代理程式集區大小總計的百分比。針對百分比，小數節點會四捨五入。若未加以指定，預設為 1。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VMSkuName

決定為節點 VM 配置之資源大小的 VM SKU 名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸出

IAgentPool

共用方式為