Set-AzAksCluster

Modul:

Az.Aks

Aktualisieren oder erstellen Sie einen verwalteten Kubernetes-Cluster.

Syntax

Set-AzAksCluster
   [-NodePoolMode <String>]
   [-AcrNameToDetach <String>]
   [-NodeImageOnly]
   [-ControlPlaneOnly]
   [-AutoScalerProfile <ManagedClusterPropertiesAutoScalerProfile>]
   [-EnableUptimeSLA]
   [-ResourceGroupName] <String>
   [-Name] <String>
   [[-ServicePrincipalIdAndSecret] <PSCredential>]
   [-Location <String>]
   [-LinuxProfileAdminUserName <String>]
   [-DnsNamePrefix <String>]
   [-KubernetesVersion <String>]
   [-NodeName <String>]
   [-NodeMinCount <Int32>]
   [-NodeMaxCount <Int32>]
   [-EnableNodeAutoScaling]
   [-NodeCount <Int32>]
   [-NodeOsDiskSize <Int32>]
   [-NodeVmSize <String>]
   [-NodePoolLabel <Hashtable>]
   [-NodePoolTag <Hashtable>]
   [-SshKeyValue <String>]
   [-AcrNameToAttach <String>]
   [-AsJob]
   [-Tag <Hashtable>]
   [-LoadBalancerAllocatedOutboundPort <Int32>]
   [-LoadBalancerManagedOutboundIpCount <Int32>]
   [-LoadBalancerOutboundIp <String[]>]
   [-LoadBalancerOutboundIpPrefix <String[]>]
   [-LoadBalancerIdleTimeoutInMinute <Int32>]
   [-ApiServerAccessAuthorizedIpRange <String[]>]
   [-EnableApiServerAccessPrivateCluster]
   [-ApiServerAccessPrivateDnsZone <String>]
   [-EnableApiServerAccessPrivateClusterPublicFQDN]
   [-FqdnSubdomain <String>]
   [-EnableManagedIdentity]
   [-AssignIdentity <String>]
   [-AutoUpgradeChannel <String>]
   [-DiskEncryptionSetID <String>]
   [-DisableLocalAccount]
   [-HttpProxy <String>]
   [-HttpsProxy <String>]
   [-HttpProxyConfigNoProxyEndpoint <String[]>]
   [-HttpProxyConfigTrustedCa <String>]
   [-AksCustomHeader <Hashtable>]
   [-AadProfile <ManagedClusterAADProfile>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [-SubscriptionId <String>]
   [<CommonParameters>]

Set-AzAksCluster
   -InputObject <PSKubernetesCluster>
   [-NodePoolMode <String>]
   [-AcrNameToDetach <String>]
   [-NodeImageOnly]
   [-ControlPlaneOnly]
   [-AutoScalerProfile <ManagedClusterPropertiesAutoScalerProfile>]
   [-EnableUptimeSLA]
   [-Location <String>]
   [-LinuxProfileAdminUserName <String>]
   [-DnsNamePrefix <String>]
   [-KubernetesVersion <String>]
   [-NodeName <String>]
   [-NodeMinCount <Int32>]
   [-NodeMaxCount <Int32>]
   [-EnableNodeAutoScaling]
   [-NodeCount <Int32>]
   [-NodeOsDiskSize <Int32>]
   [-NodeVmSize <String>]
   [-NodePoolLabel <Hashtable>]
   [-NodePoolTag <Hashtable>]
   [-SshKeyValue <String>]
   [-AcrNameToAttach <String>]
   [-AsJob]
   [-Tag <Hashtable>]
   [-LoadBalancerAllocatedOutboundPort <Int32>]
   [-LoadBalancerManagedOutboundIpCount <Int32>]
   [-LoadBalancerOutboundIp <String[]>]
   [-LoadBalancerOutboundIpPrefix <String[]>]
   [-LoadBalancerIdleTimeoutInMinute <Int32>]
   [-ApiServerAccessAuthorizedIpRange <String[]>]
   [-EnableApiServerAccessPrivateCluster]
   [-ApiServerAccessPrivateDnsZone <String>]
   [-EnableApiServerAccessPrivateClusterPublicFQDN]
   [-FqdnSubdomain <String>]
   [-EnableManagedIdentity]
   [-AssignIdentity <String>]
   [-AutoUpgradeChannel <String>]
   [-DiskEncryptionSetID <String>]
   [-DisableLocalAccount]
   [-HttpProxy <String>]
   [-HttpsProxy <String>]
   [-HttpProxyConfigNoProxyEndpoint <String[]>]
   [-HttpProxyConfigTrustedCa <String>]
   [-AksCustomHeader <Hashtable>]
   [-AadProfile <ManagedClusterAADProfile>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [-SubscriptionId <String>]
   [<CommonParameters>]

Set-AzAksCluster
   [-NodePoolMode <String>]
   [-AcrNameToDetach <String>]
   [-NodeImageOnly]
   [-ControlPlaneOnly]
   [-Id] <String>
   [-AutoScalerProfile <ManagedClusterPropertiesAutoScalerProfile>]
   [-EnableUptimeSLA]
   [-Location <String>]
   [-LinuxProfileAdminUserName <String>]
   [-DnsNamePrefix <String>]
   [-KubernetesVersion <String>]
   [-NodeName <String>]
   [-NodeMinCount <Int32>]
   [-NodeMaxCount <Int32>]
   [-EnableNodeAutoScaling]
   [-NodeCount <Int32>]
   [-NodeOsDiskSize <Int32>]
   [-NodeVmSize <String>]
   [-NodePoolLabel <Hashtable>]
   [-NodePoolTag <Hashtable>]
   [-SshKeyValue <String>]
   [-AcrNameToAttach <String>]
   [-AsJob]
   [-Tag <Hashtable>]
   [-LoadBalancerAllocatedOutboundPort <Int32>]
   [-LoadBalancerManagedOutboundIpCount <Int32>]
   [-LoadBalancerOutboundIp <String[]>]
   [-LoadBalancerOutboundIpPrefix <String[]>]
   [-LoadBalancerIdleTimeoutInMinute <Int32>]
   [-ApiServerAccessAuthorizedIpRange <String[]>]
   [-EnableApiServerAccessPrivateCluster]
   [-ApiServerAccessPrivateDnsZone <String>]
   [-EnableApiServerAccessPrivateClusterPublicFQDN]
   [-FqdnSubdomain <String>]
   [-EnableManagedIdentity]
   [-AssignIdentity <String>]
   [-AutoUpgradeChannel <String>]
   [-DiskEncryptionSetID <String>]
   [-DisableLocalAccount]
   [-HttpProxy <String>]
   [-HttpsProxy <String>]
   [-HttpProxyConfigNoProxyEndpoint <String[]>]
   [-HttpProxyConfigTrustedCa <String>]
   [-AksCustomHeader <Hashtable>]
   [-AadProfile <ManagedClusterAADProfile>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [-SubscriptionId <String>]
   [<CommonParameters>]

Beschreibung

Aktualisieren oder erstellen Sie einen verwalteten Kubernetes-Cluster.

Beispiele

Beispiel 1

Get-AzAksCluster -ResourceGroupName group -Name myCluster | Set-AzAksCluster -NodeCount 5

Legen Sie die Anzahl der Knoten im Kubernetes-Cluster auf 5 fest.

Aktualisieren sie einen AKS-Cluster mit AutoScalerProfile.

Wenn Sie einen AKS-Cluster aktualisieren, können Sie präzise Details der automatischen Clusterskalierung konfigurieren, indem Sie die Standardwerte im clusterweiten Autoscaler-Profil ändern.

$AutoScalerProfile=@{
    ScanInterval="40s"
    Expander="priority"
}
$AutoScalerProfile=[Microsoft.Azure.Management.ContainerService.Models.ManagedClusterPropertiesAutoScalerProfile]$AutoScalerProfile

Get-AzAksCluster -ResourceGroupName group -Name myCluster | Set-AzAksCluster -AutoScalerProfile $AutoScalerProfile

Aktualisieren sie einen AKS-Cluster mit AadProfile.

Wenn Sie einen AKS-Cluster aktualisieren, können Sie das AAD-Profil konfigurieren.

$AKSAdminGroup=New-AzADGroup -DisplayName myAKSAdminGroup -MailNickname myAKSAdminGroup
$AadProfile=@{
    managed=$true
    enableAzureRBAC=$false
    adminGroupObjectIDs=[System.Collections.Generic.List[string]]@($AKSAdminGroup.Id)
}
$AadProfile=[Microsoft.Azure.Management.ContainerService.Models.ManagedClusterAADProfile]$AadProfile

Set-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -AadProfile $AadProfile

Parameter

-AadProfile

Die Azure Active Directory-Konfiguration.

Type:	ManagedClusterAADProfile
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AcrNameToAttach

Erteilen Der AKS-Dienstprinzipal die Rolle "acrpull" des angegebenen ACR, z. B. myacr

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AcrNameToDetach

Deaktivieren Sie die Rollenzuweisung "acrpull" für den ACR, der durch Den Namen oder die Ressourcen-ID angegeben wird, z. B. myacr.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AksCustomHeader

Benutzerdefinierte Aks-Header, die zum Erstellen eines Kubernetes-Netzwerks verwendet werden.

Type:	Hashtable
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ApiServerAccessAuthorizedIpRange

Die IP-Bereiche, die für den Zugriff auf den Kubernetes-API-Server autorisiert sind.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ApiServerAccessPrivateDnsZone

Der private DNS-Zonenmodus für den Cluster.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

Ausführen des Cmdlets im Hintergrund

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AssignIdentity

ResourceId des Benutzers, der eine verwaltete Identität für den Cluster zuweist.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AutoScalerProfile

Die Parameter, die auf die automatische Clusterskalierung angewendet werden sollen.

Type:	ManagedClusterPropertiesAutoScalerProfile
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AutoUpgradeChannel

Der Upgradekanal für das automatische Upgrade. Weitere Informationen finden Sie unter https://learn.microsoft.com/azure/aks/upgrade-cluster#set-auto-upgrade-channel.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ControlPlaneOnly

Führt nur ein Upgrade der Steuerungsebene auf die Zielversion durch.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableLocalAccount

Lokale Konten sollten im verwalteten Cluster deaktiviert sein.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DiskEncryptionSetID

Die Ressourcen-ID des Datenträgerverschlüsselungssatzes, der zum Aktivieren der Verschlüsselung verwendet werden soll.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DnsNamePrefix

Das DNS-Namenspräfix für den Cluster.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableApiServerAccessPrivateCluster

Gibt an, ob der Cluster als privater Cluster erstellt werden soll.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableApiServerAccessPrivateClusterPublicFQDN

Gibt an, ob ein zusätzlicher öffentlicher FQDN für einen privaten Cluster erstellt werden soll.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableManagedIdentity

Verwenden einer verwalteten Identität zum Verwalten der Clusterressourcengruppe.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableNodeAutoScaling

Ob die automatische Skalierung aktiviert werden soll

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableUptimeSLA

Gibt an, ob die Betriebszeit-SLA verwendet werden soll.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-FqdnSubdomain

Die FQDN-Unterdomäne des privaten Clusters mit benutzerdefinierter privater DNS-Zone.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-HttpProxy

Der zu verwendende HTTP-Proxyserverendpunkt.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-HttpProxyConfigNoProxyEndpoint

Die Endpunkte, die keinen Proxy durchlaufen sollten.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-HttpProxyConfigTrustedCa

Ein alternatives Zertifizierungsstellenzertifikat, das zum Herstellen einer Verbindung mit Proxyservern verwendet werden soll.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-HttpsProxy

Der zu verwendende HTTPS-Proxyserverendpunkt

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

ID eines verwalteten Kubernetes-Clusters

Type:	String
Aliases:	ResourceId
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-InputObject

Ein PSKubernetesCluster-Objekt, das normalerweise über die Pipeline übergeben wird.

Type:	PSKubernetesCluster
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-KubernetesVersion

Die Version von Kubernetes, die zum Erstellen des Clusters verwendet werden soll.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LinuxProfileAdminUserName

Benutzername für die virtuellen Linux-Computer.

Type:	String
Aliases:	AdminUserName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LoadBalancerAllocatedOutboundPort

Die gewünschte Anzahl zugeordneter SNAT-Ports pro VM.

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LoadBalancerIdleTimeoutInMinute

Leerlauftimeout des gewünschten ausgehenden Flows in Minuten.

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LoadBalancerManagedOutboundIpCount

Anzahl der gewünschten verwalteten ausgehenden IP-Adressen für den Clusterlastenausgleich.

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LoadBalancerOutboundIp

Gewünschte ausgehende IP-Ressourcen für den Clusterlastenausgleich.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LoadBalancerOutboundIpPrefix

Gewünschte ausgehende IP-Präfixressourcen für den Clusterlastenausgleich.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

Azure-Standort für den Cluster. Wird standardmäßig auf den Speicherort der Ressourcengruppe festgelegt.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Name des verwalteten Kubernetes-Clusters.

Type:	String
Position:	1
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeCount

Standardanzahl von Knoten für die Knotenpools.

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeImageOnly

Aktualisiert nur das Knotenimage von Agentpools.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeMaxCount

Maximale Anzahl von Knoten für die automatische Skalierung

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeMinCount

Minimale Anzahl von Knoten für die automatische Skalierung.

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeName

Eindeutiger Name des Agentpoolprofils im Kontext des Abonnements und der Ressourcengruppe.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeOsDiskSize

Gibt die Größe des Betriebssystem-Datenträgers in GB an.

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NodePoolLabel

Knotenpoolbezeichnungen, die zum Erstellen eines Kubernetes-Netzwerks verwendet werden.

Type:	Hashtable
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NodePoolMode

NodePoolMode stellt den Modus eines Knotenpools dar.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NodePoolTag

Die Tags, die in der VM-Skalierungsgruppe des Agentpools beibehalten werden sollen.

Type:	Hashtable
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeVmSize

Größe des virtuellen Computers.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Ressourcengruppenname.

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ServicePrincipalIdAndSecret

Die Client-ID und der geheime Clientschlüssel, die der AAD-Anwendung bzw. dem Dienstprinzipal zugeordnet sind.

Type:	PSCredential
Position:	2
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SshKeyValue

SSH-Schlüsseldateiwert oder -Schlüsseldateipfad. Der Standardwert ist {HOME}/.ssh/id_rsa.pub.

Type:	String
Aliases:	SshKeyPath
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

Die ID des Abonnements. Cmdlets werden standardmäßig in dem Abonnement ausgeführt, das im aktuellen Kontext festgelegt ist. Wenn der Benutzer ein anderes Abonnement angibt, wird das aktuelle Cmdlet in dem vom Benutzer angegebenen Abonnement ausgeführt. Überschreiben von Abonnements werden nur während des Lebenszyklus des aktuellen Cmdlets wirksam. Das Abonnement wird im Kontext nicht geändert und wirkt sich nicht auf nachfolgende Cmdlets aus.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

Tags, die auf die Ressource angewendet werden sollen

Type:	Hashtable
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

PSKubernetesCluster

String

Ausgaben

PSKubernetesCluster