New-AzAksNodePool

參考

模組:: Az.Aks

在指定的叢集中建立新的節點集區。

語法

New-AzAksNodePool
   -ResourceGroupName <String>
   -ClusterName <String>
   -Name <String>
   [-Count <Int32>]
   [-OsDiskSize <Int32>]
   [-VmSize <String>]
   [-VnetSubnetID <String>]
   [-MaxPodCount <Int32>]
   [-OsType <String>]
   [-OsSKU <String>]
   [-EnableNodePublicIp]
   [-NodePublicIPPrefixID <String>]
   [-ScaleSetPriority <String>]
   [-ScaleSetEvictionPolicy <String>]
   [-VmSetType <String>]
   [-AvailabilityZone <String[]>]
   [-Force]
   [-EnableEncryptionAtHost]
   [-EnableUltraSSD]
   [-LinuxOSConfig <LinuxOSConfig>]
   [-KubeletConfig <KubeletConfig>]
   [-MaxSurge <String>]
   [-PPG <String>]
   [-SpotMaxPrice <Double>]
   [-EnableFIPS]
   [-GpuInstanceProfile <String>]
   [-HostGroupID <String>]
   [-PodSubnetID <String>]
   [-KubernetesVersion <String>]
   [-MinCount <Int32>]
   [-MaxCount <Int32>]
   [-EnableAutoScaling]
   [-Mode <String>]
   [-NodeLabel <Hashtable>]
   [-Tag <Hashtable>]
   [-NodeTaint <String[]>]
   [-AksCustomHeader <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [-SubscriptionId <String>]
   [<CommonParameters>]

New-AzAksNodePool
   -Name <String>
   -ClusterObject <PSKubernetesCluster>
   [-Count <Int32>]
   [-OsDiskSize <Int32>]
   [-VmSize <String>]
   [-VnetSubnetID <String>]
   [-MaxPodCount <Int32>]
   [-OsType <String>]
   [-OsSKU <String>]
   [-EnableNodePublicIp]
   [-NodePublicIPPrefixID <String>]
   [-ScaleSetPriority <String>]
   [-ScaleSetEvictionPolicy <String>]
   [-VmSetType <String>]
   [-AvailabilityZone <String[]>]
   [-Force]
   [-EnableEncryptionAtHost]
   [-EnableUltraSSD]
   [-LinuxOSConfig <LinuxOSConfig>]
   [-KubeletConfig <KubeletConfig>]
   [-MaxSurge <String>]
   [-PPG <String>]
   [-SpotMaxPrice <Double>]
   [-EnableFIPS]
   [-GpuInstanceProfile <String>]
   [-HostGroupID <String>]
   [-PodSubnetID <String>]
   [-KubernetesVersion <String>]
   [-MinCount <Int32>]
   [-MaxCount <Int32>]
   [-EnableAutoScaling]
   [-Mode <String>]
   [-NodeLabel <Hashtable>]
   [-Tag <Hashtable>]
   [-NodeTaint <String[]>]
   [-AksCustomHeader <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [-SubscriptionId <String>]
   [<CommonParameters>]

Description

在指定的叢集中建立新的節點集區。

範例

範例 1：使用預設參數建立節點集區

New-AzAksNodePool -ResourceGroupName myResouceGroup -ClusterName myCluster -Name mydefault

範例 2：在 AKS 上建立 Windows Server 容器

$cred = ConvertTo-SecureString -String "****" -AsPlainText -Force
New-AzAksCluster -ResourceGroupName myResourceGroup -Name myCluster -WindowsProfileAdminUserName azureuser -WindowsProfileAdminUserPassword $cred -NetworkPlugin azure -NodeVmSetType VirtualMachineScaleSets
New-AzAksNodePool -ResourceGroupName myResourceGroup -ClusterName myCluster -Name win1 -OsType Windows -VmSetType VirtualMachineScaleSets

範例 3：使用 LinuxOSConfig 和 KubeletConfig 建立節點集區。

當您建立 AKS 節點集區時，您可以指定 kubelet 和 OS 組態。 LinuxOSConfig 和 KubeletConfig 的類型必須分別 Microsoft.Azure.Management.ContainerService.Models.LinuxOSConfig 和 Microsoft.Azure.Management.ContainerService.Models.KubeletConfig。

$linuxOsConfigJsonStr = @'
            {
             "transparentHugePageEnabled": "madvise",
             "transparentHugePageDefrag": "defer+madvise",
             "swapFileSizeMB": 1500,
             "sysctls": {
              "netCoreSomaxconn": 163849,
              "netIpv4TcpTwReuse": true,
              "netIpv4IpLocalPortRange": "32000 60000"
             }
            }
'@
$linuxOsConfig = [Microsoft.Azure.Management.ContainerService.Models.LinuxOSConfig] ($linuxOsConfigJsonStr | ConvertFrom-Json)
$kubeletConfigStr = @'
            {
             "failSwapOn": false
            }
'@
$kubeletConfig = [Microsoft.Azure.Management.ContainerService.Models.KubeletConfig] ($kubeletConfigStr | ConvertFrom-Json)

New-AzAksNodePool -ResourceGroupName myResourceGroup -ClusterName myAKSCluster -Name mypool -LinuxOSConfig $linuxOsConfig -KubeletConfig $kubeletConfig

參數

-AksCustomHeader

Aks 自定義標頭

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

-AvailabilityZone

節點的可用性區域。必須使用 VirtualMachineScaleSets AgentPoolType。

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

-ClusterName

受控叢集資源的名稱。

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

-ClusterObject

指定要在其中建立節點集區的叢集物件。

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

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

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

-Count

節點集區的預設節點數目。

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

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

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

-EnableAutoScaling

是否要啟用自動調整程式

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

-EnableEncryptionAtHost

是否要啟用主機型 OS 和數據磁碟驅動器

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

-EnableFIPS

是否要使用已啟用 FIPS 的 OS

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

-EnableNodePublicIp

是否要啟用節點的公用IP。

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

-EnableUltraSSD

是否要啟用 UltraSSD

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

-Force

即使節點集區已經存在，仍建立節點集區

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

-GpuInstanceProfile

要用來為支援的 GPU VM SKU 指定 GPU MIG 實例設定檔的 GpuInstanceProfile。

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

-HostGroupID

專用主機群組用來布建虛擬機的完整資源標識符，僅用於建立案例，且一旦設定后就不允許變更。

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

-KubeletConfig

代理程式集區節點上的 Kubelet 組態。

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

-KubernetesVersion

用來建立叢集的 Kubernetes 版本。

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

-LinuxOSConfig

Linux 代理程序節點的 OS 組態。

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

-MaxCount

自動調整的節點數目上限

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

-MaxPodCount

可在節點上執行的 Pod 數目上限。

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

-MaxSurge

升級期間激增的節點數目或百分比上限。

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

-MinCount

自動調整的節點數目下限。

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

-Mode

集區模式

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

-Name

節點集區的名稱。

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

-NodeLabel

用於建置 Kubernetes 網路的節點集區標籤。

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

-NodePublicIPPrefixID

節點集區公用IP前置詞的資源標識碼。

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

-NodeTaint

在節點集區建立和調整期間新增至新節點的節點污點

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

-OsDiskSize

節點集區的預設節點數目。

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

-OsSKU

要用來指定 OS SKU 的 OsSKU。如果OSType為Linux，則預設值為Ubuntu。當 Kubernetes <= 1.24 或 Windows2022 時，當 Kubernetes >= 1.25 如果 OSType 為 Windows，則預設值為 Windows2019。

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

-OsType

要用來指定os類型的OsType。從 Linux 和 Windows 中選擇。預設為Linux。

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

-PodSubnetID

啟動時，Pod 會加入之子網的標識碼。

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

-PPG

鄰近放置群組的標識碼。

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

-ResourceGroupName

資源群組的名稱。

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

-ScaleSetEvictionPolicy

ScaleSetEvictionPolicy 可用來指定低優先順序虛擬機擴展集的收回原則。預設值為 Delete。

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

-ScaleSetPriority

用來指定虛擬機擴展集優先順序的 ScaleSetPriority。預設為一般。

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

-SpotMaxPrice

您願意為現成實例支付的最高價格（以美元為單位）。可能的值為大於零或 -1 的任何十進位值，表示依需求 up-to 默認價格。

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

-SubscriptionId

訂用帳戶的標識碼。根據預設，Cmdlet 會在目前內容中設定的訂用帳戶中執行。如果使用者指定另一個訂用帳戶，則會在使用者指定的訂用帳戶中執行目前的 Cmdlet。覆寫訂閱只會在目前 Cmdlet 的生命週期內生效。它不會變更內容中的訂用帳戶，而且不會影響後續的 Cmdlet。

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

-Tag

要保存在代理程式集區虛擬機擴展集上的標記。

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

-VmSetType

表示節點集區的型別。可能的值包括：'VirtualMachineScaleSets'、'AvailabilitySet'

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

-VmSize

虛擬機的大小。預設值為 Standard_D2_v2。

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

-VnetSubnetID

VNet SubnetID 會指定 VNet 的子網標識碼。

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

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

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

輸入

PSKubernetesCluster

輸出

PSNodePool

共用方式為