New-AzNetworkCloudKubernetesCluster
Créez un cluster Kubernetes ou créez les propriétés de l’existant.
Syntaxe
CreateExpanded (Par défaut)
New-AzNetworkCloudKubernetesCluster
-Name <String>
-ResourceGroupName <String>
-ControlPlaneNodeConfigurationCount <Int64>
-ControlPlaneNodeConfigurationVMSkuName <String>
-ExtendedLocationName <String>
-ExtendedLocationType <String>
-InitialAgentPoolConfiguration <IInitialAgentPoolConfiguration[]>
-KubernetesVersion <String>
-Location <String>
-NetworkConfigurationCloudServicesNetworkId <String>
-NetworkConfigurationCniNetworkId <String>
[-SubscriptionId <String>]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-AadConfigurationAdminGroupObjectId <String[]>]
[-AdminUsername <String>]
[-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
[-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
[-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
[-BgpAdvertisement <IBgpAdvertisement[]>]
[-BgpIPAddressPool <IIPAddressPool[]>]
[-BgpPeer <IServiceLoadBalancerBgpPeer[]>]
[-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled <String>]
[-ControlPlaneNodeConfigurationAdminPublicKey <ISshPublicKey[]>]
[-ControlPlaneNodeConfigurationAdminUsername <String>]
[-ControlPlaneNodeConfigurationAvailabilityZone <String[]>]
[-L2ServiceLoadBalancerConfigurationIPAddressPool <IIPAddressPool[]>]
[-ManagedResourceGroupConfigurationLocation <String>]
[-ManagedResourceGroupConfigurationName <String>]
[-NetworkConfigurationDnsServiceIP <String>]
[-NetworkConfigurationPodCidr <String[]>]
[-NetworkConfigurationServiceCidr <String[]>]
[-SshPublicKey <ISshPublicKey[]>]
[-Tag <Hashtable>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaJsonFilePath
New-AzNetworkCloudKubernetesCluster
-Name <String>
-ResourceGroupName <String>
-JsonFilePath <String>
[-SubscriptionId <String>]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaJsonString
New-AzNetworkCloudKubernetesCluster
-Name <String>
-ResourceGroupName <String>
-JsonString <String>
[-SubscriptionId <String>]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Créez un cluster Kubernetes ou créez 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.
Propriétés du paramètre
Type: String [ ]
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: 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.
Propriétés du paramètre
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-AsJob
Exécuter la commande en tant que travail
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
(All)
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-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
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-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
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-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
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-BgpAdvertisement
Association de pools d’adresses IP aux communautés et aux pairs, ce qui permet l’annonce d’adresses IP.
Propriétés du paramètre
Type: IBgpAdvertisement [ ]
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-BgpIPAddressPool
Liste des pools d’adresses IP qui peuvent être alloués aux services d’équilibreur de charge.
Propriétés du paramètre
Type: IIPAddressPool [ ]
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-BgpPeer
Liste des entités BgpPeer supplémentaires que le cluster Kubernetes appairera.
Tous les peerings doivent être définis explicitement.
Propriétés du paramètre
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled
Indicateur à spécifier si l’équilibreur de charge est pair avec l’infrastructure réseau.
Propriétés du paramètre
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Alias: cf
Jeux de paramètres
(All)
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: 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.
Propriétés du paramètre
Type: ISshPublicKey [ ]
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: 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.
Propriétés du paramètre
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: 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.
Propriétés du paramètre
Type: String [ ]
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-ControlPlaneNodeConfigurationCount
Nombre de machines virtuelles qui utilisent cette configuration.
Propriétés du paramètre
Type: Int64
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-ControlPlaneNodeConfigurationVMSkuName
Nom de la référence SKU de machine virtuelle fournie lors de la création.
Propriétés du paramètre
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: 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.
Propriétés du paramètre
Type: PSObject
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Alias: AzureRMContext, AzureCredential
Jeux de paramètres
(All)
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-ExtendedLocationName
ID de ressource de l’emplacement étendu sur lequel la ressource sera créée.
Propriétés du paramètre
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-ExtendedLocationType
Type d’emplacement étendu, par exemple CustomLocation.
Propriétés du paramètre
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-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
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
(All)
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-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
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
(All)
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: 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.
Propriétés du paramètre
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-JsonFilePath
Chemin d’accès du fichier Json fourni à l’opération Créer
Propriétés du paramètre
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateViaJsonFilePath
Position: Named
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-JsonString
Chaîne Json fournie à l’opération Create
Propriétés du paramètre
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateViaJsonString
Position: Named
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-KubernetesVersion
Version de Kubernetes pour ce cluster.
Propriétés du paramètre
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-L2ServiceLoadBalancerConfigurationIPAddressPool
Liste des pools d’adresses IP qui peuvent être alloués aux services d’équilibreur de charge.
Propriétés du paramètre
Type: IIPAddressPool [ ]
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-Location
Emplacement géographique où réside la ressource
Propriétés du paramètre
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-ManagedResourceGroupConfigurationLocation
Emplacement du groupe de ressources managé.
S’il n’est pas spécifié, l’emplacement de la ressource parente est choisi.
Propriétés du paramètre
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-ManagedResourceGroupConfigurationName
Nom du groupe de ressources managé.
S’il n’est pas spécifié, le nom unique est généré automatiquement.
Propriétés du paramètre
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-Name
Nom du cluster Kubernetes.
Propriétés du paramètre
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Alias: KubernetesClusterName
Jeux de paramètres
(All)
Position: Named
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-NetworkConfigurationCloudServicesNetworkId
ID de ressource du réseau des services cloud associés.
Propriétés du paramètre
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: 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.
Propriétés du paramètre
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: 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.
Propriétés du paramètre
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: 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.
Propriétés du paramètre
Type: String [ ]
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: 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.
Propriétés du paramètre
Type: String [ ]
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-NoWait
Exécuter la commande de manière asynchrone
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
(All)
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-ResourceGroupName
Nom du groupe de ressources.
Le nom ne respecte pas la casse.
Propriétés du paramètre
Type: String
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
(All)
Position: Named
Obligatoire: True
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: 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.
Propriétés du paramètre
Type: ISshPublicKey [ ]
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-SubscriptionId
ID de l’abonnement cible.
La valeur doit être un UUID.
Propriétés du paramètre
Type: String
Valeur par défaut: (Get-AzContext).Subscription.Id
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
(All)
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-Tag
Balises de ressource.
Propriétés du paramètre
Type: Hashtable
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Jeux de paramètres
CreateExpanded
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-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
Type: SwitchParameter
Valeur par défaut: None
Prend en charge les caractères génériques: False
DontShow: False
Alias: Wi
Jeux de paramètres
(All)
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters .
Sorties