Delen via

New-AzNetworkCloudAgentPool

  • Referentie
Module:
Az.NetworkCloud

Maak een nieuwe Kubernetes-clusteragentgroep of werk de eigenschappen van de bestaande bij.

Syntaxis

New-AzNetworkCloudAgentPool
   -KubernetesClusterName <String>
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Count <Int64>
   -Location <String>
   -Mode <AgentPoolMode>
   -VMSkuName <String>
   [-AdministratorConfigurationAdminUsername <String>]
   [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
   [-AgentOptionHugepagesCount <Int64>]
   [-AgentOptionHugepagesSize <HugepagesSize>]
   [-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

Maak een nieuwe Kubernetes-clusteragentgroep of werk de eigenschappen van de bestaande bij.

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>

Met deze opdracht maakt u een agentgroep voor het opgegeven Kubernetes-cluster.

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.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-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. Zie de sectie NOTES voor ADMINISTRATORCONFIGURATIONSSHPUBLICKEY-eigenschappen en maak een hash-tabel.

Type:ISshPublicKey[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AgentOptionHugepagesCount

Het aantal enorme pagina's dat moet worden toegewezen.

Type:Int64
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AgentOptionHugepagesSize

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

Type:HugepagesSize
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AsJob

De opdracht uitvoeren als een taak

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AttachedNetworkConfigurationL2Network

De lijst met Laag 2-netwerken en gerelateerde configuratie voor bijlage. Zie de sectie NOTES voor ATTACHEDNETWORKCONFIGURATIONL2NETWORK eigenschappen en maak een hash-tabel om deze samen te stellen.

Type:IL2NetworkAttachmentConfiguration[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AttachedNetworkConfigurationL3Network

De lijst met Laag 3-netwerken en gerelateerde configuratie voor bijlage. Zie de sectie NOTES voor ATTACHEDNETWORKCONFIGURATIONL3NETWORK eigenschappen en maak een hash-tabel om deze samen te stellen.

Type:IL3NetworkAttachmentConfiguration[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AttachedNetworkConfigurationTrunkedNetwork

De lijst met Trunked Networks en gerelateerde configuratie voor bijlage. Zie de sectie NOTES voor DE EIGENSCHAPPEN ATTACHEDNETWORKCONFIGURATIONTRUNKEDNETWORK en maak een hash-tabel om deze samen te stellen.

Type:ITrunkedNetworkAttachmentConfiguration[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

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

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Count

Het aantal virtuele machines dat deze configuratie gebruikt.

Type:Int64
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

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

Type:PSObject
Aliassen:AzureRMContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ExtendedLocationName

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

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ExtendedLocationType

Het uitgebreide locatietype, bijvoorbeeld CustomLocation.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-KubernetesClusterName

De naam van het Kubernetes-cluster.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Label

De labels die zijn toegepast op de knooppunten in deze agentgroep. Zie de sectie NOTES voor LABEL-eigenschappen en maak een hash-tabel om deze samen te stellen.

Type:IKubernetesLabel[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Location

De geografische locatie waar de resource zich bevindt

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

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

Type:AgentPoolMode
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

De naam van de Kubernetes-clusteragentgroep.

Type:String
Aliassen:AgentPoolName
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NoWait

De opdracht asynchroon uitvoeren

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SubscriptionId

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

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Tag

Resourcetags.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Taint

De taints die zijn toegepast op de knooppunten in deze agentpool. Zie de sectie NOTES voor TAINT-eigenschappen en maak een hash-tabel om deze samen te stellen.

Type:IKubernetesLabel[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

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

Type:Int64
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

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

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

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

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VMSkuName

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

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

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

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden