Set-AzAksCluster

Module:

Az.Aks

Een beheerd Kubernetes-cluster bijwerken of maken.

Syntax

Set-AzAksCluster
   [-NodePoolMode <String>]
   [-AcrNameToDetach <String>]
   [-NodeImageOnly]
   [-ControlPlaneOnly]
   [-AutoScalerProfile <ManagedClusterPropertiesAutoScalerProfile>]
   [-EnableUptimeSLA]
   [-EnableOidcIssuer]
   [-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>]
   [-WindowsProfileAdminUserPassword <SecureString>]
   [-EnableAHUB]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [-SubscriptionId <String>]
   [<CommonParameters>]

Set-AzAksCluster
   -InputObject <PSKubernetesCluster>
   [-NodePoolMode <String>]
   [-AcrNameToDetach <String>]
   [-NodeImageOnly]
   [-ControlPlaneOnly]
   [-AutoScalerProfile <ManagedClusterPropertiesAutoScalerProfile>]
   [-EnableUptimeSLA]
   [-EnableOidcIssuer]
   [-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>]
   [-WindowsProfileAdminUserPassword <SecureString>]
   [-EnableAHUB]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [-SubscriptionId <String>]
   [<CommonParameters>]

Set-AzAksCluster
   [-NodePoolMode <String>]
   [-AcrNameToDetach <String>]
   [-NodeImageOnly]
   [-ControlPlaneOnly]
   [-Id] <String>
   [-AutoScalerProfile <ManagedClusterPropertiesAutoScalerProfile>]
   [-EnableUptimeSLA]
   [-EnableOidcIssuer]
   [-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>]
   [-WindowsProfileAdminUserPassword <SecureString>]
   [-EnableAHUB]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [-SubscriptionId <String>]
   [<CommonParameters>]

Description

Een beheerd Kubernetes-cluster bijwerken of maken.

Voorbeelden

Voorbeeld 1

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

Stel het aantal knooppunten in het Kubernetes-cluster in op 5.

Een AKS-cluster bijwerken met AutoScalerProfile.

Wanneer u een AKS-cluster bijwerkt, kunt u gedetailleerde details van de automatische schaalaanpassing van clusters configureren door de standaardwaarden in het profiel voor automatische schaalaanpassing voor de hele cluster te wijzigen.

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

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

Een AKS-cluster bijwerken met AadProfile.

Wanneer u een AKS-cluster bijwerkt, kunt u het AAD-profiel configureren.

$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

Parameters

-AadProfile

De Azure Active Directory-configuratie.

Type:	ManagedClusterAADProfile
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AcrNameToAttach

Verdeel de rol 'acrpull' van de opgegeven ACR aan AKS-service-principal, bijvoorbeeld myacr

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AcrNameToDetach

Schakel de roltoewijzing 'acrpull' uit aan de ACR die is opgegeven op naam of resource-id, bijvoorbeeld myacr

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AksCustomHeader

Aangepaste AKS-headers die worden gebruikt voor het bouwen van een Kubernetes-netwerk.

Type:	Hashtable
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApiServerAccessAuthorizedIpRange

De IP-bereiken die zijn geautoriseerd voor toegang tot de Kubernetes-API-server.

Type:	String[]
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApiServerAccessPrivateDnsZone

De privé-DNS-zonemodus voor het cluster.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:	SwitchParameter
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AssignIdentity

ResourceId van de gebruiker wijst beheerde identiteit toe voor het cluster.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AutoScalerProfile

De parameters die moeten worden toegepast op de automatische schaalaanpassing van clusters.

Type:	ManagedClusterPropertiesAutoScalerProfile
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AutoUpgradeChannel

Het upgradekanaal voor automatische upgrade. Ga voor meer informatie naar https://learn.microsoft.com/azure/aks/upgrade-cluster#set-auto-upgrade-channel.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ControlPlaneOnly

Het besturingsvlak wordt alleen bijgewerkt naar de doelversie.

Type:	SwitchParameter
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

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

-DisableLocalAccount

Lokale accounts moeten worden uitgeschakeld op het beheerde cluster.

Type:	SwitchParameter
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DiskEncryptionSetID

De resource-id van de schijfversleutelingsset die moet worden gebruikt voor het inschakelen van versleuteling.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DnsNamePrefix

Het DNS-naamvoorvoegsel voor het cluster.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableAHUB

Of u Azure Hybrid User Benefits (AHUB) wilt inschakelen voor Windows-VM's.

Type:	SwitchParameter
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableApiServerAccessPrivateCluster

Of u het cluster wilt maken als een privécluster of niet.

Type:	SwitchParameter
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableApiServerAccessPrivateClusterPublicFQDN

Of u nu extra openbare FQDN voor een privécluster wilt maken of niet.

Type:	SwitchParameter
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableManagedIdentity

Een beheerde identiteit gebruiken om de clusterresourcegroep te beheren.

Type:	SwitchParameter
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableNodeAutoScaling

Of automatische schaalaanpassing moet worden ingeschakeld

Type:	SwitchParameter
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableOidcIssuer

Of de functie OIDC-verlener moet worden gebruikt.

Type:	SwitchParameter
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableUptimeSLA

Of u de SLA uptime wilt gebruiken.

Type:	SwitchParameter
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FqdnSubdomain

Het FQDN-subdomein van het privécluster met aangepaste privé-DNS-zone.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HttpProxy

Het eindpunt van de HTTP-proxyserver dat moet worden gebruikt.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HttpProxyConfigNoProxyEndpoint

De eindpunten die geen proxy mogen doorlopen.

Type:	String[]
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HttpProxyConfigTrustedCa

Alternatief CA-certificaat dat moet worden gebruikt om verbinding te maken met proxyservers.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HttpsProxy

Het HTTPS-proxyservereindpunt dat moet worden gebruikt

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Id van een beheerd Kubernetes-cluster

Type:	String
Aliases:	ResourceId
Position:	0
standaardwaarde:	None
Vereist:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InputObject

Een PSKubernetesCluster-object, dat normaal gesproken via de pijplijn wordt doorgegeven.

Type:	PSKubernetesCluster
Position:	Named
standaardwaarde:	None
Vereist:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-KubernetesVersion

De versie van Kubernetes die moet worden gebruikt voor het maken van het cluster.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LinuxProfileAdminUserName

Gebruikersnaam voor de virtuele Linux-machines.

Type:	String
Aliases:	AdminUserName
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LoadBalancerAllocatedOutboundPort

Het gewenste aantal toegewezen SNAT-poorten per VM.

Type:	Int32
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LoadBalancerIdleTimeoutInMinute

Gewenste time-out voor inactiviteit van uitgaande stroom in minuten.

Type:	Int32
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LoadBalancerManagedOutboundIpCount

Het aantal beheerde uitgaande IP-adressen voor de load balancer van het cluster.

Type:	Int32
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LoadBalancerOutboundIp

Gewenste uitgaande IP-resources voor de load balancer van het cluster.

Type:	String[]
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LoadBalancerOutboundIpPrefix

Gewenste uitgaande IP-voorvoegselbronnen voor de load balancer van het cluster.

Type:	String[]
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

Azure-locatie voor het cluster. De standaardinstelling is de locatie van de resourcegroep.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Naam van beheerd Kubernetes-cluster.

Type:	String
Position:	1
standaardwaarde:	None
Vereist:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeCount

Het standaardaantal knooppunten voor de knooppuntgroepen.

Type:	Int32
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeImageOnly

Werkt alleen de knooppuntinstallatiekopieën van agentpools bij.

Type:	SwitchParameter
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeMaxCount

Maximum aantal knooppunten voor automatisch schalen

Type:	Int32
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeMinCount

Minimaal aantal knooppunten voor automatisch schalen.

Type:	Int32
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeName

Unieke naam van het profiel van de agentgroep in de context van het abonnement en de resourcegroep.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeOsDiskSize

Hiermee geeft u de grootte, in GB, van de besturingssysteemschijf.

Type:	Int32
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NodePoolLabel

Labels voor knooppuntgroepen die worden gebruikt voor het bouwen van een Kubernetes-netwerk.

Type:	Hashtable
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NodePoolMode

NodePoolMode vertegenwoordigt de modus van een knooppuntgroep.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NodePoolTag

De tags die moeten worden bewaard in de virtuele-machineschaalset van de agentgroep.

Type:	Hashtable
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NodeVmSize

De grootte van de virtuele machine.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Naam resourcegroep.

Type:	String
Position:	0
standaardwaarde:	None
Vereist:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ServicePrincipalIdAndSecret

De client-id en het clientgeheim die zijn gekoppeld aan de AAD-toepassing/service-principal.

Type:	PSCredential
Position:	2
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SshKeyValue

SSH-sleutelbestandswaarde of sleutelbestandspad. De standaardinstelling is {HOME}/.ssh/id_rsa.pub.

Type:	String
Aliases:	SshKeyPath
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

De id van het abonnement. Cmdlets worden standaard uitgevoerd in het abonnement dat is ingesteld in de huidige context. Als de gebruiker een ander abonnement opgeeft, wordt de huidige cmdlet uitgevoerd in het abonnement dat door de gebruiker is opgegeven. Het overschrijven van abonnementen wordt alleen van kracht tijdens de levenscyclus van de huidige cmdlet. Het abonnement wordt niet gewijzigd in de context en heeft geen invloed op volgende cmdlets.

Type:	String
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

Tags die moeten worden toegepast op de resource

Type:	Hashtable
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WindowsProfileAdminUserPassword

Het beheerderswachtwoord dat moet worden gebruikt voor Windows-VM's. Wachtwoordvereiste:ten minste één kleine letter, één hoofdletter, één speciaal teken !@#$%^&*(), de minimale lengte is 12.

Type:	SecureString
Position:	Named
standaardwaarde:	None
Vereist:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Invoerwaarden

PSKubernetesCluster

String

Uitvoerwaarden

PSKubernetesCluster