New-AzNetworkCloudKubernetesCluster

Syntax

CreateExpanded (Standard)

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>]

Beschreibung

Beispiele

Beispiel 1: Erstellen eines Kubernetes-Clusters

$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

Parameter

-AadConfigurationAdminGroupObjectId

Die Liste der Azure Active Directory-Gruppenobjekt-IDs, die über eine administrative Rolle im Kubernetes-Cluster verfügen.

Parametereigenschaften

Parametersätze

-AdminUsername

Der Benutzername für den Administrator, der auf die Betriebssysteme angewendet wird, die Kubernetes-Knoten ausführen. Wenn nicht angegeben, wird ein Benutzername vom Dienst ausgewählt.

Parametereigenschaften

Parametersätze

-AsJob

Ausführen des Befehls als Auftrag

Parametereigenschaften

Parametersätze

-AttachedNetworkConfigurationL2Network

Die Liste der Layer 2-Netzwerke und die zugehörige Konfiguration für Anlagen.

Parametereigenschaften

Parametersätze

-AttachedNetworkConfigurationL3Network

Die Liste der Layer 3-Netzwerke und die zugehörige Konfiguration für Anlagen.

Parametereigenschaften

Parametersätze

-AttachedNetworkConfigurationTrunkedNetwork

Die Liste der Trunked Networks und die zugehörige Konfiguration für Anlagen.

Parametereigenschaften

Parametersätze

-BgpAdvertisement

Die Zuordnung von IP-Adresspools an die Communitys und Peers, was eine Ankündigung von IP-Adressen ermöglicht.

Parametereigenschaften

Parametersätze

-BgpIPAddressPool

Die Liste der Pools von IP-Adressen, die den Lastenausgleichsdiensten zugeordnet werden können.

Parametereigenschaften

Parametersätze

-BgpPeer

Die Liste der zusätzlichen BgpPeer-Entitäten, mit denen der Kubernetes-Cluster peert. Alle Peerings müssen explizit definiert werden.

Parametereigenschaften

Parametersätze

-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled

Der Indikator, der angibt, ob der Lastenausgleich peers mit der Netzwerk fabric.

Parametereigenschaften

Parametersätze

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Parametersätze

-ControlPlaneNodeConfigurationAdminPublicKey

Die SSH-Konfiguration für die Betriebssysteme, die die Knoten im Kubernetes-Cluster ausführen. In einigen Fällen ist möglicherweise eine Spezifikation öffentlicher Schlüssel erforderlich, um eine Arbeitsumgebung zu erzeugen.

Parametereigenschaften

Parametersätze

-ControlPlaneNodeConfigurationAdminUsername

Der Benutzername für den Administrator, der auf die Betriebssysteme angewendet wird, die Kubernetes-Knoten ausführen. Wenn nicht angegeben, wird ein Benutzername vom Dienst ausgewählt.

Parametereigenschaften

Parametersätze

-ControlPlaneNodeConfigurationAvailabilityZone

Die Liste der Verfügbarkeitszonen des Netzwerkcloudclusters, die für die Bereitstellung von Knoten in der Steuerungsebene verwendet werden sollen. Wenn nicht angegeben, werden alle Verfügbarkeitszonen verwendet.

Parametereigenschaften

Parametersätze

-ControlPlaneNodeConfigurationCount

Die Anzahl der virtuellen Computer, die diese Konfiguration verwenden.

Parametereigenschaften

Parametersätze

-ControlPlaneNodeConfigurationVMSkuName

Der Name der VM-SKU, die während der Erstellung bereitgestellt wird.

Parametereigenschaften

Parametersätze

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Parametereigenschaften

Parametersätze

-ExtendedLocationName

Die Ressourcen-ID des erweiterten Speicherorts, an dem die Ressource erstellt wird.

Parametereigenschaften

Parametersätze

-ExtendedLocationType

Der erweiterte Standorttyp, z. B. CustomLocation.

Parametereigenschaften

Parametersätze

-IfMatch

Das ETag der Transformation. Lassen Sie diesen Wert aus, um die aktuelle Ressource immer zu überschreiben. Geben Sie den zuletzt gesehenen ETag-Wert an, um zu verhindern, dass gleichzeitige Änderungen versehentlich überschrieben werden.

Parametereigenschaften

Parametersätze

-IfNoneMatch

Legen Sie auf '*' fest, damit ein neuer Datensatzsatz erstellt werden kann, aber um zu verhindern, dass eine vorhandene Ressource aktualisiert wird. Andere Werte führen zu Einem Fehler vom Server, da sie nicht unterstützt werden.

Parametereigenschaften

Parametersätze

-InitialAgentPoolConfiguration

Die Agentpools, die mit diesem Kubernetes-Cluster für die Ausführung kritischer Systemdienste und -workloads erstellt werden. Diese Daten in diesem Feld werden nur während der Erstellung verwendet, und das Feld wird nach der Erstellung des Kubernetes-Clusters leer sein. Nach der Erstellung erfolgt die Verwaltung von Agentpools mithilfe der agentPools-Unterressource.

Parametereigenschaften

Parametersätze

-JsonFilePath

Pfad der JSON-Datei, die für den Erstellungsvorgang bereitgestellt wird

Parametereigenschaften

Parametersätze

-JsonString

Json-Zeichenfolge, die für den Create-Vorgang bereitgestellt wird

Parametereigenschaften

Parametersätze

-KubernetesVersion

Die Kubernetes-Version für diesen Cluster.

Parametereigenschaften

Parametersätze

-L2ServiceLoadBalancerConfigurationIPAddressPool

Die Liste der Pools von IP-Adressen, die den Lastenausgleichsdiensten zugeordnet werden können.

Parametereigenschaften

Parametersätze

-Location

Der geografische Standort, an dem sich die Ressource befindet

Parametereigenschaften

Parametersätze

-ManagedResourceGroupConfigurationLocation

Der Speicherort der verwalteten Ressourcengruppe. Wenn nicht angegeben, wird der Speicherort der übergeordneten Ressource ausgewählt.

Parametereigenschaften

Parametersätze

-ManagedResourceGroupConfigurationName

Der Name für die verwaltete Ressourcengruppe. Wenn nicht angegeben, wird der eindeutige Name automatisch generiert.

Parametereigenschaften

Parametersätze

-Name

Der Name des Kubernetes-Clusters

Parametereigenschaften

Parametersätze

-NetworkConfigurationCloudServicesNetworkId

Die Ressourcen-ID des zugeordneten Cloud Services-Netzwerks.

Parametereigenschaften

Parametersätze

-NetworkConfigurationCniNetworkId

Die Ressourcen-ID des Layer 3-Netzwerks, das zum Erstellen des Containernetzwerknetzwerks verwendet wird.

Parametereigenschaften

Parametersätze

-NetworkConfigurationDnsServiceIP

Die IP-Adresse, die dem Kubernetes-DNS-Dienst zugewiesen ist. Er muss sich innerhalb des kubernetes-Dienstadressbereichs befinden, der im Dienst-CIDR angegeben ist.

Parametereigenschaften

Parametersätze

-NetworkConfigurationPodCidr

Die CIDR-Notations-IP reicht aus, aus denen Pod-IPs zugewiesen werden sollen. Ein IPv4 CIDR wird für Einstapelnetzwerke erwartet. Zwei CIDRs, eine für jede IP-Familie (IPv4/IPv6), wird für Dual-Stack-Netzwerke erwartet.

Parametereigenschaften

Parametersätze

-NetworkConfigurationServiceCidr

Die CIDR-Notations-IP reicht aus, aus denen Dienst-IPs zugewiesen werden sollen. Ein IPv4 CIDR wird für Einstapelnetzwerke erwartet. Zwei CIDRs, eine für jede IP-Familie (IPv4/IPv6), wird für Dual-Stack-Netzwerke erwartet.

Parametereigenschaften

Parametersätze

-NoWait

Asynchrones Ausführen des Befehls

Parametereigenschaften

Parametersätze

-ResourceGroupName

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

Parametereigenschaften

Parametersätze

-SshPublicKey

Die SSH-Konfiguration für die Betriebssysteme, die die Knoten im Kubernetes-Cluster ausführen. In einigen Fällen ist möglicherweise eine Spezifikation öffentlicher Schlüssel erforderlich, um eine Arbeitsumgebung zu erzeugen.

Parametereigenschaften

Parametersätze

-SubscriptionId

Die ID des Zielabonnements. Der Wert muss eine UUID sein.

Parametereigenschaften

Parametersätze

-Tag

Ressourcentags.

Parametereigenschaften

Parametersätze

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Parametersätze

CommonParameters

Ausgaben

IKubernetesCluster