New-AzAksCluster

Sintaxe

Default (Padrão)

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

Exemplos

Exemplo 1: criar um AKS com parâmetros padrão.

New-AzAksCluster -ResourceGroupName myResourceGroup -Name myCluster

Exemplo 2: criar contêiner do Windows Server em um AKS.

$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

Exemplo 3: criar um cluster do AKS com LinuxOSConfig e KubeletConfig.

$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

Exemplo 4: criar um cluster do AKS com AutoScalerProfile.

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

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

Exemplo 5: criar um cluster do AKS com AadProfile.

$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

Parâmetros

-AadProfile

A configuração do Azure Active Directory.

Propriedades do parâmetro

Conjuntos de parâmetros

-AcrNameToAttach

Conceda a função 'acrpull' do ACR especificado à Entidade de Serviço do AKS, por exemplo, myacr

Propriedades do parâmetro

Conjuntos de parâmetros

-AddOnNameToBeEnabled

Nomes de complementos a serem habilitados quando o cluster for criado.

Propriedades do parâmetro

Conjuntos de parâmetros

-AksCustomHeader

Cabeçalhos personalizados do Aks usados para criar a rede do Kubernetes.

Propriedades do parâmetro

Conjuntos de parâmetros

-ApiServerAccessAuthorizedIpRange

Os intervalos de IP autorizados a acessar o servidor de API do Kubernetes.

Propriedades do parâmetro

Conjuntos de parâmetros

-ApiServerAccessPrivateDnsZone

O modo de zona DNS privado para o cluster.

Propriedades do parâmetro

Conjuntos de parâmetros

-AsJob

Executar cmdlet em segundo plano

Propriedades do parâmetro

Conjuntos de parâmetros

-AssignIdentity

ResourceId da identidade gerenciada atribuída pelo usuário para o cluster.

Propriedades do parâmetro

Conjuntos de parâmetros

-AutoScalerProfile

Os parâmetros a serem aplicados ao dimensionador automático de cluster.

Propriedades do parâmetro

Conjuntos de parâmetros

-AutoUpgradeChannel

O canal de atualização para atualização automática. Para obter mais informações, consulte https://learn.microsoft.com/azure/aks/upgrade-cluster#set-auto-upgrade-channel.

Propriedades do parâmetro

Conjuntos de parâmetros

-AvailabilityZone

Zonas de disponibilidade para cluster. Deve usar VirtualMachineScaleSets AgentPoolType.

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Conjuntos de parâmetros

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Propriedades do parâmetro

Conjuntos de parâmetros

-DisableLocalAccount

As contas locais devem ser desabilitadas no Cluster Gerenciado.

Propriedades do parâmetro

Conjuntos de parâmetros

-DiskEncryptionSetID

A ID do recurso do conjunto de criptografia de disco a ser usado para habilitar a criptografia.

Propriedades do parâmetro

Conjuntos de parâmetros

-DnsNamePrefix

O prefixo do nome DNS do cluster. O comprimento deve ser <= 9 se os usuários planejam adicionar o contêiner do Windows.

Propriedades do parâmetro

Conjuntos de parâmetros

-DnsServiceIP

IP do serviço DNS usado para criar a rede Kubernetes.

Propriedades do parâmetro

Conjuntos de parâmetros

-EdgeZone

O nome da Zona de Borda.

Propriedades do parâmetro

Conjuntos de parâmetros

-EnableAHUB

Se deseja habilitar os AHUB (Benefícios do Usuário Híbrido do Azure) para VMs do Windows.

Propriedades do parâmetro

Conjuntos de parâmetros

-EnableApiServerAccessPrivateCluster

Se o cluster deve ser criado como um cluster privado ou não.

Propriedades do parâmetro

Conjuntos de parâmetros

-EnableApiServerAccessPrivateClusterPublicFQDN

Se deseja criar FQDN público adicional para cluster privado ou não.

Propriedades do parâmetro

Conjuntos de parâmetros

-EnableEncryptionAtHost

Se o sistema operacional baseado em host e a unidade de dados devem ser ativados

Propriedades do parâmetro

Conjuntos de parâmetros

-EnableFIPS

Se deve usar um sistema operacional habilitado para FIPS

Propriedades do parâmetro

Conjuntos de parâmetros

-EnableManagedIdentity

Usando uma identidade gerenciada para gerenciar o grupo de recursos do cluster.

Propriedades do parâmetro

Conjuntos de parâmetros

-EnableNodeAutoScaling

Se o dimensionador automático deve ser habilitado

Propriedades do parâmetro

Conjuntos de parâmetros

-EnableNodePublicIp

Se o IP público deve ser ativado para nós.

Propriedades do parâmetro

Conjuntos de parâmetros

-EnableOidcIssuer

Se deseja habilitar o recurso do emissor do OIDC.

Propriedades do parâmetro

Conjuntos de parâmetros

-EnableRbac

Se o acesso baseado em função do Kubernetes deve ser ativado

Propriedades do parâmetro

Conjuntos de parâmetros

-EnableUltraSSD

se o UltraSSD deve ser ativado

Propriedades do parâmetro

Conjuntos de parâmetros

-EnableUptimeSLA

Se deve usar o SLA de tempo de atividade.

Propriedades do parâmetro

Conjuntos de parâmetros

-Force

Criar cluster mesmo que ele já exista

Propriedades do parâmetro

Conjuntos de parâmetros

-FqdnSubdomain

O subdomínio FQDN do cluster privado com zona dns privada personalizada.

Propriedades do parâmetro

Conjuntos de parâmetros

-GenerateSshKey

Gere o arquivo de chave ssh para {HOME}/.ssh/id_rsa.

Propriedades do parâmetro

Conjuntos de parâmetros

-GpuInstanceProfile

O GpuInstanceProfile a ser usado para especificar o perfil de instância MIG da GPU para SKU de VM de GPU compatível.

Propriedades do parâmetro

Conjuntos de parâmetros

-HttpProxy

O ponto de extremidade do servidor proxy HTTP a ser usado.

Propriedades do parâmetro

Conjuntos de parâmetros

-HttpProxyConfigNoProxyEndpoint

Os pontos de extremidade que não devem passar pelo proxy.

Propriedades do parâmetro

Conjuntos de parâmetros

-HttpProxyConfigTrustedCa

Certificado de AC alternativo a ser usado para se conectar a servidores proxy.

Propriedades do parâmetro

Conjuntos de parâmetros

-HttpsProxy

O ponto de extremidade do servidor proxy HTTPS a ser usado

Propriedades do parâmetro

Conjuntos de parâmetros

-KubernetesVersion

A versão do Kubernetes a ser usada para criar o cluster.

Propriedades do parâmetro

Conjuntos de parâmetros

-LinuxProfileAdminUserName

Nome de usuário para a Máquinas Virtuais do Linux.

Propriedades do parâmetro

Conjuntos de parâmetros

-LoadBalancerAllocatedOutboundPort

O número desejado de portas SNAT alocadas por VM.

Propriedades do parâmetro

Conjuntos de parâmetros

-LoadBalancerIdleTimeoutInMinute

Tempo limite de ociosidade do fluxo de saída desejado em minutos.

Propriedades do parâmetro

Conjuntos de parâmetros

-LoadBalancerManagedOutboundIpCount

Os IPs de saída gerenciados desejados contam para o balanceador de carga do cluster.

Propriedades do parâmetro

Conjuntos de parâmetros

-LoadBalancerOutboundIp

Recursos de IP de saída desejados para o balanceador de carga do cluster.

Propriedades do parâmetro

Conjuntos de parâmetros

-LoadBalancerOutboundIpPrefix

Recursos de prefixo de IP de saída desejados para o balanceador de carga do cluster.

Propriedades do parâmetro

Conjuntos de parâmetros

-LoadBalancerSku

O sku do balanceador de carga para o cluster gerenciado.

Propriedades do parâmetro

Conjuntos de parâmetros

-Location

Local do Azure para o cluster. O padrão é o local do grupo de recursos.

Propriedades do parâmetro

Conjuntos de parâmetros

-Name

Nome do cluster gerenciado do Kubernetes.

Propriedades do parâmetro

Conjuntos de parâmetros

-NetworkPlugin

Plug-in de rede usado para criar a rede do Kubernetes.

Propriedades do parâmetro

Conjuntos de parâmetros

-NetworkPolicy

Política de rede usada para a criação da rede do Kubernetes.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodeCount

O número padrão de nós para os pools de nós.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodeHostGroupID

A ID de recurso totalmente qualificada do Grupo de Host Dedicado do qual provisionar máquinas virtuais, usadas somente no cenário de criação e sem permissão para serem alteradas uma vez definidas.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodeKubeletConfig

A configuração do Kubelet nos nós do pool de agentes.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodeLinuxOSConfig

A configuração do sistema operacional dos nós do agente do Linux.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodeMaxCount

Número máximo de nós para dimensionamento automático

Propriedades do parâmetro

Conjuntos de parâmetros

-NodeMaxPodCount

Número máximo de pods que podem ser executados no nó.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodeMaxSurge

O número máximo ou porcentagem de nós que são aumentados durante a atualização.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodeMinCount

Número mínimo de nós para dimensionamento automático.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodeName

Nome exclusivo do perfil do pool de agentes no contexto da assinatura e do grupo de recursos.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodeOsDiskSize

Tamanho em GB do disco do sistema operacional para cada nó no pool de nós. Mínimo de 30 GB.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodeOsSKU

O SKU do sistema operacional padrão para os pools de nós.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodePodSubnetID

A ID da sub-rede na qual os pods se juntarão quando iniciados.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodePoolLabel

Rótulos de pool de nós usados para criar a rede Kubernetes.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodePoolMode

NodePoolMode representa o modo de um pool de nós.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodePoolTag

As marcas a serem mantidas no conjunto de dimensionamento de máquinas virtuais do pool de agentes.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodePublicIPPrefixID

A ID do recurso do prefixo IP público para o pool de nós.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodeResourceGroup

O grupo de recursos que contém o pool de agentes.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodeScaleSetEvictionPolicy

ScaleSetEvictionPolicy a ser usado para especificar a política de remoção para o conjunto de dimensionamento de máquinas virtuais de baixa prioridade. Padrão para Excluir.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodeSetPriority

ScaleSetPriority a ser usado para especificar a prioridade do conjunto de dimensionamento de máquinas virtuais. Padrão para regular.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodeVmSetType

AgentPoolType representa tipos de um pool de agentes. Os valores possíveis incluem: 'VirtualMachineScaleSets', 'AvailabilitySet'

Propriedades do parâmetro

Conjuntos de parâmetros

-NodeVmSize

O tamanho da máquina virtual. O valor padrão é selecionado dinamicamente pelo provedor de recursos do AKS com base na cota e na capacidade.

Propriedades do parâmetro

Conjuntos de parâmetros

-NodeVnetSubnetID

A SubnetID da VNet especifica o identificador de sub-rede da VNet.

Propriedades do parâmetro

Conjuntos de parâmetros

-OutboundType

O método de roteamento de saída (saída).

Propriedades do parâmetro

Conjuntos de parâmetros

-PodCidr

Pod cidr usado para construir a rede Kubernetes.

Propriedades do parâmetro

Conjuntos de parâmetros

-PPG

A ID do Grupo de Posicionamento por Proximidade.

Propriedades do parâmetro

Conjuntos de parâmetros

-ResourceGroupName

Nome do Grupo de Recursos.

Propriedades do parâmetro

Conjuntos de parâmetros

-ServiceCidr

Cidr de serviço usado para construir a rede Kubernetes.

Propriedades do parâmetro

Conjuntos de parâmetros

-ServicePrincipalIdAndSecret

A ID do cliente e o segredo do cliente associados ao aplicativo/entidade de serviço do AAD.

Propriedades do parâmetro

Conjuntos de parâmetros

-SshKeyValue

Caminho do arquivo de chave ou valor do arquivo de chave SSH. O padrão é {HOME}/.ssh/id_rsa.pub.

Propriedades do parâmetro

Conjuntos de parâmetros

-SubnetName

Nome da sub-rede do complemento VirtualNode.

Propriedades do parâmetro

Conjuntos de parâmetros

-SubscriptionId

A ID da assinatura. Por padrão, os cmdlets são executados na assinatura definida no contexto atual. Se o usuário especificar outra assinatura, o cmdlet atual será executado na assinatura especificada pelo usuário. As assinaturas de substituição só entram em vigor durante o ciclo de vida do cmdlet atual. Ele não altera a assinatura no contexto e não afeta os cmdlets subsequentes.

Propriedades do parâmetro

Conjuntos de parâmetros

-Tag

Tags a serem aplicadas ao recurso

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Conjuntos de parâmetros

-WindowsProfileAdminUserName

O nome de usuário do administrador a ser usado para VMs do Windows.

Propriedades do parâmetro

Conjuntos de parâmetros

-WindowsProfileAdminUserPassword

A senha do administrador a ser usada para VMs do Windows, seu comprimento deve ser de pelo menos 12, contendo pelo menos um caractere minúsculo, ou seja [a-z], um [A-Z] e um caractere [!@#$%^&*()]especial .

Propriedades do parâmetro

Conjuntos de parâmetros

-WorkspaceResourceId

ID do recurso do workspace do complemento Monitoring.

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Entradas

None

Saídas

PSKubernetesCluster