New-AzAksNodePool

Syntax

defaultParameterSet

New-AzAksNodePool
    -ResourceGroupName <String>
    -ClusterName <String>
    -Name <String>
    [-Count <Int32>]
    [-OsDiskSize <Int32>]
    [-OSDiskType <String>]
    [-VmSize <String>]
    [-VnetSubnetID <String>]
    [-WorkloadRuntime <String>]
    [-MaxPodCount <Int32>]
    [-MessageOfTheDay <String>]
    [-OsType <String>]
    [-PodIPAllocationMode <String>]
    [-OsSKU <String>]
    [-EnableNodePublicIp]
    [-NodePublicIPPrefixID <String>]
    [-ScaleSetPriority <String>]
    [-ScaleSetEvictionPolicy <String>]
    [-VmSetType <String>]
    [-AvailabilityZone <String[]>]
    [-Force]
    [-EnableEncryptionAtHost]
    [-EnableUltraSSD]
    [-GatewayPublicIPPrefixSize <Int32>]
    [-GPUDriver <String>]
    [-LinuxOSConfig <LinuxOSConfig>]
    [-KubeletConfig <KubeletConfig>]
    [-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>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-NetworkProfile <AgentPoolNetworkProfile>]
    [-ScaleDownMode <String>]
    [-EnableSecureBoot]
    [-EnableVtpm]
    [-SshAccess <String>]
    [-MaxSurge <String>]
    [-MaxUnavailable <String>]
    [-DrainTimeoutInMinute <Int32>]
    [-NodeSoakDurationInMinute <Int32>]
    [-UndrainableNodeBehavior <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-SubscriptionId <String>]
    [<CommonParameters>]

ParentObjectParameterSet

New-AzAksNodePool
    -Name <String>
    -ClusterObject <PSKubernetesCluster>
    [-Count <Int32>]
    [-OsDiskSize <Int32>]
    [-OSDiskType <String>]
    [-VmSize <String>]
    [-VnetSubnetID <String>]
    [-WorkloadRuntime <String>]
    [-MaxPodCount <Int32>]
    [-MessageOfTheDay <String>]
    [-OsType <String>]
    [-PodIPAllocationMode <String>]
    [-OsSKU <String>]
    [-EnableNodePublicIp]
    [-NodePublicIPPrefixID <String>]
    [-ScaleSetPriority <String>]
    [-ScaleSetEvictionPolicy <String>]
    [-VmSetType <String>]
    [-AvailabilityZone <String[]>]
    [-Force]
    [-EnableEncryptionAtHost]
    [-EnableUltraSSD]
    [-GatewayPublicIPPrefixSize <Int32>]
    [-GPUDriver <String>]
    [-LinuxOSConfig <LinuxOSConfig>]
    [-KubeletConfig <KubeletConfig>]
    [-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>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-NetworkProfile <AgentPoolNetworkProfile>]
    [-ScaleDownMode <String>]
    [-EnableSecureBoot]
    [-EnableVtpm]
    [-SshAccess <String>]
    [-MaxSurge <String>]
    [-MaxUnavailable <String>]
    [-DrainTimeoutInMinute <Int32>]
    [-NodeSoakDurationInMinute <Int32>]
    [-UndrainableNodeBehavior <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-SubscriptionId <String>]
    [<CommonParameters>]

Description

Exempel

Exempel 1: Skapa en nodpool med standardparametrar

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

Exempel 2: Skapa Windows Server container på en AKS

$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

Exempel 3: Skapa en nodpool med LinuxOSConfig och 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

Parametrar

-AksCustomHeader

Anpassade Aks-rubriker

Parameteregenskaper

Parameteruppsättningar

-AvailabilityZone

Tillgänglighetszoner för noder. Måste använda VirtualMachineScaleSets AgentPoolType.

Parameteregenskaper

Parameteruppsättningar

-ClusterName

Namnet på den hanterade klusterresursen.

Parameteregenskaper

Parameteruppsättningar

-ClusterObject

Ange klusterobjekt där nodpoolen ska skapas.

Parameteregenskaper

Parameteruppsättningar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Parameteruppsättningar

-Count

Standardantalet noder för nodpoolerna.

Parameteregenskaper

Parameteruppsättningar

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Parameteregenskaper

Parameteruppsättningar

-DrainTimeoutInMinute

Tidsgränsen för tömning för en nod. Hur lång tid (i minuter) som ska vänta vid borttagning av poddar och graciös avslutning per nod. Den här avhysningsväntetiden hedrar väntan på poddavbrottsbudgetar. Om den här tiden överskrids misslyckas uppgraderingen. Om det inte anges är standardvärdet 30 minuter.

Parameteregenskaper

Parameteruppsättningar

-EnableAutoScaling

Om du vill aktivera automatisk skalning

Parameteregenskaper

Parameteruppsättningar

-EnableEncryptionAtHost

Om värdbaserat operativsystem och dataenhet ska aktiveras

Parameteregenskaper

Parameteruppsättningar

-EnableFIPS

Om du vill använda ett FIPS-aktiverat operativsystem

Parameteregenskaper

Parameteruppsättningar

-EnableNodePublicIp

Om du vill aktivera offentlig IP-adress för noder.

Parameteregenskaper

Parameteruppsättningar

-EnableSecureBoot

Den säkra starten är en funktion i Trusted Launch som säkerställer att endast signerade operativsystem och drivrutiner kan starta. Mer information finns i aka.ms/aks/trustedlaunch. Om det inte anges är standardvärdet falskt.

Parameteregenskaper

Parameteruppsättningar

-EnableUltraSSD

om du vill aktivera UltraSSD

Parameteregenskaper

Parameteruppsättningar

-EnableVtpm

vTPM är en betrodd startfunktion för att konfigurera ett dedikerat säkert valv för nycklar och mått som lagras lokalt på noden. Mer information finns i aka.ms/aks/trustedlaunch. Om det inte anges är standardvärdet falskt.

Parameteregenskaper

Parameteruppsättningar

-Force

Skapa nodpool även om den redan finns

Parameteregenskaper

Parameteruppsättningar

-GatewayPublicIPPrefixSize

Gateway-agentpoolen associerar en offentlig IPPrefix för varje statisk utgående gateway för att tillhandahålla offentlig utgående trafik. Storleken på offentlig IPPrefix ska väljas av användaren. Varje nod i agentpoolen tilldelas en IP-adress från IPPrefix. IPPrefix-storleken fungerar därmed som ett tak för storleken på gatewayagentpoolen. På grund av Azure offentlig STORLEKsbegränsning för IPPrefix är det giltiga värdeintervallet [28, 31] (/31 = 2 noder/IP-adresser, /30 = 4 noder/IP-adresser, /29 = 8 noder/IP-adresser, /28 = 16 noder/IP-adresser). Standardvärdet är 31.

Parameteregenskaper

Parameteruppsättningar

-GPUDriver

Om du vill installera GPU-drivrutiner. När den inte har angetts är standardinställningen Installera.

Parameteregenskaper

Parameteruppsättningar

-GpuInstanceProfile

GpuInstanceProfile som ska användas för att ange GPU MIG-instansprofil för GPU VM SKU som stöds.

Parameteregenskaper

Parameteruppsättningar

-HostGroupID

Det fullt kvalificerade resurs-ID:t för Dedicated Host Group för att provisionera virtual machines från, används endast i skapandescenario och får inte ändras när det väl är satt.

Parameteregenskaper

Parameteruppsättningar

-IfMatch

Begäran bör endast fortsätta om en entitet matchar den här strängen.

Parameteregenskaper

Parameteruppsättningar

-IfNoneMatch

Begäran bör endast fortsätta om ingen entitet matchar den här strängen.

Parameteregenskaper

Parameteruppsättningar

-KubeletConfig

Kubelet-konfigurationen på agentpoolnoderna.

Parameteregenskaper

Parameteruppsättningar

-KubernetesVersion

Den version av Kubernetes som ska användas för att skapa klustret.

Parameteregenskaper

Parameteruppsättningar

-LinuxOSConfig

Operativsystemets konfiguration av Linux-agentnoder.

Parameteregenskaper

Parameteruppsättningar

-MaxCount

Maximalt antal noder för automatisk skalning

Parameteregenskaper

Parameteruppsättningar

-MaxPodCount

Maximalt antal poddar som kan köras på noden.

Parameteregenskaper

Parameteruppsättningar

-MaxSurge

Det maximala antalet eller procentandelen noder som ar ökade kraftigt under uppgraderingen.

Parameteregenskaper

Parameteruppsättningar

-MaxUnavailable

Det maximala antalet eller procentandelen noder som kan vara samtidigt otillgängliga under uppgraderingen. Detta kan antingen anges till ett heltal (t.ex. "1") eller en procentandel (t.ex. "5%"). Om en procentandel anges är det procentandelen av den totala agentpoolens storlek vid tidpunkten för uppgraderingen. För procentandelar avrundas bråknoder uppåt. Om det inte anges är standardvärdet 0. Mer information, inklusive metodtips, finns i: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster

Parameteregenskaper

Parameteruppsättningar

-MessageOfTheDay

Dagens meddelande för Linux-noder, base64-kodade. En base64-kodad sträng som skrivs till /etc/motd efter avkodning. Detta möjliggör anpassning av dagens meddelande för Linux-noder. Den får inte anges för Windows noder. Det måste vara en statisk sträng (d.v.s. skrivs ut rå och körs inte som ett skript).

Parameteregenskaper

Parameteruppsättningar

-MinCount

Minsta antal noder för automatisk skalning.

Parameteregenskaper

Parameteruppsättningar

-Mode

Poolläget

Parameteregenskaper

Parameteruppsättningar

-Name

Namnet på nodpoolen.

Parameteregenskaper

Parameteruppsättningar

-NetworkProfile

Nätverksrelaterade inställningar för en agentpool.

Parameteregenskaper

Parameteruppsättningar

-NodeLabel

Nodpoolsetiketter som används för att skapa Kubernetes-nätverk.

Parameteregenskaper

Parameteruppsättningar

-NodePublicIPPrefixID

Resurs-ID:t för det offentliga IP-prefixet för nodpoolen.

Parameteregenskaper

Parameteruppsättningar

-NodeSoakDurationInMinute

Den blöta varaktigheten för en nod. Hur lång tid (i minuter) som ska vänta efter tömning av en nod och innan du återskapar den och går vidare till nästa nod. Om det inte anges är standardvärdet 0 minuter.

Parameteregenskaper

Parameteruppsättningar

-NodeTaint

Nodtainterna har lagts till i nya noder när nodpoolen skapas och skalas

Parameteregenskaper

Parameteruppsättningar

-OsDiskSize

Standardantalet noder för nodpoolerna.

Parameteregenskaper

Parameteruppsättningar

-OSDiskType

Standardvärdet är "Tillfällig" om den virtuella datorn stöder den och har en cachedisk som är större än den begärda OSDiskSizeGB. Annars är standardvärdet "Hanterad". Kan inte ändras när du har skapat. För mer information, se Ephemeral OS.

Parameteregenskaper

Parameteruppsättningar

-OsSKU

OsSKU som ska användas för att ange OS SKU. Standardvärdet är Ubuntu om OSType är Linux. Standardvärdet är Windows2019 när Kubernetes <= 1.24 eller Windows2022 när Kubernetes >= 1.25 om OSType är Windows.

Parameteregenskaper

Parameteruppsättningar

-OsType

OsType som ska användas för att ange os-typ. Välj mellan Linux och Windows. Standard för Linux.

Parameteregenskaper

Parameteruppsättningar

-PodIPAllocationMode

Poddens IP-allokeringsläge. IP-allokeringsläget för poddar i agentpoolen. Måste användas med podSubnetId. Standardvärdet är "DynamicIndividual".

Parameteregenskaper

Parameteruppsättningar

-PodSubnetID

ID för det undernät som poddar ansluter till när de startas.

Parameteregenskaper

Parameteruppsättningar

-PPG

ID för närhetsplaceringsgrupp.

Parameteregenskaper

Parameteruppsättningar

-ResourceGroupName

Namnet på resursgruppen.

Parameteregenskaper

Parameteruppsättningar

-ScaleDownMode

Nedskalningsläget som ska användas vid skalning av agentpoolen. Detta påverkar även autoskalningsbeteendet för klustret. Om det inte anges är standardinställningen Ta bort.

Parameteregenskaper

Parameteruppsättningar

-ScaleSetEvictionPolicy

ScaleSetEvictionPolicy som ska användas för att ange borttagningsprincip för vm-skalningsuppsättning med låg prioritet. Standardvärdet är Ta bort.

Parameteregenskaper

Parameteruppsättningar

-ScaleSetPriority

ScaleSetPriority som ska användas för att ange prioritet för vm-skalningsuppsättning. Standardvärdet är vanligt.

Parameteregenskaper

Parameteruppsättningar

-SpotMaxPrice

Det högsta priset (i us-dollar) som du är villig att betala för spot-instanser. Möjliga värden är ett decimalvärde som är större än noll eller -1 vilket anger att standardpriset är up-to på begäran.

Parameteregenskaper

Parameteruppsättningar

-SshAccess

SSH-åtkomstmetoden för en agentpool.

Parameteregenskaper

Parameteruppsättningar

-SubscriptionId

ID:t för prenumerationen. Som standard körs cmdletar i den prenumeration som anges i den aktuella kontexten. Om användaren anger en annan prenumeration körs den aktuella cmdleten i den prenumeration som användaren har angett. Åsidosättande prenumerationer träder endast i kraft under livscykeln för den aktuella cmdleten. Den ändrar inte prenumerationen i kontexten och påverkar inte efterföljande cmdletar.

Parameteregenskaper

Parameteruppsättningar

-Tag

Taggarna som ska sparas på vm-skalningsuppsättningen för agentpoolen.

Parameteregenskaper

Parameteruppsättningar

-UndrainableNodeBehavior

Beteendet för oanvändbara noder under uppgraderingen. Den vanligaste orsaken till oanvändbara noder är poddavbrottsbudgetar (PDB), men andra problem, till exempel respitperiod för poddavslut överskrider den återstående timeouten per nod eller podden fortfarande är i ett körningstillstånd, kan också orsaka oanvändbara noder.

Parameteregenskaper

Parameteruppsättningar

-VmSetType

Representerar typer av en nodpool. Möjliga värden är: "VirtualMachineScaleSets", "AvailabilitySet"

Parameteregenskaper

Parameteruppsättningar

-VmSize

Storleken på den virtuella datorn. Standardvärdet väljs dynamiskt av AKS-resursprovidern baserat på kvot och kapacitet.

Parameteregenskaper

Parameteruppsättningar

-VnetSubnetID

VNet SubnetID anger det virtuella nätverkets undernätsidentifierare.

Parameteregenskaper

Parameteruppsättningar

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Parameteruppsättningar

-WorkloadRuntime

Typen av arbetsbelastning som en nod kan köra.

Parameteregenskaper

Parameteruppsättningar

CommonParameters

Indata

PSKubernetesCluster

Utdata

PSNodePool