New-AzNetworkCloudKubernetesCluster

Sintaxe

CreateExpanded (Default)

New-AzNetworkCloudKubernetesCluster
    -Name <String>
    -ResourceGroupName <String>
    -ControlPlaneNodeConfigurationCount <Int64>
    -ControlPlaneNodeConfigurationVMSkuName <String>
    -ExtendedLocationName <String>
    -ExtendedLocationType <String>
    -InitialAgentPoolConfiguration <IInitialAgentPoolConfiguration[]>
    -KubernetesVersion <String>
    -Location <String>
    -NetworkConfigurationCloudServicesNetworkId <String>
    -NetworkConfigurationCniNetworkId <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AadConfigurationAdminGroupObjectId <String[]>]
    [-AdminUsername <String>]
    [-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
    [-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
    [-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
    [-BgpAdvertisement <IBgpAdvertisement[]>]
    [-BgpIPAddressPool <IIPAddressPool[]>]
    [-BgpPeer <IServiceLoadBalancerBgpPeer[]>]
    [-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled <String>]
    [-ControlPlaneNodeConfigurationAdminPublicKey <ISshPublicKey[]>]
    [-ControlPlaneNodeConfigurationAdminUsername <String>]
    [-ControlPlaneNodeConfigurationAvailabilityZone <String[]>]
    [-L2ServiceLoadBalancerConfigurationIPAddressPool <IIPAddressPool[]>]
    [-ManagedResourceGroupConfigurationLocation <String>]
    [-ManagedResourceGroupConfigurationName <String>]
    [-NetworkConfigurationDnsServiceIP <String>]
    [-NetworkConfigurationPodCidr <String[]>]
    [-NetworkConfigurationServiceCidr <String[]>]
    [-SshPublicKey <ISshPublicKey[]>]
    [-Tag <Hashtable>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonFilePath

New-AzNetworkCloudKubernetesCluster
    -Name <String>
    -ResourceGroupName <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonString

New-AzNetworkCloudKubernetesCluster
    -Name <String>
    -ResourceGroupName <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1: Criar cluster do Kubernetes

$tagHash = @{tags = "tag1" }
$agentPoolConfiguration = @{
    count = 1
    mode = "System"
    name = "agentPoolName"
    vmSkuName = "vmSkuName"
    administratorConfiguration = "administratorConfiguration"
}
$sshPublicKey = @{
    KeyData = "ssh-rsa aaaKyfsdx= fakekey@vm"
}
New-AzNetworkCloudKubernetesCluster -ResourceGroupName resourceGroupName `
                -KubernetesClusterName default -Location location `
                -ExtendedLocationName extendedLocationName `
                -ExtendedLocationType "CustomLocation" `
                -KubernetesVersion kubernetesVersion `
                -AadConfigurationAdminGroupObjectId adminGroupObjectIds `
                -AdminUsername "azureuser" `
                -SshPublicKey $sshPublicKey `
                -InitialAgentPoolConfiguration $agentPoolConfiguration `
                -NetworkConfigurationCloudServicesNetworkId cloudServicesNetworkId `
                -NetworkConfigurationCniNetworkId cniNetworkId `
                -SubscriptionId subscriptionId `
                -Tag $tagHash

Location Name    SystemDataCreatedAt SystemDataCreatedBy    SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy             SystemDataLastModifiedByType ResourceGroupName
-------- ----    ------------------- -------------------    ----------------------- ------------------------ ------------------------             ---------------------------- -----------------
eastus   default 08/09/2023 20:23:17 <identity>             User                    08/09/2023 20:44:27      <identity>                            Application                 resourceGroupName

Parâmetros

-AadConfigurationAdminGroupObjectId

A lista de IDs de objeto do grupo do Azure Active Directory que terão uma função administrativa no cluster do Kubernetes.

Propriedades do parâmetro

Conjuntos de parâmetros

-AdminUsername

O nome de usuário do administrador que será aplicado aos sistemas operacionais que executam nós do Kubernetes. Se não for fornecido, um nome de usuário será escolhido pelo serviço.

Propriedades do parâmetro

Conjuntos de parâmetros

-AsJob

Executar o comando como um trabalho

Propriedades do parâmetro

Conjuntos de parâmetros

-AttachedNetworkConfigurationL2Network

A lista de Redes da Camada 2 e a configuração relacionada para anexo.

Propriedades do parâmetro

Conjuntos de parâmetros

-AttachedNetworkConfigurationL3Network

A lista de Redes da Camada 3 e a configuração relacionada para anexo.

Propriedades do parâmetro

Conjuntos de parâmetros

-AttachedNetworkConfigurationTrunkedNetwork

A lista de redes tronco e configuração relacionada para anexo.

Propriedades do parâmetro

Conjuntos de parâmetros

-BgpAdvertisement

A associação de pools de endereços IP às comunidades e pares, permitindo o anúncio de IPs.

Propriedades do parâmetro

Conjuntos de parâmetros

-BgpIPAddressPool

A lista de pools de endereços IP que podem ser alocados para serviços de balanceador de carga.

Propriedades do parâmetro

Conjuntos de parâmetros

-BgpPeer

A lista de entidades bgpPeer adicionais com as quais o cluster kubernetes será emparelhada. Todo o emparelhamento deve ser definido explicitamente.

Propriedades do parâmetro

Conjuntos de parâmetros

-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled

O indicador a ser especificado se o balanceador de carga emparelha com a malha de rede.

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

-ControlPlaneNodeConfigurationAdminPublicKey

A configuração de SSH para os sistemas operacionais que executam os nós no cluster do Kubernetes. Em alguns casos, a especificação de chaves públicas pode ser necessária para produzir um ambiente de trabalho.

Propriedades do parâmetro

Conjuntos de parâmetros

-ControlPlaneNodeConfigurationAdminUsername

O nome de usuário do administrador que será aplicado aos sistemas operacionais que executam nós do Kubernetes. Se não for fornecido, um nome de usuário será escolhido pelo serviço.

Propriedades do parâmetro

Conjuntos de parâmetros

-ControlPlaneNodeConfigurationAvailabilityZone

A lista de zonas de disponibilidade do cluster de Nuvem de Rede a ser usada para o provisionamento de nós no plano de controle. Se não for especificado, todas as zonas de disponibilidade serão usadas.

Propriedades do parâmetro

Conjuntos de parâmetros

-ControlPlaneNodeConfigurationCount

O número de máquinas virtuais que usam essa configuração.

Propriedades do parâmetro

Conjuntos de parâmetros

-ControlPlaneNodeConfigurationVMSkuName

O nome da SKU da VM fornecida durante a criação.

Propriedades do parâmetro

Conjuntos de parâmetros

-DefaultProfile

O parâmetro DefaultProfile não está funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExtendedLocationName

A ID do recurso do local estendido no qual o recurso será criado.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExtendedLocationType

O tipo de local estendido, por exemplo, CustomLocation.

Propriedades do parâmetro

Conjuntos de parâmetros

-IfMatch

A ETag da transformação. Omita esse valor para sempre substituir o recurso atual. Especifique o valor de ETag visto pela última vez para impedir a substituição acidental de alterações simultâneas.

Propriedades do parâmetro

Conjuntos de parâmetros

-IfNoneMatch

Defina como '*' para permitir que um novo conjunto de registros seja criado, mas para impedir a atualização de um recurso existente. Outros valores resultarão em erro do servidor, pois não têm suporte.

Propriedades do parâmetro

Conjuntos de parâmetros

-InitialAgentPoolConfiguration

Os pools de agentes criados com esse cluster do Kubernetes para executar cargas de trabalho e serviços críticos do sistema. Esses dados nesse campo só são usados durante a criação e o campo estará vazio após a criação do Cluster kubernetes. Após a criação, o gerenciamento de pools de agentes é feito usando o sub-recurso agentPools.

Propriedades do parâmetro

Conjuntos de parâmetros

-JsonFilePath

Caminho do arquivo Json fornecido para a operação Create

Propriedades do parâmetro

Conjuntos de parâmetros

-JsonString

Cadeia de caracteres Json fornecida para a operação Create

Propriedades do parâmetro

Conjuntos de parâmetros

-KubernetesVersion

A versão do Kubernetes para este cluster.

Propriedades do parâmetro

Conjuntos de parâmetros

-L2ServiceLoadBalancerConfigurationIPAddressPool

A lista de pools de endereços IP que podem ser alocados para serviços de balanceador de carga.

Propriedades do parâmetro

Conjuntos de parâmetros

-Location

A localização geográfica onde o recurso reside

Propriedades do parâmetro

Conjuntos de parâmetros

-ManagedResourceGroupConfigurationLocation

O local do grupo de recursos gerenciados. Se não for especificado, o local do recurso pai será escolhido.

Propriedades do parâmetro

Conjuntos de parâmetros

-ManagedResourceGroupConfigurationName

O nome do grupo de recursos gerenciado. Se não for especificado, o nome exclusivo será gerado automaticamente.

Propriedades do parâmetro

Conjuntos de parâmetros

-Name

O nome do cluster do Kubernetes.

Propriedades do parâmetro

Conjuntos de parâmetros

-NetworkConfigurationCloudServicesNetworkId

A ID do recurso da rede de Serviços de Nuvem associada.

Propriedades do parâmetro

Conjuntos de parâmetros

-NetworkConfigurationCniNetworkId

A ID do recurso da rede camada 3 usada para a criação da rede da Interface de Rede de Contêiner.

Propriedades do parâmetro

Conjuntos de parâmetros

-NetworkConfigurationDnsServiceIP

O endereço IP atribuído ao serviço DNS do Kubernetes. Ele deve estar dentro do intervalo de endereços de serviço do Kubernetes especificado no CIDR de serviço.

Propriedades do parâmetro

Conjuntos de parâmetros

-NetworkConfigurationPodCidr

Os intervalos de IP de notação CIDR dos quais atribuir IPs de pod. Uma CIDR IPv4 é esperada para rede de pilha única. Dois CIDRs, um para cada família IP (IPv4/IPv6), são esperados para rede de pilha dupla.

Propriedades do parâmetro

Conjuntos de parâmetros

-NetworkConfigurationServiceCidr

Os intervalos de IP de notação CIDR dos quais atribuir IPs de serviço. Uma CIDR IPv4 é esperada para rede de pilha única. Dois CIDRs, um para cada família IP (IPv4/IPv6), são esperados para rede de pilha dupla.

Propriedades do parâmetro

Conjuntos de parâmetros

-NoWait

Execute o comando de forma assíncrona

Propriedades do parâmetro

Conjuntos de parâmetros

-ResourceGroupName

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

Propriedades do parâmetro

Conjuntos de parâmetros

-SshPublicKey

A configuração de SSH para os sistemas operacionais que executam os nós no cluster do Kubernetes. Em alguns casos, a especificação de chaves públicas pode ser necessária para produzir um ambiente de trabalho.

Propriedades do parâmetro

Conjuntos de parâmetros

-SubscriptionId

A ID da assinatura de destino. O valor deve ser uma UUID.

Propriedades do parâmetro

Conjuntos de parâmetros

-Tag

Tags de recursos.

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

CommonParameters

Saídas

IKubernetesCluster