New-AzAksCluster

Syntax

New-AzAksCluster
   [-NodeVmSetType <String>]
   [-NodeVnetSubnetID <String>]
   [-NodeMaxPodCount <Int32>]
   [-NodeSetPriority <String>]
   [-NodePoolMode <String>]
   [-NodeOsSKU <String>]
   [-NodeScaleSetEvictionPolicy <String>]
   [-AddOnNameToBeEnabled <String[]>]
   [-WorkspaceResourceId <String>]
   [-SubnetName <String>]
   [-EnableRbac]
   [-WindowsProfileAdminUserName <String>]
   [-NetworkPlugin <String>]
   [-NetworkPolicy <String>]
   [-PodCidr <String>]
   [-ServiceCidr <String>]
   [-DnsServiceIP <String>]
   [-OutboundType <String>]
   [-LoadBalancerSku <String>]
   [-Force]
   [-GenerateSshKey]
   [-EnableNodePublicIp]
   [-NodePublicIPPrefixID <String>]
   [-AvailabilityZone <String[]>]
   [-NodeResourceGroup <String>]
   [-EnableEncryptionAtHost]
   [-EnableUltraSSD]
   [-NodeLinuxOSConfig <LinuxOSConfig>]
   [-NodeKubeletConfig <KubeletConfig>]
   [-NodeMaxSurge <String>]
   [-PPG <String>]
   [-EnableFIPS]
   [-AutoScalerProfile <ManagedClusterPropertiesAutoScalerProfile>]
   [-GpuInstanceProfile <String>]
   [-EnableUptimeSLA]
   [-EdgeZone <String>]
   [-NodeHostGroupID <String>]
   [-NodePodSubnetID <String>]
   [-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>]

Description

Create a new Azure Kubernetes Service(AKS) cluster.

Examples

Example 1: Create an AKS with default params.

New-AzAksCluster -ResourceGroupName myResourceGroup -Name myCluster

Example 2: Create Windows Server container on an AKS.

To create Windows Server container on an AKS, you must specify at least four following parameters when creating the AKS, and the value for NetworkPlugin and NodeVmSetType must be azure and VirtualMachineScaleSets respectively. -WindowsProfileAdminUserName *** -WindowsProfileAdminUserPassword *** -NetworkPlugin azure -NodeVmSetType VirtualMachineScaleSets

$cred = ConvertTo-SecureString -String "****" -AsPlainText -Force
New-AzAksCluster -ResourceGroupName myResourceGroup -Name myCluster -WindowsProfileAdminUserName azureuser -WindowsProfileAdminUserPassword $cred -NetworkPlugin azure -NodeVmSetType VirtualMachineScaleSets
New-AzAksNodePool -ResourceGroupName myResourceGroup -ClusterName myCluster -Name win1 -OsType Windows -VmSetType VirtualMachineScaleSets

Example 3: Create an AKS cluster with LinuxOSConfig and KubeletConfig.

When you create an AKS cluster, you can specify the kubelet and OS configurations. The type of NodeLinuxOSConfig and NodeKubeletConfig must be Microsoft.Azure.Management.ContainerService.Models.LinuxOSConfig and Microsoft.Azure.Management.ContainerService.Models.KubeletConfig respectively.

$linuxOsConfigJsonStr = @'
            {
             "transparentHugePageEnabled": "madvise",
             "transparentHugePageDefrag": "defer+madvise",
             "swapFileSizeMB": 1500,
             "sysctls": {
              "netCoreSomaxconn": 163849,
              "netIpv4TcpTwReuse": true,
              "netIpv4IpLocalPortRange": "32000 60000"
             }
            }
'@
$linuxOsConfig = [Microsoft.Azure.Management.ContainerService.Models.LinuxOSConfig] ($linuxOsConfigJsonStr | ConvertFrom-Json)
$kubeletConfigStr = @'
            {
             "failSwapOn": false
            }
'@
$kubeletConfig = [Microsoft.Azure.Management.ContainerService.Models.KubeletConfig] ($kubeletConfigStr | ConvertFrom-Json)

New-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -NodeLinuxOSConfig $linuxOsConfig -NodeKubeletConfig $kubeletConfig

Example 4: Create an AKS cluster with AutoScalerProfile.

When you create an AKS cluster, you can configure granular details of the cluster autoscaler by changing the default values in the cluster-wide autoscaler profile.

$AutoScalerProfile=@{
    ScanInterval="30s"
    Expander="least-waste"
}
$AutoScalerProfile=[Microsoft.Azure.Management.ContainerService.Models.ManagedClusterPropertiesAutoScalerProfile]$AutoScalerProfile

New-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -AutoScalerProfile $AutoScalerProfile

Example 5: Create an AKS cluster with AadProfile.

When you create an AKS cluster, you can configure the AAD profile.

$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

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

Parameters

-AadProfile

-AcrNameToAttach

-AddOnNameToBeEnabled

-AksCustomHeader

-ApiServerAccessAuthorizedIpRange

-ApiServerAccessPrivateDnsZone

-AsJob

-AssignIdentity

-AutoScalerProfile

-AutoUpgradeChannel

-AvailabilityZone

-Confirm

-DefaultProfile

-DisableLocalAccount

-DiskEncryptionSetID

-DnsNamePrefix

-DnsServiceIP

-EdgeZone

-EnableAHUB

-EnableApiServerAccessPrivateCluster

-EnableApiServerAccessPrivateClusterPublicFQDN

-EnableEncryptionAtHost

-EnableFIPS

-EnableManagedIdentity

-EnableNodeAutoScaling

-EnableNodePublicIp

-EnableOidcIssuer

-EnableRbac

-EnableUltraSSD

-EnableUptimeSLA

-Force

-FqdnSubdomain

-GenerateSshKey

-GpuInstanceProfile

-HttpProxy

-HttpProxyConfigNoProxyEndpoint

-HttpProxyConfigTrustedCa

-HttpsProxy

-KubernetesVersion

-LinuxProfileAdminUserName

-LoadBalancerAllocatedOutboundPort

-LoadBalancerIdleTimeoutInMinute

-LoadBalancerManagedOutboundIpCount

-LoadBalancerOutboundIp

-LoadBalancerOutboundIpPrefix

-LoadBalancerSku

-Location

-Name

-NetworkPlugin

-NetworkPolicy

-NodeCount

-NodeHostGroupID

-NodeKubeletConfig

-NodeLinuxOSConfig

-NodeMaxCount

-NodeMaxPodCount

-NodeMaxSurge

-NodeMinCount

-NodeName

-NodeOsDiskSize

-NodeOsSKU

-NodePodSubnetID

-NodePoolLabel

-NodePoolMode

-NodePoolTag

-NodePublicIPPrefixID

-NodeResourceGroup

-NodeScaleSetEvictionPolicy

-NodeSetPriority

-NodeVmSetType

-NodeVmSize

-NodeVnetSubnetID

-OutboundType

-PodCidr

-PPG

-ResourceGroupName

-ServiceCidr

-ServicePrincipalIdAndSecret

-SshKeyValue

-SubnetName

-SubscriptionId

-Tag

-WhatIf

-WindowsProfileAdminUserName

-WindowsProfileAdminUserPassword

-WorkspaceResourceId

Inputs

None

Outputs

PSKubernetesCluster