New-AzNetworkCloudAgentPool
Créez un pool d’agents de cluster Kubernetes ou mettez à jour les propriétés de l’agent existant.
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>]
Description
Créez un pool d’agents de cluster Kubernetes ou mettez à jour les propriétés de l’agent existant.
Exemples
Exemple 1 : Créer le pool d’agents du cluster Kubernetes
$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>
Cette commande crée un pool d’agents pour le cluster Kubernetes donné.
Paramètres
-AdministratorConfigurationAdminUsername
Nom d’utilisateur de l’administrateur qui sera appliqué aux systèmes d’exploitation qui exécutent des nœuds Kubernetes. S’il n’est pas fourni, un nom d’utilisateur est choisi par le service.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AdministratorConfigurationSshPublicKey
Configuration SSH pour les systèmes d’exploitation qui exécutent les nœuds dans le cluster Kubernetes. Dans certains cas, la spécification des clés publiques peut être nécessaire pour produire un environnement de travail. Pour construire, consultez la section NOTES pour les propriétés ADMINISTRATORCONFIGURATIONSSHPUBLICKEY et créez une table de hachage.
Type: | ISshPublicKey[] |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AgentOptionHugepagesCount
Nombre d’énormes pages à allouer.
Type: | Int64 |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AgentOptionHugepagesSize
Taille des énormes pages à allouer.
Type: | HugepagesSize |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AsJob
Exécuter la commande en tant que travail
Type: | SwitchParameter |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AttachedNetworkConfigurationL2Network
Liste des réseaux de couche 2 et configuration associée pour la pièce jointe. Pour construire, consultez la section NOTES pour ATTACHEDNETWORKCONFIGURATIONL2NETWORK propriétés et créer une table de hachage.
Type: | IL2NetworkAttachmentConfiguration[] |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AttachedNetworkConfigurationL3Network
Liste des réseaux de couche 3 et configuration associée pour la pièce jointe. Pour construire, consultez la section NOTES pour ATTACHEDNETWORKCONFIGURATIONL3NETWORK propriétés et créer une table de hachage.
Type: | IL3NetworkAttachmentConfiguration[] |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AttachedNetworkConfigurationTrunkedNetwork
Liste des réseaux jonctions et configuration associée pour la pièce jointe. Pour construire, consultez la section NOTES pour les propriétés ATTACHEDNETWORKCONFIGURATIONTRUNKEDNETWORK et créez une table de hachage.
Type: | ITrunkedNetworkAttachmentConfiguration[] |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailabilityZone
Liste des zones de disponibilité du cluster Cloud réseau utilisé pour l’approvisionnement de nœuds dans ce pool d’agents. S’il n’est pas spécifié, toutes les zones de disponibilité sont utilisées.
Type: | String[] |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Count
Nombre de machines virtuelles qui utilisent cette configuration.
Type: | Int64 |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Le paramètre DefaultProfile n’est pas fonctionnel. Utilisez le paramètre SubscriptionId lorsqu’il est disponible si vous exécutez l’applet de commande sur un autre abonnement.
Type: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtendedLocationName
ID de ressource de l’emplacement étendu sur lequel la ressource sera créée.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtendedLocationType
Type d’emplacement étendu, par exemple CustomLocation.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-KubernetesClusterName
Nom du cluster Kubernetes.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Label
Étiquettes appliquées aux nœuds de ce pool d’agents. Pour construire, consultez la section NOTES pour les propriétés LABEL et créez une table de hachage.
Type: | IKubernetesLabel[] |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Emplacement géographique où réside la ressource
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Mode
Sélection de la façon dont ce pool d’agents est utilisé, en tant que pool système ou pool d’utilisateurs. Les pools système exécutent les fonctionnalités et les services critiques pour le cluster Kubernetes, tandis que les pools d’utilisateurs sont dédiés aux charges de travail utilisateur. Chaque cluster Kubernetes doit contenir au moins un pool de nœuds système avec au moins un nœud.
Type: | AgentPoolMode |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Nom du pool d’agents de cluster Kubernetes.
Type: | String |
Aliases: | AgentPoolName |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoWait
Exécuter la commande de manière asynchrone
Type: | SwitchParameter |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Nom du groupe de ressources. Le nom ne respecte pas la casse.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubscriptionId
ID de l’abonnement cible. La valeur doit être un UUID.
Type: | String |
Position: | Named |
valeur par défaut: | (Get-AzContext).Subscription.Id |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
Balises de ressource.
Type: | Hashtable |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Taint
Les teintes appliquées aux nœuds de ce pool d’agents. Pour construire, consultez la section NOTES pour les propriétés TAINT et créez une table de hachage.
Type: | IKubernetesLabel[] |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpgradeSettingMaxSurge
Nombre maximal ou pourcentage de nœuds qui sont augmentés pendant la mise à niveau. Cela peut être défini sur un entier (par exemple, « 5 ») ou un pourcentage (par exemple, « 50 % »). Si un pourcentage est spécifié, il s’agit du pourcentage de la taille totale du pool d’agents au moment de la mise à niveau. Pour les pourcentages, les nœuds fractionnaires sont arrondis. Si cet argument n'est pas spécifié, la valeur par défaut est 1.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMSkuName
Nom de la référence SKU de machine virtuelle qui détermine la taille des ressources allouées pour les machines virtuelles de nœud.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Sorties
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour