Compartilhar via

New-AzNetworkCloudKubernetesCluster

  • Referência
Módulo:
Az.NetworkCloud

Crie um novo cluster do Kubernetes ou atualize as propriedades do existente.

Sintaxe

New-AzNetworkCloudKubernetesCluster
   -KubernetesClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -ControlPlaneNodeConfigurationCount <Int64>
   -ControlPlaneNodeConfigurationVMSkuName <String>
   -ExtendedLocationName <String>
   -ExtendedLocationType <String>
   -InitialAgentPoolConfiguration <IInitialAgentPoolConfiguration[]>
   -KubernetesVersion <String>
   -Location <String>
   -NetworkConfigurationCloudServicesNetworkId <String>
   -NetworkConfigurationCniNetworkId <String>
   [-AadConfigurationAdminGroupObjectId <String[]>]
   [-AdminUsername <String>]
   [-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
   [-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
   [-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
   [-BgpAdvertisement <IBgpAdvertisement[]>]
   [-BgpIPAddressPool <IIPAddressPool[]>]
   [-BgpPeer <IServiceLoadBalancerBgpPeer[]>]
   [-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled <FabricPeeringEnabled>]
   [-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>]

Description

Crie um novo cluster do Kubernetes ou atualize as propriedades do existente.

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

Esse comando cria um cluster do Kubernetes.

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.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AsJob

Executar o comando como um trabalho

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AttachedNetworkConfigurationL2Network

A lista de Redes da Camada 2 e a configuração relacionada para anexo. Para construir, consulte a seção NOTES para ATTACHEDNETWORKCONFIGURATIONL2NETWORK propriedades e crie uma tabela de hash.

Tipo:IL2NetworkAttachmentConfiguration[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AttachedNetworkConfigurationL3Network

A lista de Redes da Camada 3 e a configuração relacionada para anexo. Para construir, consulte a seção NOTES para ATTACHEDNETWORKCONFIGURATIONL3NETWORK propriedades e crie uma tabela de hash.

Tipo:IL3NetworkAttachmentConfiguration[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AttachedNetworkConfigurationTrunkedNetwork

A lista de redes tronco e configuração relacionada para anexo. Para construir, consulte a seção NOTES para propriedades ATTACHEDNETWORKCONFIGURATIONTRUNKEDNETWORK e crie uma tabela de hash.

Tipo:ITrunkedNetworkAttachmentConfiguration[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BgpAdvertisement

A associação de pools de endereços IP às comunidades e pares, permitindo o anúncio de IPs. Para construir, consulte a seção NOTES para propriedades BGPADVERTISEMENT e crie uma tabela de hash.

Tipo:IBgpAdvertisement[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BgpIPAddressPool

A lista de pools de endereços IP que podem ser alocados para serviços de balanceador de carga. Para construir, consulte a seção NOTES para propriedades BGPIPADDRESSPOOL e crie uma tabela de hash.

Tipo:IIPAddressPool[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BgpPeer

A lista de entidades bgpPeer adicionais com as quais o cluster kubernetes será emparelhada. Todo o emparelhamento deve ser definido explicitamente. Para construir, consulte a seção NOTES para propriedades BGPPEER e crie uma tabela de hash.

Tipo:IServiceLoadBalancerBgpPeer[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled

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

Tipo:FabricPeeringEnabled
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-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. Para construir, consulte a seção NOTES para propriedades CONTROLPLANENODECONFIGURATIONADMINPUBLICKEY e crie uma tabela de hash.

Tipo:ISshPublicKey[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

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

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ControlPlaneNodeConfigurationCount

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

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ControlPlaneNodeConfigurationVMSkuName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

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

Tipo:PSObject
Aliases:AzureRMContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ExtendedLocationName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ExtendedLocationType

O tipo de local estendido, por exemplo, CustomLocation.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-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. Para construir, consulte a seção NOTES para propriedades INITIALAGENTPOOLCONFIGURATION e crie uma tabela de hash.

Tipo:IInitialAgentPoolConfiguration[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-KubernetesClusterName

O nome do cluster kubernetes.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-KubernetesVersion

A versão do Kubernetes para este cluster.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-L2ServiceLoadBalancerConfigurationIPAddressPool

A lista de pools de endereços IP que podem ser alocados para serviços de balanceador de carga. Para construir, consulte a seção NOTES para L2SERVICELOADBALANCERCONFIGURATIONIPADDRESSPOOL propriedades e crie uma tabela de hash.

Tipo:IIPAddressPool[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Location

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ManagedResourceGroupConfigurationLocation

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ManagedResourceGroupConfigurationName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NetworkConfigurationCloudServicesNetworkId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NetworkConfigurationCniNetworkId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

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

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

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

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NoWait

Executar o comando de forma assíncrona

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-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. Para construir, consulte a seção NOTES para propriedades SSHPUBLICKEY e crie uma tabela de hash.

Tipo:ISshPublicKey[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SubscriptionId

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

Tipo:String
Cargo:Named
Valor padrão:(Get-AzContext).Subscription.Id
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Tag

Marcas de recurso.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas