New-AzNetworkCloudAgentPool
Erstellen Sie einen neuen Kubernetes-Cluster-Agent-Pool, oder aktualisieren Sie die Eigenschaften der vorhandenen.
Syntax
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[]>]
[-UpgradeSettingMaxSurge <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Erstellen Sie einen neuen Kubernetes-Cluster-Agent-Pool, oder aktualisieren Sie die Eigenschaften der vorhandenen.
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>
Mit diesem Befehl wird ein Agentpool für den angegebenen Kubernetes-Cluster erstellt.
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.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für ADMINISTRATORCONFIGURATIONSSHPUBLICKEY-Eigenschaften und erstellen eine Hashtabelle.
Typ: | ISshPublicKey[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AgentOptionHugepagesCount
Die Anzahl der zuzuordnenden Hugepages.
Typ: | Int64 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AgentOptionHugepagesSize
Die Größe der zuzuordnenden Hugepages.
Typ: | HugepagesSize |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AsJob
Ausführen des Befehls als Auftrag
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AttachedNetworkConfigurationL2Network
Die Liste der Layer 2-Netzwerke und die zugehörige Konfiguration für Anlagen. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für ATTACHEDNETWORKCONFIGURATIONL2NETWORK Eigenschaften und erstellen eine Hashtabelle.
Typ: | IL2NetworkAttachmentConfiguration[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AttachedNetworkConfigurationL3Network
Die Liste der Layer 3-Netzwerke und die zugehörige Konfiguration für Anlagen. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für ATTACHEDNETWORKCONFIGURATIONL3NETWORK Eigenschaften und Erstellen einer Hashtabelle.
Typ: | IL3NetworkAttachmentConfiguration[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AttachedNetworkConfigurationTrunkedNetwork
Die Liste der Trunked Networks und die zugehörige Konfiguration für Anlagen. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für ATTACHEDNETWORKCONFIGURATIONTRUNKEDNETWORK-Eigenschaften und erstellen eine Hashtabelle.
Typ: | ITrunkedNetworkAttachmentConfiguration[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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.
Typ: | String[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Typ: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Count
Die Anzahl der virtuellen Computer, die diese Konfiguration verwenden.
Typ: | Int64 |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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.
Typ: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtendedLocationName
Die Ressourcen-ID des erweiterten Speicherorts, an dem die Ressource erstellt wird.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtendedLocationType
Der erweiterte Standorttyp, z. B. CustomLocation.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-KubernetesClusterName
Der Name des Kubernetes-Clusters
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Label
Die Bezeichnungen, die auf die Knoten in diesem Agentpool angewendet werden. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für BEZEICHNUNGseigenschaften, und erstellen Sie eine Hashtabelle.
Typ: | IKubernetesLabel[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Der geografische Standort, an dem sich die Ressource befindet
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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.
Typ: | AgentPoolMode |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Der Name des Kubernetes-Cluster-Agentpools.
Typ: | String |
Aliases: | AgentPoolName |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoWait
Asynchrones Ausführen des Befehls
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubscriptionId
Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.
Typ: | String |
Position: | Named |
Standardwert: | (Get-AzContext).Subscription.Id |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
Ressourcentags.
Typ: | Hashtable |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Taint
Die auf die Knoten in diesem Agentpool angewendetenTaints. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für TAINT-Eigenschaften und erstellen eine Hashtabelle.
Typ: | IKubernetesLabel[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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. Wenn nichts angegeben ist, wird der Standardwert 1 verwendet.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMSkuName
Der Name der VM-SKU, die die Größe der Ressourcen bestimmt, die Knoten-VMs zugeordnet sind.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Ausgaben
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für