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 |