New-AzNetworkCloudAgentPool

Syntax

CreateExpanded (Standard)

New-AzNetworkCloudAgentPool
    -Name <String>
    -KubernetesClusterName <String>
    -ResourceGroupName <String>
    -Count <Int64>
    -Location <String>
    -Mode <String>
    -VMSkuName <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AdministratorConfigurationAdminUsername <String>]
    [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
    [-AgentOptionHugepagesCount <Int64>]
    [-AgentOptionHugepagesSize <String>]
    [-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
    [-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
    [-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
    [-AvailabilityZone <String[]>]
    [-ExtendedLocationName <String>]
    [-ExtendedLocationType <String>]
    [-Label <IKubernetesLabel[]>]
    [-Tag <Hashtable>]
    [-Taint <IKubernetesLabel[]>]
    [-UpgradeSettingDrainTimeout <Int64>]
    [-UpgradeSettingMaxSurge <String>]
    [-UpgradeSettingMaxUnavailable <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonString

New-AzNetworkCloudAgentPool
    -Name <String>
    -KubernetesClusterName <String>
    -ResourceGroupName <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonFilePath

New-AzNetworkCloudAgentPool
    -Name <String>
    -KubernetesClusterName <String>
    -ResourceGroupName <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityKubernetesClusterExpanded

New-AzNetworkCloudAgentPool
    -Name <String>
    -KubernetesClusterInputObject <INetworkCloudIdentity>
    -Count <Int64>
    -Location <String>
    -Mode <String>
    -VMSkuName <String>
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AdministratorConfigurationAdminUsername <String>]
    [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
    [-AgentOptionHugepagesCount <Int64>]
    [-AgentOptionHugepagesSize <String>]
    [-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
    [-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
    [-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
    [-AvailabilityZone <String[]>]
    [-ExtendedLocationName <String>]
    [-ExtendedLocationType <String>]
    [-Label <IKubernetesLabel[]>]
    [-Tag <Hashtable>]
    [-Taint <IKubernetesLabel[]>]
    [-UpgradeSettingDrainTimeout <Int64>]
    [-UpgradeSettingMaxSurge <String>]
    [-UpgradeSettingMaxUnavailable <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exempel

Exempel 1: Skapa Kubernetes-klustrets agentpool

$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>

Parametrar

-AdministratorConfigurationAdminUsername

Användarnamnet för administratören som ska tillämpas på de operativsystem som kör Kubernetes-noder. Om det inte anges väljs ett användarnamn av tjänsten.

Parameteregenskaper

Parameteruppsättningar

-AdministratorConfigurationSshPublicKey

SSH-konfigurationen för de operativsystem som kör noderna i Kubernetes-klustret. I vissa fall kan det krävas specifikation av offentliga nycklar för att skapa en arbetsmiljö.

Parameteregenskaper

Parameteruppsättningar

-AgentOptionHugepagesCount

Antalet enorma sidor att allokera.

Parameteregenskaper

Parameteruppsättningar

-AgentOptionHugepagesSize

Storleken på de enorma sidor som ska allokeras.

Parameteregenskaper

Parameteruppsättningar

-AsJob

Kör kommandot som ett jobb

Parameteregenskaper

Parameteruppsättningar

-AttachedNetworkConfigurationL2Network

Listan över Layer 2-nätverk och relaterad konfiguration för bifogad fil.

Parameteregenskaper

Parameteruppsättningar

-AttachedNetworkConfigurationL3Network

Listan över Layer 3-nätverk och relaterad konfiguration för bifogad fil.

Parameteregenskaper

Parameteruppsättningar

-AttachedNetworkConfigurationTrunkedNetwork

Listan över trunkerade nätverk och relaterad konfiguration för bifogad fil.

Parameteregenskaper

Parameteruppsättningar

-AvailabilityZone

Listan över tillgänglighetszoner för nätverkets molnkluster som används för etablering av noder i den här agentpoolen. Om det inte anges används alla tillgänglighetszoner.

Parameteregenskaper

Parameteruppsättningar

-Confirm

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

Parameteregenskaper

Parameteruppsättningar

-Count

Antalet virtuella datorer som använder den här konfigurationen.

Parameteregenskaper

Parameteruppsättningar

-DefaultProfile

Parametern DefaultProfile fungerar inte. Använd parametern SubscriptionId när den är tillgänglig om du kör cmdleten mot en annan prenumeration.

Parameteregenskaper

Parameteruppsättningar

-ExtendedLocationName

Resurs-ID för den utökade plats där resursen ska skapas.

Parameteregenskaper

Parameteruppsättningar

-ExtendedLocationType

Den utökade platstypen, till exempel CustomLocation.

Parameteregenskaper

Parameteruppsättningar

-IfMatch

ETag för omvandlingen. Utelämna det här värdet för att alltid skriva över den aktuella resursen. Ange det senast synliga ETag-värdet för att förhindra att samtidiga ändringar skrivs över av misstag.

Parameteregenskaper

Parameteruppsättningar

-IfNoneMatch

Ange till *för att tillåta att en ny postuppsättning skapas, men för att förhindra uppdatering av en befintlig resurs. Andra värden resulterar i fel från servern eftersom de inte stöds.

Parameteregenskaper

Parameteruppsättningar

-JsonFilePath

Sökväg till Json-fil som angetts för åtgärden Skapa

Parameteregenskaper

Parameteruppsättningar

-JsonString

Json-sträng som har angetts för åtgärden Skapa

Parameteregenskaper

Parameteruppsättningar

-KubernetesClusterInputObject

Identitetsparameter

Parameteregenskaper

Parameteruppsättningar

-KubernetesClusterName

Namnet på Kubernetes-klustret.

Parameteregenskaper

Parameteruppsättningar

-Label

Etiketterna som tillämpas på noderna i den här agentpoolen.

Parameteregenskaper

Parameteruppsättningar

-Location

Den geo-plats där resursen finns

Parameteregenskaper

Parameteruppsättningar

-Mode

Valet av hur den här agentpoolen används, antingen som en systempool eller en användarpool. Systempooler kör funktioner och kritiska tjänster för Kubernetes-klustret, medan användarpooler är dedikerade till användararbetsbelastningar. Varje Kubernetes-kluster måste innehålla minst en systemnodpool med minst en nod.

Parameteregenskaper

Parameteruppsättningar

-Name

Namnet på Kubernetes-klusteragentpoolen.

Parameteregenskaper

Parameteruppsättningar

-NoWait

Kör kommandot asynkront

Parameteregenskaper

Parameteruppsättningar

-ResourceGroupName

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

Parameteregenskaper

Parameteruppsättningar

-SubscriptionId

ID för målprenumerationen. Värdet måste vara ett UUID.

Parameteregenskaper

Parameteruppsättningar

-Tag

Resursetiketter.

Parameteregenskaper

Parameteruppsättningar

-Taint

De taints som tillämpas på noderna i den här agentpoolen.

Parameteregenskaper

Parameteruppsättningar

-UpgradeSettingDrainTimeout

Den maximala tiden i sekunder som tillåts för att en nodavlopp ska slutföras innan du fortsätter med uppgraderingen av agentpoolen. Om det inte anges under skapandet används ett värde på 1 800 sekunder.

Parameteregenskaper

Parameteruppsättningar

-UpgradeSettingMaxSurge

Det maximala antalet eller procentandelen noder som ökar under uppgraderingen. Detta kan antingen anges till ett heltal (t.ex. "5") eller en procentandel (t.ex. "50%"). 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 under skapandet används värdet 1. En av MaxSurge och MaxUnavailable måste vara större än 0.

Parameteregenskaper

Parameteruppsättningar

-UpgradeSettingMaxUnavailable

Det maximala antalet eller procentandelen noder som kan vara otillgängliga under uppgraderingen. Detta kan antingen anges till ett heltal (t.ex. "5") eller en procentandel (t.ex. "50%"). 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 under skapandet används värdet 0. En av MaxSurge och MaxUnavailable måste vara större än 0.

Parameteregenskaper

Parameteruppsättningar

-VMSkuName

Namnet på den virtuella dator-SKU som avgör storleken på resurser som allokerats för virtuella noddatorer.

Parameteregenskaper

Parameteruppsättningar

-WhatIf

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

Parameteregenskaper

Parameteruppsättningar

CommonParameters

Indata

INetworkCloudIdentity

Utdata

IAgentPool