Freigeben über

New-AzAksArcCluster

  • Referenz
Modul:
Az.AksArc

Erstellen der bereitgestellten Clusterinstanz

Syntax

New-AzAksArcCluster
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   [-MinCount <Int32>]
   [-MaxCount <Int32>]
   [-MaxPod <Int32>]
   -CustomLocationName <String>
   -VnetId <String>
   [-ControlPlaneIP <String>]
   [-Location <String>]
   [-AdminGroupObjectID <String[]>]
   [-SshAuthIp <String>]
   [-ControlPlaneCount <Int32>]
   [-ControlPlaneVMSize <String>]
   [-KubernetesVersion <String>]
   [-EnableAzureHybridBenefit]
   [-EnableAzureRbac]
   [-LoadBalancerCount <Int32>]
   [-PodCidr <String>]
   [-NfCsiDriverEnabled]
   [-SmbCsiDriverEnabled]
   [-SshKeyValue <String>]
   [-EnableAutoScaling]
   [-NodeLabel <Hashtable>]
   [-NodeTaint <String[]>]
   [-AutoScalerProfileBalanceSimilarNodeGroup <String>]
   [-AutoScalerProfileExpander <String>]
   [-AutoScalerProfileMaxEmptyBulkDelete <String>]
   [-AutoScalerProfileMaxGracefulTerminationSec <String>]
   [-AutoScalerProfileMaxNodeProvisionTime <String>]
   [-AutoScalerProfileMaxTotalUnreadyPercentage <String>]
   [-AutoScalerProfileNewPodScaleUpDelay <String>]
   [-AutoScalerProfileOkTotalUnreadyCount <String>]
   [-AutoScalerProfileScaleDownDelayAfterAdd <String>]
   [-AutoScalerProfileScaleDownDelayAfterDelete <String>]
   [-AutoScalerProfileScaleDownDelayAfterFailure <String>]
   [-AutoScalerProfileScaleDownUnneededTime <String>]
   [-AutoScalerProfileScaleDownUnreadyTime <String>]
   [-AutoScalerProfileScaleDownUtilizationThreshold <String>]
   [-AutoScalerProfileScanInterval <String>]
   [-AutoScalerProfileSkipNodesWithLocalStorage <String>]
   [-AutoScalerProfileSkipNodesWithSystemPod <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzAksArcCluster
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -MinCount <Int32>
   -MaxCount <Int32>
   -MaxPod <Int32>
   -CustomLocationName <String>
   -VnetId <String>
   [-ControlPlaneIP <String>]
   [-Location <String>]
   [-AdminGroupObjectID <String[]>]
   [-EnableAzureHybridBenefit]
   [-EnableAzureRbac]
   [-EnableAutoScaling]
   [-NodeLabel <Hashtable>]
   [-NodeTaint <String[]>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzAksArcCluster
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -CustomLocationName <String>
   -VnetId <String>
   [-ControlPlaneIP <String>]
   [-Location <String>]
   [-AdminGroupObjectID <String[]>]
   [-EnableAzureHybridBenefit]
   [-EnableAzureRbac]
   [-NodeLabel <Hashtable>]
   [-NodeTaint <String[]>]
   -JsonFilePath <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzAksArcCluster
   -ClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -CustomLocationName <String>
   -VnetId <String>
   [-ControlPlaneIP <String>]
   [-Location <String>]
   [-AdminGroupObjectID <String[]>]
   [-EnableAzureHybridBenefit]
   [-EnableAzureRbac]
   [-NodeLabel <Hashtable>]
   [-NodeTaint <String[]>]
   -JsonString <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Erstellen der bereitgestellten Clusterinstanz

Beispiele

Beispiel 1: Skalierung der Steuerungsebenenanzahl

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -ControlPlaneCount 3

Erhöhen Sie die Anzahl der Steuerebenen auf 3 Knoten.

Beispiel 2: Aktivieren der automatischen Skalierung

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -EnableAutoScaling -MinCount 1 -MaxCount 5

Aktivieren Sie die automatische Skalierung im bereitgestellten Cluster.

Beispiel 3: Aktivieren von NfCsiDriver

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -NfCsiDriverEnabled

Aktivieren Sie den NfCsi-Treiber im bereitgestellten Cluster.

Beispiel 4: Aktivieren von SmbCsiDriver

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -SmbCsiDriverEnabled

Aktivieren Sie den SmbCsi-Treiber im bereitgestellten Cluster.

Beispiel 5: Aktivieren des Azure-Hybridvorteils

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -EnableAzureHybridBenefit

Aktivieren Sie das Feature "Vorteile von Hybridbenutzern" für einen bereitgestellten Cluster.

Beispiel 6: Deaktivieren des Azure-Hybridvorteils

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -EnableAzureHybridBenefit:$false

Deaktivieren Sie das Feature "Azure Hybrid-Benutzervorteile" für einen bereitgestellten Cluster.

Beispiel 7: Deaktivieren der automatischen Skalierung

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -EnableAutoScaling:$false

Deaktivieren Sie die automatische Skalierung im bereitgestellten Cluster.

Beispiel 8: NfCsiDriver deaktivieren

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -NfCsiDriverEnabled:$false

Deaktivieren Sie den NfCsi-Treiber im bereitgestellten Cluster.

Beispiel 9: Deaktivieren von SmbCsiDriver

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -SmbCsiDriverEnabled:$false

Deaktivieren Sie den SmbCsi-Treiber im bereitgestellten Cluster.

Beispiel 10: Neue Aad-Administrator-GUIDS

New-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -AdminGroupObjectID @("2e00cb64-66d8-4c9c-92d8-6462caf99e33", "1b28ff4f-f7c5-4aaa-aa79-ba8b775ab443")

Neue Aad-Administrator-GUIDS.

Parameter

-AdminGroupObjectID

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AsJob

Ausführen des Befehls als Auftrag

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AutoScalerProfileBalanceSimilarNodeGroup

Gültige Werte sind "true" und "false"

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AutoScalerProfileExpander

Wenn nicht angegeben, lautet der Standardwert "random". Weitere Informationen finden Sie unter Erweiterung.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AutoScalerProfileMaxEmptyBulkDelete

Der Standardwert ist 10.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AutoScalerProfileMaxGracefulTerminationSec

Der Standardwert ist 600.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AutoScalerProfileMaxNodeProvisionTime

Der Standardwert ist "15m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AutoScalerProfileMaxTotalUnreadyPercentage

Der Standardwert ist 45. Das Maximum beträgt 100 und das Minimum ist 0.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AutoScalerProfileNewPodScaleUpDelay

Für Szenarien wie Platz-/Batchmaßstab, in denen die Zertifizierungsstelle nicht reagieren soll, bevor der Kubernetes-Scheduler alle Pods planen kann, können Sie der Zertifizierungsstelle mitteilen, dass ungeplante Pods ignoriert werden, bevor sie ein bestimmtes Alter sind. Der Standardwert ist "0s". Werte müssen eine ganze Zahl sein, gefolgt von einer Einheit ('s' für Sekunden, 'm' für Minuten, 'h' für Stunden usw.).

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AutoScalerProfileOkTotalUnreadyCount

Dies muss eine ganze Zahl sein. Der Standardwert ist 3.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AutoScalerProfileScaleDownDelayAfterAdd

Der Standardwert ist "10m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AutoScalerProfileScaleDownDelayAfterDelete

Der Standardwert ist das Scanintervall. Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AutoScalerProfileScaleDownDelayAfterFailure

Der Standardwert ist "3m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AutoScalerProfileScaleDownUnneededTime

Der Standardwert ist "10m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AutoScalerProfileScaleDownUnreadyTime

Der Standardwert ist "20m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AutoScalerProfileScaleDownUtilizationThreshold

Der Standardwert ist "0.5".

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AutoScalerProfileScanInterval

Der Standardwert ist "10". Werte müssen eine ganze Zahl von Sekunden sein.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AutoScalerProfileSkipNodesWithLocalStorage

Der Standardwert ist "true".

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AutoScalerProfileSkipNodesWithSystemPod

Der Standardwert ist "true".

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ClusterName

Der Name des Kubernetes-Clusters, auf dem get aufgerufen wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ControlPlaneCount

Anzahl der Steuerebenenknoten. Der Standardwert ist 1, und die Anzahl sollte eine ungerade Zahl sein.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ControlPlaneIP

IP-Adresse des Kubernetes-API-Servers

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ControlPlaneVMSize

VM-SKU-Größe der Steuerebenenknoten

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CustomLocationName

ARM-ID des erweiterten Speicherorts.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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
Aliase:AzureRMContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableAutoScaling

Gibt an, ob NFS CSI-Treiber aktiviert werden soll. Der Standardwert ist true.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableAzureHybridBenefit

Gibt an, ob der Azure-Hybridvorteil aktiviert ist. Standardwert ist "false".

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableAzureRbac

Gibt an, ob azure rbac aktiviert ist. Standardwert ist "false".

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JsonFilePath

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JsonString

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-KubernetesVersion

Die Version von Kubernetes, die vom bereitgestellten Cluster verwendet wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LoadBalancerCount

Anzahl der VMs des HA-Proxylastenausgleichs. Der Standardwert ist 0.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Location

Ort

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaxCount

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaxPod

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MinCount

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NfCsiDriverEnabled

Gibt an, ob NFS CSI-Treiber aktiviert werden soll. Der Standardwert ist true.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NodeLabel

Die Knotenbeschriftungen, die über alle Knoten im Agentpool hinweg beibehalten werden sollen.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NodeTaint

Zu neuen Knoten hinzugefügteTaints während der Erstellung und Skalierung des Knotenpools. Beispiel: key=value:NoSchedule.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoWait

Asynchrones Ausführen des Befehls

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PodCidr

Ein CIDR-Notation-IP-Adressbereich, aus dem Pod-IPs zugewiesen werden sollen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SmbCsiDriverEnabled

Gibt an, ob der SMB CSI-Treiber aktiviert werden soll. Der Standardwert ist true.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SshAuthIp

IP-Adresse oder CIDR für SSH-Zugriff auf VMs im bereitgestellten Cluster

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SshKeyValue

Die Liste der öffentlichen SSH-Schlüssel, die für die Authentifizierung mit VMs verwendet werden. Es kann maximal 1 Schlüssel angegeben werden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SubscriptionId

Die ID des Zielabonnements.

Typ:String
Position:Named
Standardwert:(Get-AzContext).Subscription.Id
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VnetId

Liste der ARM-Ressourcen-IDs (maximal 1) für das Infrastrukturnetzwerkobjekt, z. B. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName}

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben