New-AzNetworkCloudAgentPool

Syntaxe

CreateExpanded (Par défaut)

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

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>

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.

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

-AgentOptionHugepagesCount

Nombre d’énormes pages à allouer.

Propriétés du paramètre

Jeux de paramètres

-AgentOptionHugepagesSize

Taille des énormes pages à allouer.

Propriétés du paramètre

Jeux de paramètres

-AsJob

Exécuter la commande en tant que travail

Propriétés du paramètre

Jeux de paramètres

-AttachedNetworkConfigurationL2Network

Liste des réseaux de couche 2 et configuration associée pour la pièce jointe.

Propriétés du paramètre

Jeux de paramètres

-AttachedNetworkConfigurationL3Network

Liste des réseaux de couche 3 et configuration associée pour la pièce jointe.

Propriétés du paramètre

Jeux de paramètres

-AttachedNetworkConfigurationTrunkedNetwork

Liste des réseaux jonctions et configuration associée pour la pièce jointe.

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Jeux de paramètres

-Count

Nombre de machines virtuelles qui utilisent cette configuration.

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

-ExtendedLocationName

ID de ressource de l’emplacement étendu sur lequel la ressource sera créée.

Propriétés du paramètre

Jeux de paramètres

-ExtendedLocationType

Type d’emplacement étendu, par exemple CustomLocation.

Propriétés du paramètre

Jeux de paramètres

-IfMatch

ETag de la transformation. Omettez cette valeur pour toujours remplacer la ressource actuelle. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.

Propriétés du paramètre

Jeux de paramètres

-IfNoneMatch

Définissez sur « * » pour autoriser la création d’un jeu d’enregistrements, mais pour empêcher la mise à jour d’une ressource existante. D’autres valeurs entraînent une erreur du serveur, car elles ne sont pas prises en charge.

Propriétés du paramètre

Jeux de paramètres

-JsonFilePath

Chemin d’accès du fichier Json fourni à l’opération Créer

Propriétés du paramètre

Jeux de paramètres

-JsonString

Chaîne Json fournie à l’opération Create

Propriétés du paramètre

Jeux de paramètres

-KubernetesClusterInputObject

Paramètre d’identité

Propriétés du paramètre

Jeux de paramètres

-KubernetesClusterName

Nom du cluster Kubernetes.

Propriétés du paramètre

Jeux de paramètres

-Label

Étiquettes appliquées aux nœuds de ce pool d’agents.

Propriétés du paramètre

Jeux de paramètres

-Location

Emplacement géographique où réside la ressource

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

-Name

Nom du pool d’agents de cluster Kubernetes.

Propriétés du paramètre

Jeux de paramètres

-NoWait

Exécuter la commande de manière asynchrone

Propriétés du paramètre

Jeux de paramètres

-ResourceGroupName

Nom du groupe de ressources. Le nom ne respecte pas la casse.

Propriétés du paramètre

Jeux de paramètres

-SubscriptionId

ID de l’abonnement cible. La valeur doit être un UUID.

Propriétés du paramètre

Jeux de paramètres

-Tag

Balises de ressource.

Propriétés du paramètre

Jeux de paramètres

-Taint

Les teintes appliquées aux nœuds de ce pool d’agents.

Propriétés du paramètre

Jeux de paramètres

-UpgradeSettingDrainTimeout

Durée maximale en secondes autorisée pour qu’un drain de nœud se termine avant de poursuivre la mise à niveau du pool d’agents. Si elle n’est pas spécifiée lors de la création, une valeur de 1800 secondes est utilisée.

Propriétés du paramètre

Jeux de paramètres

-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 sur 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 elle n’est pas spécifiée lors de la création, une valeur de 1 est utilisée. MaxSurge et MaxUnavailable doivent être supérieurs à 0.

Propriétés du paramètre

Jeux de paramètres

-UpgradeSettingMaxUnavailable

Nombre maximal ou pourcentage de nœuds qui peuvent être indisponibles pendant la mise à niveau. Cela peut être défini sur un entier (par exemple, « 5 ») ou sur 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. S’il n’est pas spécifié lors de la création, une valeur de 0 est utilisée. MaxSurge et MaxUnavailable doivent être supérieurs à 0.

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Jeux de paramètres

CommonParameters

Entrées

INetworkCloudIdentity

Sorties

IAgentPool