New-AzNetworkCloudAgentPool

Syntax

CreateExpanded (Standaard)

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

Voorbeelden

Voorbeeld 1: De agentgroep van het Kubernetes-cluster maken

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

Parameters

-AdministratorConfigurationAdminUsername

De gebruikersnaam voor de beheerder die wordt toegepast op de besturingssystemen waarop Kubernetes-knooppunten worden uitgevoerd. Indien niet opgegeven, wordt een gebruikersnaam gekozen door de service.

Parametereigenschappen

Parametersets

-AdministratorConfigurationSshPublicKey

De SSH-configuratie voor de besturingssystemen waarop de knooppunten in het Kubernetes-cluster worden uitgevoerd. In sommige gevallen kan specificatie van openbare sleutels vereist zijn om een werkomgeving te produceren.

Parametereigenschappen

Parametersets

-AgentOptionHugepagesCount

Het aantal enorme pagina's dat moet worden toegewezen.

Parametereigenschappen

Parametersets

-AgentOptionHugepagesSize

De grootte van de enorme pagina's die moeten worden toegewezen.

Parametereigenschappen

Parametersets

-AsJob

De opdracht uitvoeren als een taak

Parametereigenschappen

Parametersets

-AttachedNetworkConfigurationL2Network

De lijst met Laag 2-netwerken en gerelateerde configuratie voor bijlage.

Parametereigenschappen

Parametersets

-AttachedNetworkConfigurationL3Network

De lijst met Laag 3-netwerken en gerelateerde configuratie voor bijlage.

Parametereigenschappen

Parametersets

-AttachedNetworkConfigurationTrunkedNetwork

De lijst met Trunked Networks en gerelateerde configuratie voor bijlage.

Parametereigenschappen

Parametersets

-AvailabilityZone

De lijst met beschikbaarheidszones van het netwerkcloudcluster dat wordt gebruikt voor het inrichten van knooppunten in deze agentgroep. Als dit niet is opgegeven, worden alle beschikbaarheidszones gebruikt.

Parametereigenschappen

Parametersets

-Confirm

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

Parametereigenschappen

Parametersets

-Count

Het aantal virtuele machines dat deze configuratie gebruikt.

Parametereigenschappen

Parametersets

-DefaultProfile

De parameter DefaultProfile is niet functioneel. Gebruik de parameter SubscriptionId indien beschikbaar als u de cmdlet uitvoert voor een ander abonnement.

Parametereigenschappen

Parametersets

-ExtendedLocationName

De resource-id van de uitgebreide locatie waarop de resource wordt gemaakt.

Parametereigenschappen

Parametersets

-ExtendedLocationType

Het uitgebreide locatietype, bijvoorbeeld CustomLocation.

Parametereigenschappen

Parametersets

-IfMatch

De ETag van de transformatie. Laat deze waarde weg om de huidige resource altijd te overschrijven. Geef de laatst geziene ETag-waarde op om te voorkomen dat gelijktijdige wijzigingen per ongeluk worden overschreven.

Parametereigenschappen

Parametersets

-IfNoneMatch

Stel deze optie in op *, zodat een nieuwe recordset kan worden gemaakt, maar om te voorkomen dat een bestaande resource wordt bijgewerkt. Andere waarden resulteren in een fout van de server omdat ze niet worden ondersteund.

Parametereigenschappen

Parametersets

-JsonFilePath

Pad van het Json-bestand dat is opgegeven bij de bewerking Maken

Parametereigenschappen

Parametersets

-JsonString

Json-tekenreeks die is opgegeven bij de bewerking Maken

Parametereigenschappen

Parametersets

-KubernetesClusterInputObject

Identiteitsparameter

Parametereigenschappen

Parametersets

-KubernetesClusterName

De naam van het Kubernetes-cluster.

Parametereigenschappen

Parametersets

-Label

De labels die zijn toegepast op de knooppunten in deze agentgroep.

Parametereigenschappen

Parametersets

-Location

De geografische locatie waar de resource zich bevindt

Parametereigenschappen

Parametersets

-Mode

De selectie van hoe deze agentgroep wordt gebruikt, hetzij als een systeemgroep of een gebruikersgroep. Systeemgroepen voeren de functies en essentiële services voor het Kubernetes-cluster uit, terwijl gebruikersgroepen zijn toegewezen aan gebruikersworkloads. Elk Kubernetes-cluster moet ten minste één systeemknooppuntgroep met ten minste één knooppunt bevatten.

Parametereigenschappen

Parametersets

-Name

De naam van de Kubernetes-clusteragentgroep.

Parametereigenschappen

Parametersets

-NoWait

De opdracht asynchroon uitvoeren

Parametereigenschappen

Parametersets

-ResourceGroupName

De naam van de resource group. De naam is hoofdletterongevoelig.

Parametereigenschappen

Parametersets

-SubscriptionId

De ID van het doelabonnement. De waarde moet een UUID zijn.

Parametereigenschappen

Parametersets

-Tag

Resourcetags.

Parametereigenschappen

Parametersets

-Taint

De taints die zijn toegepast op de knooppunten in deze agentpool.

Parametereigenschappen

Parametersets

-UpgradeSettingDrainTimeout

De maximale tijd in seconden die is toegestaan voor het leegmaken van een knooppunt voordat u doorgaat met de upgrade van de agentgroep. Als deze niet is opgegeven tijdens het maken, wordt een waarde van 1800 seconden gebruikt.

Parametereigenschappen

Parametersets

-UpgradeSettingMaxSurge

Het maximum aantal knooppunten of het maximumpercentage van knooppunten dat tijdens de upgrade is overgegaan. Dit kan worden ingesteld op een geheel getal (bijvoorbeeld '5') of een percentage (bijvoorbeeld '50%'). 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 deze niet is opgegeven tijdens het maken, wordt een waarde van 1 gebruikt. Een van MaxSurge en MaxUnavailable moet groter zijn dan 0.

Parametereigenschappen

Parametersets

-UpgradeSettingMaxUnavailable

Het maximum aantal of het percentage knooppunten dat niet beschikbaar is tijdens de upgrade. Dit kan worden ingesteld op een geheel getal (bijvoorbeeld '5') of een percentage (bijvoorbeeld '50%'). 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 tijdens het maken, wordt een waarde van 0 gebruikt. Een van MaxSurge en MaxUnavailable moet groter zijn dan 0.

Parametereigenschappen

Parametersets

-VMSkuName

De naam van de VM-SKU die de grootte bepaalt van de resources die zijn toegewezen voor knooppunt-VM's.

Parametereigenschappen

Parametersets

-WhatIf

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

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

INetworkCloudIdentity

Uitvoerwaarden

IAgentPool