Set-AzAksCluster

Обновите или создайте управляемый кластер Kubernetes.

Синтаксис

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

Описание

Обновите или создайте управляемый кластер Kubernetes.

Примеры

Пример 1

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

Задайте для кластера Kubernetes число узлов 5.

Обновите кластер AKS с помощью AutoScalerProfile.

При обновлении кластера AKS можно настроить детализированные сведения об автомасштабировании кластера, изменив значения по умолчанию в профиле автомасштабирования на уровне кластера.

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

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

Обновите кластер AKS с помощью AadProfile.

При обновлении кластера AKS можно настроить профиль AAD.

$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

Параметры

-AadProfile

Конфигурация Azure Active Directory.

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

-AcrNameToAttach

Предоставьте роль acrpull указанного ACR субъекту-службе AKS, например myacr

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

-AcrNameToDetach

Отключите назначение роли acrpull для ACR, указанного по имени или идентификатору ресурса, например myacr

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

-AksCustomHeader

Пользовательские заголовки Aks, используемые для создания сети Kubernetes.

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

-ApiServerAccessAuthorizedIpRange

Диапазоны IP-адресов, авторизованные для доступа к серверу API Kubernetes.

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

-ApiServerAccessPrivateDnsZone

Режим частной зоны DNS для кластера.

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

-AsJob

Запуск командлета в фоновом режиме

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

-AssignIdentity

ResourceId пользователя назначает управляемое удостоверение для кластера.

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

-AutoScalerProfile

Параметры, применяемые к кластеру автомасштабирования.

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

-AutoUpgradeChannel

Канал обновления для автоматического обновления. Дополнительные сведения см. по адресу https://learn.microsoft.com/azure/aks/upgrade-cluster#set-auto-upgrade-channel.

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

-Confirm

Запрос подтверждения перед выполнением командлета.

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

-ControlPlaneOnly

Будет обновляться только уровень управления до целевой версии.

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

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

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

-DisableLocalAccount

Локальные учетные записи должны быть отключены в управляемом кластере.

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

-DiskEncryptionSetID

Идентификатор ресурса набора шифрования дисков, используемый для включения шифрования.

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

-DnsNamePrefix

Префикс DNS-имени для кластера.

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

-EnableAHUB

Следует ли включить преимущества гибридных пользователей Azure (AHUB) для виртуальных машин Windows.

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

-EnableApiServerAccessPrivateCluster

Создание кластера в качестве частного кластера или нет.

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

-EnableApiServerAccessPrivateClusterPublicFQDN

Следует ли создавать дополнительное полное доменное доменное имя для частного кластера или нет.

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

-EnableManagedIdentity

Использование управляемого удостоверения для управления группой ресурсов кластера.

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

-EnableNodeAutoScaling

Включение автоматического масштабирования

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

-EnableOidcIssuer

Следует ли использовать функцию издателя OIDC.

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

-EnableUptimeSLA

Следует ли использовать соглашение об уровне обслуживания от времени простоя.

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

-FqdnSubdomain

Поддомен полного доменного имени частного кластера с пользовательской частной зоной DNS.

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

-HttpProxy

Используемая конечная точка прокси-сервера HTTP.

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

-HttpProxyConfigNoProxyEndpoint

Конечные точки, которые не должны проходить через прокси-сервер.

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

-HttpProxyConfigTrustedCa

Альтернативный сертификат ЦС, используемый для подключения к прокси-серверам.

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

-HttpsProxy

Используемая конечная точка прокси-сервера HTTPS

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

-Id

Идентификатор управляемого кластера Kubernetes

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

-InputObject

Объект PSKubernetesCluster, обычно передаваемый через конвейер.

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

-KubernetesVersion

Версия Kubernetes, используемая для создания кластера.

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

-LinuxProfileAdminUserName

Имя пользователя для службы "Виртуальные машины Linux".

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

-LoadBalancerAllocatedOutboundPort

Требуемое количество выделенных портов SNAT на виртуальную машину.

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

-LoadBalancerIdleTimeoutInMinute

Требуемое время ожидания ожидания исходящего потока в минутах.

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

-LoadBalancerManagedOutboundIpCount

Требуемое число исходящих IP-адресов для подсистемы балансировки нагрузки кластера.

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

-LoadBalancerOutboundIp

Требуемые исходящие IP-ресурсы для подсистемы балансировки нагрузки кластера.

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

-LoadBalancerOutboundIpPrefix

Требуемые ресурсы префикса ИСХОДЯщего IP-адреса для подсистемы балансировки нагрузки кластера.

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

-Location

Расположение Azure для кластера. По умолчанию используется расположение группы ресурсов.

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

-Name

Имя управляемого кластера Kubernetes.

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

-NodeCount

Количество узлов по умолчанию в пулах узлов.

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

-NodeImageOnly

Обновит только образ узла пулов агентов.

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

-NodeMaxCount

Максимальное количество узлов для автоматического масштабирования

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

-NodeMinCount

Минимальное количество узлов для автоматического масштабирования.

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

-NodeName

Уникальное имя профиля пула агентов в контексте подписки и группы ресурсов.

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

-NodeOsDiskSize

Указывает размер диска операционной системы в ГБ.

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

-NodePoolLabel

Метки пула узлов, используемые для создания сети Kubernetes.

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

-NodePoolMode

NodePoolMode представляет режим пула узлов.

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

-NodePoolTag

Теги, которые необходимо сохранить в масштабируемом наборе виртуальных машин пула агентов.

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

-NodeVmSize

Размер виртуальной машины.

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

-ResourceGroupName

Имя группы ресурсов.

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

-ServicePrincipalIdAndSecret

Идентификатор клиента и секрет клиента, связанные с приложением AAD или субъектом-службой.

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

-SshKeyValue

Значение файла ключа SSH или путь к файлу ключа. По умолчанию используется {HOME}/.ssh/id_rsa.pub.

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

-SubscriptionId

Идентификатор подписки. По умолчанию командлеты выполняются в подписке, заданной в текущем контексте. Если пользователь указывает другую подписку, текущий командлет выполняется в подписке, указанной пользователем. Переопределение подписок действует только в течение жизненного цикла текущего командлета. Он не изменяет подписку в контексте и не влияет на последующие командлеты.

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

-Tag

Теги, применяемые к ресурсу

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

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

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

-WindowsProfileAdminUserPassword

Пароль администратора, используемый для виртуальных машин Windows. Требование к паролю: по крайней мере один нижний регистр, один верхний регистр, один специальный символ !@#$%^&*(), минимальный lenth равен 12.

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

Входные данные

PSKubernetesCluster

String

Выходные данные

PSKubernetesCluster