New-AzNetworkCloudKubernetesCluster

Referenz

Modul:: Az.NetworkCloud

Erstellen Sie einen neuen Kubernetes-Cluster, oder aktualisieren Sie die Eigenschaften des vorhandenen Clusters.

Syntax

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

Beschreibung

Erstellen Sie einen neuen Kubernetes-Cluster, oder aktualisieren Sie die Eigenschaften des vorhandenen Clusters.

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

Mit diesem Befehl wird ein Kubernetes-Cluster erstellt.

Parameter

-AadConfigurationAdminGroupObjectId

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

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

Ausführen des Befehls als Auftrag

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AttachedNetworkConfigurationL2Network

Die Liste der Layer 2-Netzwerke und die zugehörige Konfiguration für Anlagen. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für ATTACHEDNETWORKCONFIGURATIONL2NETWORK Eigenschaften und erstellen eine Hashtabelle.

Typ:	IL2NetworkAttachmentConfiguration[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AttachedNetworkConfigurationL3Network

Die Liste der Layer 3-Netzwerke und die zugehörige Konfiguration für Anlagen. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für ATTACHEDNETWORKCONFIGURATIONL3NETWORK Eigenschaften und Erstellen einer Hashtabelle.

Typ:	IL3NetworkAttachmentConfiguration[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AttachedNetworkConfigurationTrunkedNetwork

Die Liste der Trunked Networks und die zugehörige Konfiguration für Anlagen. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für ATTACHEDNETWORKCONFIGURATIONTRUNKEDNETWORK-Eigenschaften und erstellen eine Hashtabelle.

Typ:	ITrunkedNetworkAttachmentConfiguration[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BgpAdvertisement

Die Zuordnung von IP-Adresspools an die Communitys und Peers, was eine Ankündigung von IP-Adressen ermöglicht. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für BGPADVERTISEMENT-Eigenschaften und erstellen eine Hashtabelle.

Typ:	IBgpAdvertisement[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BgpIPAddressPool

Die Liste der Pools von IP-Adressen, die den Lastenausgleichsdiensten zugeordnet werden können. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für BGPIPADDRESSPOOL-Eigenschaften und erstellen eine Hashtabelle.

Typ:	IIPAddressPool[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BgpPeer

Die Liste der zusätzlichen BgpPeer-Entitäten, mit denen der Kubernetes-Cluster peert. Alle Peerings müssen explizit definiert werden. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für BGPPEER-Eigenschaften und erstellen eine Hashtabelle.

Typ:	IServiceLoadBalancerBgpPeer[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled

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

Typ:	FabricPeeringEnabled
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:	SwitchParameter
Aliases:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-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. Informationen zum Erstellen finden Sie im ABSCHNITT "NOTES" für CONTROLPLANENODECONFIGURATIONADMINPUBLICKEY-Eigenschaften und erstellen eine Hashtabelle.

Typ:	ISshPublicKey[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ControlPlaneNodeConfigurationCount

Die Anzahl der virtuellen Computer, die diese Konfiguration verwenden.

Typ:	Int64
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ControlPlaneNodeConfigurationVMSkuName

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

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

Typ:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExtendedLocationName

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ExtendedLocationType

Der erweiterte Standorttyp, z. B. CustomLocation.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-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. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für INITIALAGENTPOOLCONFIGURATION-Eigenschaften und erstellen eine Hashtabelle.

Typ:	IInitialAgentPoolConfiguration[]
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-KubernetesClusterName

Der Name des Kubernetes-Clusters

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-KubernetesVersion

Die Kubernetes-Version für diesen Cluster. Akzeptiert das Format n.n, n.n.n und n.n.n-n. Die verwendete interpretierte Version wird nach der Erstellung oder Aktualisierung in dieses Feld aufgelöst.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

Der geografische Standort, an dem sich die Ressource befindet

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagedResourceGroupConfigurationLocation

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagedResourceGroupConfigurationName

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NetworkConfigurationCloudServicesNetworkId

Die Ressourcen-ID des zugeordneten Cloud Services-Netzwerks.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NetworkConfigurationCniNetworkId

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

Asynchrones Ausführen des Befehls

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-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. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für SSHPUBLICKEY-Eigenschaften und erstellen eine Hashtabelle.

Typ:	ISshPublicKey[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.

Typ:	String
Position:	Named
Standardwert:	(Get-AzContext).Subscription.Id
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Ressourcentags.

Typ:	Hashtable
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Typ:	SwitchParameter
Aliases:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Ausgaben

IKubernetesCluster

Freigeben über