Delen via


New-AzNetworkCloudKubernetesCluster

Maak een nieuw Kubernetes-cluster of werk de eigenschappen van de bestaande bij.

Syntaxis

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[]>]
   [-L2ServiceLoadBalancerConfigurationIPAddressPool <IIPAddressPool[]>]
   [-ManagedResourceGroupConfigurationLocation <String>]
   [-ManagedResourceGroupConfigurationName <String>]
   [-NetworkConfigurationDnsServiceIP <String>]
   [-NetworkConfigurationPodCidr <String[]>]
   [-NetworkConfigurationServiceCidr <String[]>]
   [-SshPublicKey <ISshPublicKey[]>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Maak een nieuw Kubernetes-cluster of werk de eigenschappen van de bestaande bij.

Voorbeelden

Voorbeeld 1: Kubernetes-cluster maken

$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

Met deze opdracht maakt u een Kubernetes-cluster.

Parameters

-AadConfigurationAdminGroupObjectId

De lijst met azure Active Directory-groepsobject-id's die een beheerdersrol hebben in het Kubernetes-cluster.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AdminUsername

De gebruikersnaam voor de beheerder die wordt toegepast op de besturingssystemen waarop Kubernetes-knooppunten worden uitgevoerd. Indien niet opgegeven, wordt een gebruikersnaam gekozen door de service.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AsJob

De opdracht uitvoeren als een taak

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AttachedNetworkConfigurationL2Network

De lijst met Laag 2-netwerken en gerelateerde configuratie voor bijlage. Zie de sectie NOTES voor ATTACHEDNETWORKCONFIGURATIONL2NETWORK eigenschappen en maak een hash-tabel om deze samen te stellen.

Type:IL2NetworkAttachmentConfiguration[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AttachedNetworkConfigurationL3Network

De lijst met Laag 3-netwerken en gerelateerde configuratie voor bijlage. Zie de sectie NOTES voor ATTACHEDNETWORKCONFIGURATIONL3NETWORK eigenschappen en maak een hash-tabel om deze samen te stellen.

Type:IL3NetworkAttachmentConfiguration[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AttachedNetworkConfigurationTrunkedNetwork

De lijst met Trunked Networks en gerelateerde configuratie voor bijlage. Zie de sectie NOTES voor DE EIGENSCHAPPEN ATTACHEDNETWORKCONFIGURATIONTRUNKEDNETWORK en maak een hash-tabel om deze samen te stellen.

Type:ITrunkedNetworkAttachmentConfiguration[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BgpAdvertisement

De koppeling van IP-adresgroepen aan de community's en peers, waardoor ip-adressen kunnen worden aangekondigd. Zie de sectie NOTES voor BGPADVERTISEMENT-eigenschappen en maak een hash-tabel om deze samen te stellen.

Type:IBgpAdvertisement[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BgpIPAddressPool

De lijst met groepen IP-adressen die kunnen worden toegewezen aan load balancer-services. Zie de sectie NOTES voor BGPIPADDRESSPOOL-eigenschappen en maak een hash-tabel om deze samen te stellen.

Type:IIPAddressPool[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BgpPeer

De lijst met aanvullende BgpPeer-entiteiten waarmee het Kubernetes-cluster wordt gekoppeld. Alle peering moet expliciet worden gedefinieerd. Zie de sectie NOTES voor BGPPEER-eigenschappen en maak een hash-tabel om deze samen te stellen.

Type:IServiceLoadBalancerBgpPeer[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled

De indicator die moet worden opgegeven als de load balancer peert met de netwerkinfrastructuur.

Type:FabricPeeringEnabled
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ControlPlaneNodeConfigurationAdminPublicKey

De SSH-configuratie voor de besturingssystemen waarop de knooppunten in het Kubernetes-cluster worden uitgevoerd. In sommige gevallen kan specificatie van openbare sleutels vereist zijn om een werkomgeving te produceren. Zie de sectie NOTES voor DE EIGENSCHAPPEN CONTROLPLANENODECONFIGURATIONADMINPUBLICKEY en maak een hash-tabel om deze samen te stellen.

Type:ISshPublicKey[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ControlPlaneNodeConfigurationAdminUsername

De gebruikersnaam voor de beheerder die wordt toegepast op de besturingssystemen waarop Kubernetes-knooppunten worden uitgevoerd. Indien niet opgegeven, wordt een gebruikersnaam gekozen door de service.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ControlPlaneNodeConfigurationAvailabilityZone

De lijst met beschikbaarheidszones van het netwerkcloudcluster dat moet worden gebruikt voor het inrichten van knooppunten in het besturingsvlak. Als dit niet is opgegeven, worden alle beschikbaarheidszones gebruikt.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ControlPlaneNodeConfigurationCount

Het aantal virtuele machines dat deze configuratie gebruikt.

Type:Int64
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ControlPlaneNodeConfigurationVMSkuName

De naam van de VM-SKU die tijdens het maken is opgegeven.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De parameter DefaultProfile is niet functioneel. Gebruik de parameter SubscriptionId indien beschikbaar als u de cmdlet uitvoert voor een ander abonnement.

Type:PSObject
Aliassen:AzureRMContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ExtendedLocationName

De resource-id van de uitgebreide locatie waarop de resource wordt gemaakt.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ExtendedLocationType

Het uitgebreide locatietype, bijvoorbeeld CustomLocation.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InitialAgentPoolConfiguration

De agentgroepen die zijn gemaakt met dit Kubernetes-cluster voor het uitvoeren van kritieke systeemservices en workloads. Deze gegevens in dit veld worden alleen gebruikt tijdens het maken en het veld is leeg na het maken van het Kubernetes-cluster. Na het maken wordt het beheer van agentpools uitgevoerd met behulp van de subresource agentPools. Zie de sectie NOTES voor INITIALAGENTPOOLCONFIGURATION-eigenschappen en maak een hash-tabel om deze samen te stellen.

Type:IInitialAgentPoolConfiguration[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-KubernetesClusterName

De naam van het Kubernetes-cluster.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-KubernetesVersion

De Kubernetes-versie voor dit cluster.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-L2ServiceLoadBalancerConfigurationIPAddressPool

De lijst met groepen IP-adressen die kunnen worden toegewezen aan load balancer-services. Zie de sectie NOTES voor L2SERVICELOADBALANCERCONFIGURATIONIPADDRESSPOOL eigenschappen en maak een hash-tabel om deze samen te stellen.

Type:IIPAddressPool[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Location

De geografische locatie waar de resource zich bevindt

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ManagedResourceGroupConfigurationLocation

De locatie van de beheerde resourcegroep. Als dit niet is opgegeven, wordt de locatie van de bovenliggende resource gekozen.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ManagedResourceGroupConfigurationName

De naam voor de beheerde resourcegroep. Als dit niet is opgegeven, wordt de unieke naam automatisch gegenereerd.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NetworkConfigurationCloudServicesNetworkId

De resource-id van het gekoppelde Cloud Services-netwerk.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NetworkConfigurationCniNetworkId

De resource-id van het Laag 3-netwerk dat wordt gebruikt voor het maken van het netwerk containernetwerken.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NetworkConfigurationDnsServiceIP

Het IP-adres dat is toegewezen aan de Kubernetes DNS-service. Deze moet zich binnen het Kubernetes-serviceadresbereik bevinden dat is opgegeven in service-CIDR.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NetworkConfigurationPodCidr

Het IP-adres van de CIDR-notatie varieert van waaruit pod-IP-adressen moeten worden toegewezen. Er wordt één IPv4-CIDR verwacht voor netwerken met één stack. Twee CIDR's, één voor elke IP-familie (IPv4/IPv6), wordt verwacht voor dual-stack-netwerken.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NetworkConfigurationServiceCidr

Het IP-adres van de CIDR-notatie varieert van waaruit service-IP-adressen moeten worden toegewezen. Er wordt één IPv4-CIDR verwacht voor netwerken met één stack. Twee CIDR's, één voor elke IP-familie (IPv4/IPv6), wordt verwacht voor dual-stack-netwerken.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NoWait

De opdracht asynchroon uitvoeren

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SshPublicKey

De SSH-configuratie voor de besturingssystemen waarop de knooppunten in het Kubernetes-cluster worden uitgevoerd. In sommige gevallen kan specificatie van openbare sleutels vereist zijn om een werkomgeving te produceren. Zie de sectie NOTES voor SSHPUBLICKEY-eigenschappen en maak een hash-tabel om deze samen te stellen.

Type:ISshPublicKey[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SubscriptionId

De id van het doelabonnement. De waarde moet een UUID zijn.

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Tag

Resourcetags.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

IKubernetesCluster