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

Beschreibung

Beispiele

Beispiel 1: Erstellen des Kubernetes-Cluster-Agentpools

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

Parameter

-AdministratorConfigurationAdminUsername

Der Benutzername für den Administrator, der auf die Betriebssysteme angewendet wird, die Kubernetes-Knoten ausführen. Wenn nicht angegeben, wird ein Benutzername vom Dienst ausgewählt.

Parametereigenschaften

Parametersätze

-AdministratorConfigurationSshPublicKey

Die SSH-Konfiguration für die Betriebssysteme, die die Knoten im Kubernetes-Cluster ausführen. In einigen Fällen ist möglicherweise eine Spezifikation öffentlicher Schlüssel erforderlich, um eine Arbeitsumgebung zu erzeugen.

Parametereigenschaften

Parametersätze

-AgentOptionHugepagesCount

Die Anzahl der zuzuordnenden Hugepages.

Parametereigenschaften

Parametersätze

-AgentOptionHugepagesSize

Die Größe der zuzuordnenden Hugepages.

Parametereigenschaften

Parametersätze

-AsJob

Ausführen des Befehls als Auftrag

Parametereigenschaften

Parametersätze

-AttachedNetworkConfigurationL2Network

Die Liste der Layer 2-Netzwerke und die zugehörige Konfiguration für Anlagen.

Parametereigenschaften

Parametersätze

-AttachedNetworkConfigurationL3Network

Die Liste der Layer 3-Netzwerke und die zugehörige Konfiguration für Anlagen.

Parametereigenschaften

Parametersätze

-AttachedNetworkConfigurationTrunkedNetwork

Die Liste der Trunked Networks und die zugehörige Konfiguration für Anlagen.

Parametereigenschaften

Parametersätze

-AvailabilityZone

Die Liste der Verfügbarkeitszonen des Netzwerkcloudclusters, der für die Bereitstellung von Knoten in diesem Agentpool verwendet wird. Wenn nicht angegeben, werden alle Verfügbarkeitszonen verwendet.

Parametereigenschaften

Parametersätze

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Parametersätze

-Count

Die Anzahl der virtuellen Computer, die diese Konfiguration verwenden.

Parametereigenschaften

Parametersätze

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Parametereigenschaften

Parametersätze

-ExtendedLocationName

Die Ressourcen-ID des erweiterten Speicherorts, an dem die Ressource erstellt wird.

Parametereigenschaften

Parametersätze

-ExtendedLocationType

Der erweiterte Standorttyp, z. B. CustomLocation.

Parametereigenschaften

Parametersätze

-IfMatch

Das ETag der Transformation. Lassen Sie diesen Wert aus, um die aktuelle Ressource immer zu überschreiben. Geben Sie den zuletzt gesehenen ETag-Wert an, um zu verhindern, dass gleichzeitige Änderungen versehentlich überschrieben werden.

Parametereigenschaften

Parametersätze

-IfNoneMatch

Legen Sie auf '*' fest, damit ein neuer Datensatzsatz erstellt werden kann, aber um zu verhindern, dass eine vorhandene Ressource aktualisiert wird. Andere Werte führen zu Einem Fehler vom Server, da sie nicht unterstützt werden.

Parametereigenschaften

Parametersätze

-JsonFilePath

Pfad der JSON-Datei, die für den Erstellungsvorgang bereitgestellt wird

Parametereigenschaften

Parametersätze

-JsonString

Json-Zeichenfolge, die für den Create-Vorgang bereitgestellt wird

Parametereigenschaften

Parametersätze

-KubernetesClusterInputObject

Identity-Parameter

Parametereigenschaften

Parametersätze

-KubernetesClusterName

Der Name des Kubernetes-Clusters

Parametereigenschaften

Parametersätze

-Label

Die Bezeichnungen, die auf die Knoten in diesem Agentpool angewendet werden.

Parametereigenschaften

Parametersätze

-Location

Der geografische Standort, an dem sich die Ressource befindet

Parametereigenschaften

Parametersätze

-Mode

Die Auswahl, wie dieser Agentpool verwendet wird, entweder als Systempool oder als Benutzerpool. Systempools führen die Features und kritischen Dienste für den Kubernetes-Cluster aus, während Benutzerpools benutzerlastend sind. Jeder Kubernetes-Cluster muss mindestens einen Systemknotenpool mit mindestens einem Knoten enthalten.

Parametereigenschaften

Parametersätze

-Name

Der Name des Kubernetes-Cluster-Agentpools.

Parametereigenschaften

Parametersätze

-NoWait

Asynchrones Ausführen des Befehls

Parametereigenschaften

Parametersätze

-ResourceGroupName

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

Parametereigenschaften

Parametersätze

-SubscriptionId

Die ID des Zielabonnements. Der Wert muss eine UUID sein.

Parametereigenschaften

Parametersätze

-Tag

Ressourcentags.

Parametereigenschaften

Parametersätze

-Taint

Die auf die Knoten in diesem Agentpool angewendetenTaints.

Parametereigenschaften

Parametersätze

-UpgradeSettingDrainTimeout

Die maximale Zeit in Sekunden, die für den Abschluss eines Knotens zulässig ist, bevor sie mit dem Upgrade des Agentpools fortfahren. Wird während der Erstellung nicht angegeben, wird ein Wert von 1800 Sekunden verwendet.

Parametereigenschaften

Parametersätze

-UpgradeSettingMaxSurge

Die maximale Anzahl oder der Prozentsatz der Knoten, die während des Upgrades bereinigt werden. Dies kann entweder auf eine ganze Zahl (z. B. "5") oder einen Prozentsatz (z. B. "50%" festgelegt werden). Wenn ein Prozentsatz angegeben ist, ist er der Prozentsatz der Gesamtgröße des Agentpools zum Zeitpunkt des Upgrades. Bei Prozentsätzen werden Bruchknoten aufgerundet. Wird während der Erstellung nicht angegeben, wird ein Wert von 1 verwendet. Einer von MaxSurge und MaxUnavailable muss größer als 0 sein.

Parametereigenschaften

Parametersätze

-UpgradeSettingMaxUnavailable

Die maximale Anzahl oder der Prozentsatz der Knoten, die während des Upgrades nicht verfügbar sein können. Dies kann entweder auf eine ganze Zahl (z. B. "5") oder einen Prozentsatz (z. B. "50%" festgelegt werden). Wenn ein Prozentsatz angegeben ist, ist er der Prozentsatz der Gesamtgröße des Agentpools zum Zeitpunkt des Upgrades. Bei Prozentsätzen werden Bruchknoten aufgerundet. Wird während der Erstellung nicht angegeben, wird ein Wert von 0 verwendet. Einer von MaxSurge und MaxUnavailable muss größer als 0 sein.

Parametereigenschaften

Parametersätze

-VMSkuName

Der Name der VM-SKU, die die Größe der Ressourcen bestimmt, die Knoten-VMs zugeordnet sind.

Parametereigenschaften

Parametersätze

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Parametersätze

CommonParameters

Eingaben

INetworkCloudIdentity

Ausgaben

IAgentPool