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

Voorbeelden

Voorbeeld 1: Een knooppuntgroep maken met standaardparameters

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

Voorbeeld 2: Windows Server-container maken op een 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

Voorbeeld 3: Een knooppuntgroep maken met LinuxOSConfig en 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

Parameters

-AksCustomHeader

Aangepaste Aks-headers

Parametereigenschappen

Parametersets

-AvailabilityZone

Beschikbaarheidszones voor knooppunten. Moet VirtualMachineScaleSets AgentPoolType gebruiken.

Parametereigenschappen

Parametersets

-ClusterName

De naam van de beheerde clusterresource.

Parametereigenschappen

Parametersets

-ClusterObject

Geef het clusterobject op waarin u een knooppuntgroep wilt maken.

Parametereigenschappen

Parametersets

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Parametersets

-Count

Het standaardaantal knooppunten voor de knooppuntgroepen.

Parametereigenschappen

Parametersets

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Parametereigenschappen

Parametersets

-DrainTimeoutInMinute

De drain timeout voor een knooppunt. De hoeveelheid tijd (in minuten) om te wachten op verwijdering van pods en respijtvolle beëindiging per knooppunt. Deze verwijderingswachttijd eert het wachten op budgetten voor podonderbreking. Als deze tijd wordt overschreden, mislukt de upgrade. Als dit niet is opgegeven, is de standaardwaarde 30 minuten.

Parametereigenschappen

Parametersets

-EnableAutoScaling

Of automatische schaalaanpassing moet worden ingeschakeld

Parametereigenschappen

Parametersets

-EnableEncryptionAtHost

Of u het besturingssysteem en het gegevensstation op basis van een host wilt inschakelen

Parametereigenschappen

Parametersets

-EnableFIPS

Of u een besturingssysteem met FIPS-functionaliteit wilt gebruiken

Parametereigenschappen

Parametersets

-EnableNodePublicIp

Hiermee wordt aangegeven of het openbare IP-adres voor knooppunten moet worden ingeschakeld.

Parametereigenschappen

Parametersets

-EnableSecureBoot

Beveiligd opstarten is een functie van Vertrouwde start die ervoor zorgt dat alleen ondertekende besturingssystemen en stuurprogramma's kunnen worden opgestart. Zie aka.ms/aks/trustedlaunch voor meer informatie. Als dit niet is opgegeven, is de standaardwaarde onwaar.

Parametereigenschappen

Parametersets

-EnableUltraSSD

of UltraSSD moet worden ingeschakeld

Parametereigenschappen

Parametersets

-EnableVtpm

De vTPM is een vertrouwde startfunctie voor het configureren van een toegewezen beveiligde kluis voor sleutels en metingen die lokaal op het knooppunt worden bewaard. Zie aka.ms/aks/trustedlaunch voor meer informatie. Als dit niet is opgegeven, is de standaardwaarde onwaar.

Parametereigenschappen

Parametersets

-Force

Knooppuntgroep maken, zelfs als deze al bestaat

Parametereigenschappen

Parametersets

-GatewayPublicIPPrefixSize

De gatewayagentgroep koppelt één openbaar IPPrefix voor elke statische uitgaande gateway om openbaar uitgaand verkeer te bieden. De grootte van Public IPPrefix moet door de gebruiker worden geselecteerd. Elk knooppunt in de agentgroep wordt toegewezen met één IP van het IPPrefix. De IPPrefix-grootte fungeert dus als een limiet voor de grootte van de gatewayagentgroep. Vanwege de beperking van de grootte van openbare IPPrefix in Azure is het geldige waardebereik [28, 31] (/31 = 2 knooppunten/IP's, /30 = 4 knooppunten/IP's, /29 = 8 knooppunten/IP's, /28 = 16 knooppunten/IP-adressen). De standaardwaarde is 31.

Parametereigenschappen

Parametersets

-GPUDriver

Of u GPU-stuurprogramma's wilt installeren. Als deze niet is opgegeven, is de standaardwaarde Installeren.

Parametereigenschappen

Parametersets

-GpuInstanceProfile

Het GpuInstanceProfile dat moet worden gebruikt om het GPU MIG-exemplaarprofiel op te geven voor de ondersteunde GPU VM-SKU.

Parametereigenschappen

Parametersets

-HostGroupID

De volledig gekwalificeerde resource-id van de toegewezen hostgroep waaruit virtuele machines kunnen worden ingericht, die alleen worden gebruikt in het scenario voor het maken en niet mogen worden gewijzigd nadat deze is ingesteld.

Parametereigenschappen

Parametersets

-IfMatch

De aanvraag mag alleen worden voortgezet als een entiteit overeenkomt met deze tekenreeks.

Parametereigenschappen

Parametersets

-IfNoneMatch

De aanvraag moet alleen worden voortgezet als er geen entiteit overeenkomt met deze tekenreeks.

Parametereigenschappen

Parametersets

-KubeletConfig

De Kubelet-configuratie op de agentpoolknooppunten.

Parametereigenschappen

Parametersets

-KubernetesVersion

De versie van Kubernetes die moet worden gebruikt voor het maken van het cluster.

Parametereigenschappen

Parametersets

-LinuxOSConfig

De besturingssysteemconfiguratie van Linux-agentknooppunten.

Parametereigenschappen

Parametersets

-MaxCount

Maximum aantal knooppunten voor automatisch schalen

Parametereigenschappen

Parametersets

-MaxPodCount

Maximum aantal pods dat op het knooppunt kan worden uitgevoerd.

Parametereigenschappen

Parametersets

-MaxSurge

Het maximum aantal of het percentage knooppunten dat tijdens de upgrade is toegenomen.

Parametereigenschappen

Parametersets

-MaxUnavailable

Het maximum aantal of het percentage knooppunten dat tegelijkertijd niet beschikbaar is tijdens de upgrade. Dit kan worden ingesteld op een geheel getal (bijvoorbeeld '1') of een percentage (bijvoorbeeld '5%'). Als een percentage is opgegeven, is dit het percentage van de totale grootte van de agentgroep op het moment van de upgrade. Voor percentages worden breukknooppunten naar boven afgerond. Als dit niet is opgegeven, is de standaardwaarde 0. Zie voor meer informatie, inclusief aanbevolen procedures: https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster

Parametereigenschappen

Parametersets

-MessageOfTheDay

Het bericht van de dag voor Linux-knooppunten, met base64 gecodeerd. Een met base64 gecodeerde tekenreeks die na het decoderen naar /etc/motd wordt geschreven. Hiermee kunt u het bericht van de dag aanpassen voor Linux-knooppunten. Deze mag niet worden opgegeven voor Windows-knooppunten. Het moet een statische tekenreeks zijn (dat wil bijvoorbeeld onbewerkt worden afgedrukt en niet worden uitgevoerd als een script).

Parametereigenschappen

Parametersets

-MinCount

Minimaal aantal knooppunten voor automatisch schalen.

Parametereigenschappen

Parametersets

-Mode

De poolmodus

Parametereigenschappen

Parametersets

-Name

De naam van de knooppuntgroep.

Parametereigenschappen

Parametersets

-NetworkProfile

De netwerkinstellingen van een agentgroep.

Parametereigenschappen

Parametersets

-NodeLabel

Labels voor knooppuntgroepen die worden gebruikt voor het bouwen van een Kubernetes-netwerk.

Parametereigenschappen

Parametersets

-NodePublicIPPrefixID

De resource-id van het openbare IP-voorvoegsel voor de knooppuntgroep.

Parametereigenschappen

Parametersets

-NodeSoakDurationInMinute

De weekduur voor een knooppunt. De hoeveelheid tijd (in minuten) die moet worden gewacht na het leegmaken van een knooppunt en voordat u het opnieuw opgeeft en verdergaat met het volgende knooppunt. Als dit niet is opgegeven, is de standaardwaarde 0 minuten.

Parametereigenschappen

Parametersets

-NodeTaint

De knooppunttaints die zijn toegevoegd aan nieuwe knooppunten tijdens het maken en schalen van knooppuntgroepen

Parametereigenschappen

Parametersets

-OsDiskSize

Het standaardaantal knooppunten voor de knooppuntgroepen.

Parametereigenschappen

Parametersets

-OSDiskType

De standaardwaarde is 'kortstondig' als de VIRTUELE machine deze ondersteunt en een cacheschijf heeft die groter is dan de aangevraagde OSDiskSizeGB. Anders wordt standaard 'Beheerd' gebruikt. Kan niet worden gewijzigd na het maken. Zie Kortstondig besturingssysteem voor meer informatie.

Parametereigenschappen

Parametersets

-OsSKU

OsSKU die moet worden gebruikt om de SKU van het besturingssysteem op te geven. De standaardwaarde is Ubuntu als OSType Linux is. De standaardwaarde is Windows2019 wanneer Kubernetes <= 1.24 of Windows2022 wanneer Kubernetes >= 1.25 is als OSType Windows is.

Parametereigenschappen

Parametersets

-OsType

OsType dat moet worden gebruikt om het type besturingssysteem op te geven. Kies uit Linux en Windows. Standaard ingesteld op Linux.

Parametereigenschappen

Parametersets

-PodIPAllocationMode

De IP-toewijzingsmodus voor pods. De IP-toewijzingsmodus voor pods in de agentgroep. Moet worden gebruikt met podSubnetId. De standaardwaarde is DynamicIndividual.

Parametereigenschappen

Parametersets

-PodSubnetID

De id van het subnet waaraan pods worden samengevoegd wanneer deze worden gestart.

Parametereigenschappen

Parametersets

-PPG

De id voor nabijheidsplaatsingsgroep.

Parametereigenschappen

Parametersets

-ResourceGroupName

De naam van de resourcegroep.

Parametereigenschappen

Parametersets

-ScaleDownMode

De omlaagschaalmodus die moet worden gebruikt bij het schalen van de agentgroep. Dit heeft ook invloed op het gedrag van automatische schaalaanpassing van clusters. Als dit niet is opgegeven, wordt deze standaard verwijderd.

Parametereigenschappen

Parametersets

-ScaleSetEvictionPolicy

ScaleSetEvictionPolicy voor het opgeven van verwijderingsbeleid voor virtuele-machineschaalset met lage prioriteit. Standaard verwijderen.

Parametereigenschappen

Parametersets

-ScaleSetPriority

ScaleSetPriority die moet worden gebruikt voor het opgeven van prioriteit van virtuele-machineschaalsets. Standaard ingesteld op normaal.

Parametereigenschappen

Parametersets

-SpotMaxPrice

De maximale prijs (in Amerikaanse dollars) die u bereid bent te betalen voor spot-instanties. Mogelijke waarden zijn een decimale waarde die groter is dan nul of -1 die aangeeft dat de standaardprijs moet worden up-to op aanvraag.

Parametereigenschappen

Parametersets

-SshAccess

De sSH-toegangsmethode van een agentgroep.

Parametereigenschappen

Parametersets

-SubscriptionId

De id van het abonnement. Cmdlets worden standaard uitgevoerd in het abonnement dat is ingesteld in de huidige context. Als de gebruiker een ander abonnement opgeeft, wordt de huidige cmdlet uitgevoerd in het abonnement dat door de gebruiker is opgegeven. Het overschrijven van abonnementen wordt alleen van kracht tijdens de levenscyclus van de huidige cmdlet. Het abonnement wordt niet gewijzigd in de context en heeft geen invloed op volgende cmdlets.

Parametereigenschappen

Parametersets

-Tag

De tags die moeten worden bewaard in de virtuele-machineschaalset van de agentgroep.

Parametereigenschappen

Parametersets

-UndrainableNodeBehavior

Het gedrag voor oningestoorde knooppunten tijdens de upgrade. De meest voorkomende oorzaak van oningestoorde knooppunten is PDU's (Pod Disruption Budgets), maar andere problemen, zoals de respijtperiode voor podbeëindiging, overschrijden de resterende time-out voor het leegmaken van knooppunten of pods hebben nog steeds een actieve status, maar kunnen ook oningestoorde knooppunten veroorzaken.

Parametereigenschappen

Parametersets

-VmSetType

Vertegenwoordigt typen van een knooppuntgroep. Mogelijke waarden zijn: 'VirtualMachineScaleSets', 'AvailabilitySet'

Parametereigenschappen

Parametersets

-VmSize

De grootte van de virtuele machine. De standaardwaarde wordt dynamisch geselecteerd door de AKS-resourceprovider op basis van quota en capaciteit.

Parametereigenschappen

Parametersets

-VnetSubnetID

VNet SubnetID geeft de subnet-id van het VNet op.

Parametereigenschappen

Parametersets

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Parametersets

-WorkloadRuntime

Het type workload dat een knooppunt kan uitvoeren.

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

PSKubernetesCluster

Uitvoerwaarden

PSNodePool