Partager via


New-AzNetworkCloudKubernetesCluster

Créez un cluster Kubernetes ou mettez à jour les propriétés de l’existant.

Syntaxe

New-AzNetworkCloudKubernetesCluster
   -KubernetesClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -ControlPlaneNodeConfigurationCount <Int64>
   -ControlPlaneNodeConfigurationVMSkuName <String>
   -ExtendedLocationName <String>
   -ExtendedLocationType <String>
   -InitialAgentPoolConfiguration <IInitialAgentPoolConfiguration[]>
   -KubernetesVersion <String>
   -Location <String>
   -NetworkConfigurationCloudServicesNetworkId <String>
   -NetworkConfigurationCniNetworkId <String>
   [-AadConfigurationAdminGroupObjectId <String[]>]
   [-AdminUsername <String>]
   [-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
   [-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
   [-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
   [-BgpAdvertisement <IBgpAdvertisement[]>]
   [-BgpIPAddressPool <IIPAddressPool[]>]
   [-BgpPeer <IServiceLoadBalancerBgpPeer[]>]
   [-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled <FabricPeeringEnabled>]
   [-ControlPlaneNodeConfigurationAdminPublicKey <ISshPublicKey[]>]
   [-ControlPlaneNodeConfigurationAdminUsername <String>]
   [-ControlPlaneNodeConfigurationAvailabilityZone <String[]>]
   [-ManagedResourceGroupConfigurationLocation <String>]
   [-ManagedResourceGroupConfigurationName <String>]
   [-NetworkConfigurationDnsServiceIP <String>]
   [-NetworkConfigurationPodCidr <String[]>]
   [-NetworkConfigurationServiceCidr <String[]>]
   [-SshPublicKey <ISshPublicKey[]>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Créez un cluster Kubernetes ou mettez à jour les propriétés de l’existant.

Exemples

Exemple 1 : Créer un cluster Kubernetes

$tagHash = @{tags = "tag1" }
$agentPoolConfiguration = @{
    count = 1
    mode = "System"
    name = "agentPoolName"
    vmSkuName = "vmSkuName"
    administratorConfiguration = "administratorConfiguration"
}
$sshPublicKey = @{
    KeyData = "ssh-rsa aaaKyfsdx= fakekey@vm"
}
New-AzNetworkCloudKubernetesCluster -ResourceGroupName resourceGroupName `
                -KubernetesClusterName default -Location location `
                -ExtendedLocationName extendedLocationName `
                -ExtendedLocationType "CustomLocation" `
                -KubernetesVersion kubernetesVersion `
                -AadConfigurationAdminGroupObjectId adminGroupObjectIds `
                -AdminUsername "azureuser" `
                -SshPublicKey $sshPublicKey `
                -InitialAgentPoolConfiguration $agentPoolConfiguration `
                -NetworkConfigurationCloudServicesNetworkId cloudServicesNetworkId `
                -NetworkConfigurationCniNetworkId cniNetworkId `
                -SubscriptionId subscriptionId `
                -Tag $tagHash

Location Name    SystemDataCreatedAt SystemDataCreatedBy    SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy             SystemDataLastModifiedByType ResourceGroupName
-------- ----    ------------------- -------------------    ----------------------- ------------------------ ------------------------             ---------------------------- -----------------
eastus   default 08/09/2023 20:23:17 <identity>             User                    08/09/2023 20:44:27      <identity>                            Application                 resourceGroupName

Cette commande crée un cluster Kubernetes.

Paramètres

-AadConfigurationAdminGroupObjectId

Liste des ID d’objet de groupe Azure Active Directory qui auront un rôle d’administration sur le cluster Kubernetes.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AdminUsername

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
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AsJob

Exécuter la commande en tant que travail

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-BgpAdvertisement

Association de pools d’adresses IP aux communautés et aux pairs, ce qui permet l’annonce d’adresses IP. Pour construire, consultez la section NOTES pour les propriétés BGPADVERTISEMENT et créez une table de hachage.

Type:IBgpAdvertisement[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-BgpIPAddressPool

Liste des pools d’adresses IP qui peuvent être alloués aux services Load Balancer. Pour construire, consultez la section NOTES pour les propriétés BGPIPADDRESSPOOL et créez une table de hachage.

Type:IIPAddressPool[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-BgpPeer

Liste des entités BgpPeer supplémentaires que le cluster Kubernetes appairera. Tous les peerings doivent être définis explicitement. Pour construire, consultez la section NOTES pour les propriétés BGPPEER et créez une table de hachage.

Type:IServiceLoadBalancerBgpPeer[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled

Indicateur à spécifier si l’équilibreur de charge est pair avec l’infrastructure réseau.

Type:FabricPeeringEnabled
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter la commande cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ControlPlaneNodeConfigurationAdminPublicKey

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 CONTROLPLANENODECONFIGURATIONADMINPUBLICKEY et créez une table de hachage.

Type:ISshPublicKey[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ControlPlaneNodeConfigurationAdminUsername

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
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ControlPlaneNodeConfigurationAvailabilityZone

Liste des zones de disponibilité du cluster Cloud réseau à utiliser pour l’approvisionnement de nœuds dans le plan de contrôle. 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
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ControlPlaneNodeConfigurationCount

Nombre de machines virtuelles qui utilisent cette configuration.

Type:Int64
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ControlPlaneNodeConfigurationVMSkuName

Nom de la référence SKU de machine virtuelle fournie lors de la création.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Alias:AzureRMContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ExtendedLocationType

Type d’emplacement étendu, par exemple CustomLocation.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InitialAgentPoolConfiguration

Pools d’agents créés avec ce cluster Kubernetes pour l’exécution des services et charges de travail système critiques. Ces données dans ce champ sont utilisées uniquement lors de la création, et le champ sera vide après la création du cluster Kubernetes. Après la création, la gestion des pools d’agents est effectuée à l’aide de la sous-ressource AgentPools. Pour construire, consultez la section NOTES pour les propriétés INITIALAGENTPOOLCONFIGURATION et créez une table de hachage.

Type:IInitialAgentPoolConfiguration[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-KubernetesClusterName

Nom du cluster Kubernetes.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-KubernetesVersion

Version de Kubernetes pour ce cluster. Accepte n.n, n.n.n et n.n.n.n-n format. La version interprétée utilisée sera résolue dans ce champ après la création ou la mise à jour.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Location

Emplacement géographique où réside la ressource

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ManagedResourceGroupConfigurationLocation

Emplacement du groupe de ressources managé. S’il n’est pas spécifié, l’emplacement de la ressource parente est choisi.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ManagedResourceGroupConfigurationName

Nom du groupe de ressources managé. S’il n’est pas spécifié, le nom unique est généré automatiquement.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NetworkConfigurationCloudServicesNetworkId

ID de ressource du réseau Services cloud associé.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NetworkConfigurationCniNetworkId

ID de ressource du réseau de couche 3 utilisé pour la création du réseau d’interface réseau de conteneur.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NetworkConfigurationDnsServiceIP

Adresse IP affectée au service DNS Kubernetes. Elle doit se trouver dans la plage d’adresses du service Kubernetes spécifiée dans le CIDR de service.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NetworkConfigurationPodCidr

Les plages d’adresses IP de notation CIDR à partir desquelles attribuer des adresses IP de pod. Un CIDR IPv4 est attendu pour la mise en réseau à pile unique. Deux CIDR, un pour chaque famille IP (IPv4/IPv6), sont attendus pour la mise en réseau à double pile.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NetworkConfigurationServiceCidr

Les plages d’adresses IP de notation CIDR à partir desquelles attribuer des adresses IP de service. Un CIDR IPv4 est attendu pour la mise en réseau à pile unique. Deux CIDR, un pour chaque famille IP (IPv4/IPv6), sont attendus pour la mise en réseau à double pile.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NoWait

Exécuter la commande de manière asynchrone

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SshPublicKey

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 SSHPUBLICKEY et créez une table de hachage.

Type:ISshPublicKey[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Tag

Balises de ressource.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Sorties

IKubernetesCluster