Set-AzAksCluster

Syntaxe

defaultParameterSet (Par défaut)

Set-AzAksCluster
    [-ResourceGroupName] <String>
    [-Name] <String>
    [[-ServicePrincipalIdAndSecret] <PSCredential>]
    [-NodePoolMode <String>]
    [-AcrNameToDetach <String>]
    [-NodeImageOnly]
    [-ControlPlaneOnly]
    [-AutoScalerProfile <ManagedClusterPropertiesAutoScalerProfile>]
    [-EnableUptimeSLA]
    [-EnableOidcIssuer]
    [-Location <String>]
    [-LinuxProfileAdminUserName <String>]
    [-DnsNamePrefix <String>]
    [-KubernetesVersion <String>]
    [-NodeName <String>]
    [-NodeMinCount <Int32>]
    [-NodeMaxCount <Int32>]
    [-EnableNodeAutoScaling]
    [-NodeCount <Int32>]
    [-NodeOsDiskSize <Int32>]
    [-NodeVmSize <String>]
    [-NodePoolLabel <Hashtable>]
    [-NodePoolTag <Hashtable>]
    [-SshKeyValue <String>]
    [-AcrNameToAttach <String>]
    [-AsJob]
    [-Tag <Hashtable>]
    [-LoadBalancerAllocatedOutboundPort <Int32>]
    [-LoadBalancerManagedOutboundIpCount <Int32>]
    [-LoadBalancerOutboundIp <String[]>]
    [-LoadBalancerOutboundIpPrefix <String[]>]
    [-LoadBalancerIdleTimeoutInMinute <Int32>]
    [-ApiServerAccessAuthorizedIpRange <String[]>]
    [-EnableApiServerAccessPrivateCluster]
    [-ApiServerAccessPrivateDnsZone <String>]
    [-EnableApiServerAccessPrivateClusterPublicFQDN]
    [-FqdnSubdomain <String>]
    [-EnableManagedIdentity]
    [-AssignIdentity <String>]
    [-AutoUpgradeChannel <String>]
    [-DiskEncryptionSetID <String>]
    [-DisableLocalAccount]
    [-HttpProxy <String>]
    [-HttpsProxy <String>]
    [-HttpProxyConfigNoProxyEndpoint <String[]>]
    [-HttpProxyConfigTrustedCa <String>]
    [-AksCustomHeader <Hashtable>]
    [-AadProfile <ManagedClusterAADProfile>]
    [-WindowsProfileAdminUserPassword <SecureString>]
    [-EnableAHUB]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-SubscriptionId <String>]
    [<CommonParameters>]

InputObjectParameterSet

Set-AzAksCluster
    -InputObject <PSKubernetesCluster>
    [-NodePoolMode <String>]
    [-AcrNameToDetach <String>]
    [-NodeImageOnly]
    [-ControlPlaneOnly]
    [-AutoScalerProfile <ManagedClusterPropertiesAutoScalerProfile>]
    [-EnableUptimeSLA]
    [-EnableOidcIssuer]
    [-Location <String>]
    [-LinuxProfileAdminUserName <String>]
    [-DnsNamePrefix <String>]
    [-KubernetesVersion <String>]
    [-NodeName <String>]
    [-NodeMinCount <Int32>]
    [-NodeMaxCount <Int32>]
    [-EnableNodeAutoScaling]
    [-NodeCount <Int32>]
    [-NodeOsDiskSize <Int32>]
    [-NodeVmSize <String>]
    [-NodePoolLabel <Hashtable>]
    [-NodePoolTag <Hashtable>]
    [-SshKeyValue <String>]
    [-AcrNameToAttach <String>]
    [-AsJob]
    [-Tag <Hashtable>]
    [-LoadBalancerAllocatedOutboundPort <Int32>]
    [-LoadBalancerManagedOutboundIpCount <Int32>]
    [-LoadBalancerOutboundIp <String[]>]
    [-LoadBalancerOutboundIpPrefix <String[]>]
    [-LoadBalancerIdleTimeoutInMinute <Int32>]
    [-ApiServerAccessAuthorizedIpRange <String[]>]
    [-EnableApiServerAccessPrivateCluster]
    [-ApiServerAccessPrivateDnsZone <String>]
    [-EnableApiServerAccessPrivateClusterPublicFQDN]
    [-FqdnSubdomain <String>]
    [-EnableManagedIdentity]
    [-AssignIdentity <String>]
    [-AutoUpgradeChannel <String>]
    [-DiskEncryptionSetID <String>]
    [-DisableLocalAccount]
    [-HttpProxy <String>]
    [-HttpsProxy <String>]
    [-HttpProxyConfigNoProxyEndpoint <String[]>]
    [-HttpProxyConfigTrustedCa <String>]
    [-AksCustomHeader <Hashtable>]
    [-AadProfile <ManagedClusterAADProfile>]
    [-WindowsProfileAdminUserPassword <SecureString>]
    [-EnableAHUB]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-SubscriptionId <String>]
    [<CommonParameters>]

IdParameterSet

Set-AzAksCluster
    [-Id] <String>
    [-NodePoolMode <String>]
    [-AcrNameToDetach <String>]
    [-NodeImageOnly]
    [-ControlPlaneOnly]
    [-AutoScalerProfile <ManagedClusterPropertiesAutoScalerProfile>]
    [-EnableUptimeSLA]
    [-EnableOidcIssuer]
    [-Location <String>]
    [-LinuxProfileAdminUserName <String>]
    [-DnsNamePrefix <String>]
    [-KubernetesVersion <String>]
    [-NodeName <String>]
    [-NodeMinCount <Int32>]
    [-NodeMaxCount <Int32>]
    [-EnableNodeAutoScaling]
    [-NodeCount <Int32>]
    [-NodeOsDiskSize <Int32>]
    [-NodeVmSize <String>]
    [-NodePoolLabel <Hashtable>]
    [-NodePoolTag <Hashtable>]
    [-SshKeyValue <String>]
    [-AcrNameToAttach <String>]
    [-AsJob]
    [-Tag <Hashtable>]
    [-LoadBalancerAllocatedOutboundPort <Int32>]
    [-LoadBalancerManagedOutboundIpCount <Int32>]
    [-LoadBalancerOutboundIp <String[]>]
    [-LoadBalancerOutboundIpPrefix <String[]>]
    [-LoadBalancerIdleTimeoutInMinute <Int32>]
    [-ApiServerAccessAuthorizedIpRange <String[]>]
    [-EnableApiServerAccessPrivateCluster]
    [-ApiServerAccessPrivateDnsZone <String>]
    [-EnableApiServerAccessPrivateClusterPublicFQDN]
    [-FqdnSubdomain <String>]
    [-EnableManagedIdentity]
    [-AssignIdentity <String>]
    [-AutoUpgradeChannel <String>]
    [-DiskEncryptionSetID <String>]
    [-DisableLocalAccount]
    [-HttpProxy <String>]
    [-HttpsProxy <String>]
    [-HttpProxyConfigNoProxyEndpoint <String[]>]
    [-HttpProxyConfigTrustedCa <String>]
    [-AksCustomHeader <Hashtable>]
    [-AadProfile <ManagedClusterAADProfile>]
    [-WindowsProfileAdminUserPassword <SecureString>]
    [-EnableAHUB]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-SubscriptionId <String>]
    [<CommonParameters>]

Description

Exemples

Exemple 1 :

Get-AzAksCluster -ResourceGroupName group -Name myCluster | Set-AzAksCluster -NodeCount 5

Exemple 2 : Mettez à jour un cluster AKS avec AutoScalerProfile.

$AutoScalerProfile=@{
    ScanInterval="40s"
    Expander="priority"
}
$AutoScalerProfile=[Microsoft.Azure.Management.ContainerService.Models.ManagedClusterPropertiesAutoScalerProfile]$AutoScalerProfile

Get-AzAksCluster -ResourceGroupName group -Name myCluster | Set-AzAksCluster -AutoScalerProfile $AutoScalerProfile

Exemple 3 : Mettez à jour un cluster AKS avec AadProfile.

$AKSAdminGroup=New-AzADGroup -DisplayName myAKSAdminGroup -MailNickname myAKSAdminGroup
$AadProfile=@{
    managed=$true
    enableAzureRBAC=$false
    adminGroupObjectIDs=[System.Collections.Generic.List[string]]@($AKSAdminGroup.Id)
}
$AadProfile=[Microsoft.Azure.Management.ContainerService.Models.ManagedClusterAADProfile]$AadProfile

Set-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -AadProfile $AadProfile

Paramètres

-AadProfile

Configuration d’Azure Active Directory.

Propriétés du paramètre

Jeux de paramètres

-AcrNameToAttach

Accordez le rôle « acrpull » de l’ACR spécifié au principal du service AKS, par exemple myacr

Propriétés du paramètre

Jeux de paramètres

-AcrNameToDetach

Désactivez l’attribution de rôle « acrpull » à l’ACR spécifiée par le nom ou l’ID de ressource, par exemple myacr

Propriétés du paramètre

Jeux de paramètres

-AksCustomHeader

En-têtes personnalisés Aks utilisés pour créer un réseau Kubernetes.

Propriétés du paramètre

Jeux de paramètres

-ApiServerAccessAuthorizedIpRange

Les plages d’adresses IP autorisées à accéder au serveur d’API Kubernetes.

Propriétés du paramètre

Jeux de paramètres

-ApiServerAccessPrivateDnsZone

Mode de zone DNS privé pour le cluster.

Propriétés du paramètre

Jeux de paramètres

-AsJob

Exécuter l’applet de commande en arrière-plan

Propriétés du paramètre

Jeux de paramètres

-AssignIdentity

ResourceId de l’utilisateur attribue une identité managée pour le cluster.

Propriétés du paramètre

Jeux de paramètres

-AutoScalerProfile

Paramètres à appliquer à l’autoscaler de cluster.

Propriétés du paramètre

Jeux de paramètres

-AutoUpgradeChannel

Canal de mise à niveau pour la mise à niveau automatique. Pour plus d’informations, consultez https://learn.microsoft.com/azure/aks/upgrade-cluster#set-auto-upgrade-channel.

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

-ControlPlaneOnly

Met à niveau uniquement le plan de contrôle vers la version cible.

Propriétés du paramètre

Jeux de paramètres

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Jeux de paramètres

-DisableLocalAccount

Les comptes locaux doivent être désactivés sur le cluster managé.

Propriétés du paramètre

Jeux de paramètres

-DiskEncryptionSetID

ID de ressource du jeu de chiffrement de disque à utiliser pour activer le chiffrement.

Propriétés du paramètre

Jeux de paramètres

-DnsNamePrefix

Préfixe de nom DNS pour le cluster.

Propriétés du paramètre

Jeux de paramètres

-EnableAHUB

Indique s’il faut activer Azure Hybrid User Benefits (AHUB) pour les machines virtuelles Windows.

Propriétés du paramètre

Jeux de paramètres

-EnableApiServerAccessPrivateCluster

Indique s’il faut créer le cluster en tant que cluster privé ou non.

Propriétés du paramètre

Jeux de paramètres

-EnableApiServerAccessPrivateClusterPublicFQDN

Indique s’il faut créer un nom de domaine complet public supplémentaire pour un cluster privé ou non.

Propriétés du paramètre

Jeux de paramètres

-EnableManagedIdentity

Utilisation d’une identité managée pour gérer le groupe de ressources de cluster.

Propriétés du paramètre

Jeux de paramètres

-EnableNodeAutoScaling

Indique s’il faut activer la mise à l’échelle automatique

Propriétés du paramètre

Jeux de paramètres

-EnableOidcIssuer

Indique s’il faut activer la fonctionnalité d’émetteur OIDC.

Propriétés du paramètre

Jeux de paramètres

-EnableUptimeSLA

Indique s’il faut utiliser le contrat SLA de temps d’activité.

Propriétés du paramètre

Jeux de paramètres

-FqdnSubdomain

Sous-domaine du nom de domaine complet du cluster privé avec une zone dns privée personnalisée.

Propriétés du paramètre

Jeux de paramètres

-HttpProxy

Point de terminaison du serveur proxy HTTP à utiliser.

Propriétés du paramètre

Jeux de paramètres

-HttpProxyConfigNoProxyEndpoint

Points de terminaison qui ne doivent pas passer par proxy.

Propriétés du paramètre

Jeux de paramètres

-HttpProxyConfigTrustedCa

Autre certificat d’autorité de certification à utiliser pour la connexion aux serveurs proxy.

Propriétés du paramètre

Jeux de paramètres

-HttpsProxy

Point de terminaison du serveur proxy HTTPS à utiliser

Propriétés du paramètre

Jeux de paramètres

-Id

ID d’un cluster Kubernetes managé

Propriétés du paramètre

Jeux de paramètres

-InputObject

Objet PSKubernetesCluster, normalement passé par le pipeline.

Propriétés du paramètre

Jeux de paramètres

-KubernetesVersion

Version de Kubernetes à utiliser pour créer le cluster.

Propriétés du paramètre

Jeux de paramètres

-LinuxProfileAdminUserName

Nom d’utilisateur pour les machines virtuelles Linux.

Propriétés du paramètre

Jeux de paramètres

-LoadBalancerAllocatedOutboundPort

Nombre souhaité de ports SNAT alloués par machine virtuelle.

Propriétés du paramètre

Jeux de paramètres

-LoadBalancerIdleTimeoutInMinute

Délai d’inactivité du flux sortant souhaité en minutes.

Propriétés du paramètre

Jeux de paramètres

-LoadBalancerManagedOutboundIpCount

Nombre d’adresses IP sortantes gérées souhaitées pour l’équilibreur de charge du cluster.

Propriétés du paramètre

Jeux de paramètres

-LoadBalancerOutboundIp

Ressources IP sortantes souhaitées pour l’équilibreur de charge du cluster.

Propriétés du paramètre

Jeux de paramètres

-LoadBalancerOutboundIpPrefix

Ressources de préfixe IP sortantes souhaitées pour l’équilibreur de charge du cluster.

Propriétés du paramètre

Jeux de paramètres

-Location

Emplacement Azure pour le cluster. La valeur par défaut est l’emplacement du groupe de ressources.

Propriétés du paramètre

Jeux de paramètres

-Name

Nom du cluster managé Kubernetes.

Propriétés du paramètre

Jeux de paramètres

-NodeCount

Nombre par défaut de nœuds pour les pools de nœuds.

Propriétés du paramètre

Jeux de paramètres

-NodeImageOnly

Met à niveau uniquement l’image de nœud des pools d’agents.

Propriétés du paramètre

Jeux de paramètres

-NodeMaxCount

Nombre maximal de nœuds pour la mise à l’échelle automatique

Propriétés du paramètre

Jeux de paramètres

-NodeMinCount

Nombre minimal de nœuds pour la mise à l’échelle automatique.

Propriétés du paramètre

Jeux de paramètres

-NodeName

Nom unique du profil du pool d’agents dans le contexte de l’abonnement et du groupe de ressources.

Propriétés du paramètre

Jeux de paramètres

-NodeOsDiskSize

Spécifie la taille, en Go, du disque du système d’exploitation.

Propriétés du paramètre

Jeux de paramètres

-NodePoolLabel

Étiquettes de pool de nœuds utilisées pour créer un réseau Kubernetes.

Propriétés du paramètre

Jeux de paramètres

-NodePoolMode

NodePoolMode représente le mode d’un pool de nœuds.

Propriétés du paramètre

Jeux de paramètres

-NodePoolTag

Balises à conserver sur le groupe de machines virtuelles identiques du pool d’agents.

Propriétés du paramètre

Jeux de paramètres

-NodeVmSize

Taille de la machine virtuelle.

Propriétés du paramètre

Jeux de paramètres

-ResourceGroupName

Nom du groupe de ressources.

Propriétés du paramètre

Jeux de paramètres

-ServicePrincipalIdAndSecret

L’ID client et la clé secrète client associées au principal de l’application/du service AAD.

Propriétés du paramètre

Jeux de paramètres

-SshKeyValue

Valeur du fichier de clé SSH ou chemin d’accès au fichier de clé. La valeur par défaut est {HOME}/.ssh/id_rsa.pub.

Propriétés du paramètre

Jeux de paramètres

-SubscriptionId

ID de l’abonnement. Par défaut, les applets de commande sont exécutées dans l’abonnement défini dans le contexte actuel. Si l’utilisateur spécifie un autre abonnement, l’applet de commande actuelle est exécutée dans l’abonnement spécifié par l’utilisateur. La substitution d’abonnements prend effet uniquement pendant le cycle de vie de l’applet de commande actuelle. Il ne modifie pas l’abonnement dans le contexte et n’affecte pas les applets de commande suivantes.

Propriétés du paramètre

Jeux de paramètres

-Tag

Balises à appliquer à la ressource

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

-WindowsProfileAdminUserPassword

Mot de passe administrateur à utiliser pour les machines virtuelles Windows. Condition du mot de passe : au moins un minuscule, un majuscule, un caractère spécial !@#$%^&*(), la longueur minimale est de 12.

Propriétés du paramètre

Jeux de paramètres

CommonParameters

Entrées

PSKubernetesCluster

String

Sorties

PSKubernetesCluster