New-AzNetworkCloudKubernetesCluster
Crie um novo cluster Kubernetes ou crie as propriedades do existente.
Sintaxe
CreateExpanded (Predefinição)
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>]
Descrição
Crie um novo cluster Kubernetes ou crie as propriedades do existente.
Exemplos
Exemplo 1: Criar cluster 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
Este comando cria um cluster do Kubernetes.
Parâmetros
-AadConfigurationAdminGroupObjectId
A lista de IDs de objeto de grupo do Azure Ative Directory que terão uma função administrativa no cluster do Kubernetes.
Propriedades dos parâmetros
Tipo: String [ ]
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: 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.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-AsJob
Executar o comando como um trabalho
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-AttachedNetworkConfigurationL2Network
A lista de Redes de Camada 2 e configuração relacionada para anexo.
Propriedades dos parâmetros
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-AttachedNetworkConfigurationL3Network
A lista de Redes de Camada 3 e configuração relacionada para anexo.
Propriedades dos parâmetros
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-AttachedNetworkConfigurationTrunkedNetwork
A lista de redes troncalizadas e configuração relacionada para anexo.
Propriedades dos parâmetros
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-BgpAdvertisement
A associação de pools de endereços IP às comunidades e pares, permitindo o anúncio de IPs.
Propriedades dos parâmetros
Tipo: IBgpAdvertisement [ ]
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-BgpIPAddressPool
A lista de pools de endereços IP que podem ser alocados para serviços de balanceador de carga.
Propriedades dos parâmetros
Tipo: IIPAddressPool [ ]
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-BgpPeer
A lista de entidades BgpPeer adicionais com as quais o cluster do Kubernetes emparelhará.
Todo o emparelhamento deve ser explicitamente definido.
Propriedades dos parâmetros
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled
O indicador para especificar se o balanceador de carga combina com a malha de rede.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: Cf.
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ControlPlaneNodeConfigurationAdminPublicKey
A configuração SSH para os sistemas operacionais que executam os nós no cluster Kubernetes.
Em alguns casos, a especificação de chaves públicas pode ser necessária para produzir um ambiente de trabalho.
Propriedades dos parâmetros
Tipo: ISshPublicKey [ ]
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: 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.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ControlPlaneNodeConfigurationAvailabilityZone
A lista de zonas de disponibilidade do cluster Network Cloud a ser usado para o provisionamento de nós no plano de controle.
Se não for especificado, todas as zonas de disponibilidade serão usadas.
Propriedades dos parâmetros
Tipo: String [ ]
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ControlPlaneNodeConfigurationCount
O número de máquinas virtuais que usam essa configuração.
Propriedades dos parâmetros
Tipo: Int64
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ControlPlaneNodeConfigurationVMSkuName
O nome da SKU da VM fornecida durante a criação.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-DefaultProfile
O parâmetro DefaultProfile não é funcional.
Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.
Propriedades dos parâmetros
Tipo: PSObject
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: AzureRMContext, AzureCredential
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ExtendedLocationName
A ID do recurso do local estendido no qual o recurso será criado.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ExtendedLocationType
O tipo de local estendido, por exemplo, CustomLocation.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-IfMatch
O ETag da transformação.
Omita esse valor para sempre substituir o recurso atual.
Especifique o valor ETag visto pela última vez para evitar a substituição acidental de alterações simultâneas.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-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 são suportados.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-InitialAgentPoolConfiguration
Os pools de agentes criados com esse cluster Kubernetes para executar serviços e cargas de trabalho críticos do sistema.
Esses dados neste campo são usados apenas durante a criação, e o campo ficará vazio após a criação do Cluster Kubernetes.
Após a criação, o gerenciamento de pools de agentes é feito usando o subrecurso agentPools.
Propriedades dos parâmetros
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-JsonFilePath
Caminho do arquivo Json fornecido para a operação Create
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateViaJsonFilePath
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-JsonString
Cadeia de caracteres Json fornecida para a operação Create
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateViaJsonString
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-KubernetesVersion
A versão do Kubernetes para este cluster.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-L2ServiceLoadBalancerConfigurationIPAddressPool
A lista de pools de endereços IP que podem ser alocados para serviços de balanceador de carga.
Propriedades dos parâmetros
Tipo: IIPAddressPool [ ]
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Location
A geolocalização onde o recurso vive
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ManagedResourceGroupConfigurationLocation
O local do grupo de recursos gerenciados.
Se não for especificado, a localização do recurso pai será selecionada.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ManagedResourceGroupConfigurationName
O nome do grupo de recursos gerenciados.
Se não for especificado, o nome exclusivo será gerado automaticamente.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Name
O nome do cluster Kubernetes.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: KubernetesClusterName
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-NetworkConfigurationCloudServicesNetworkId
O ID do recurso da rede de Serviços de Nuvem associada.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-NetworkConfigurationCniNetworkId
O ID de recurso da rede de Camada 3 que é usado para a criação da rede de Interface de Rede de Contêiner.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: 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.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-NetworkConfigurationPodCidr
O IP de notação CIDR varia a partir do qual atribuir IPs pod.
Um CIDR IPv4 é esperado para redes de pilha única.
Dois CIDRs, um para cada família IP (IPv4/IPv6), são esperados para redes de pilha dupla.
Propriedades dos parâmetros
Tipo: String [ ]
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-NetworkConfigurationServiceCidr
O IP de notação CIDR varia a partir do qual atribuir IPs de serviço.
Um CIDR IPv4 é esperado para redes de pilha única.
Dois CIDRs, um para cada família IP (IPv4/IPv6), são esperados para redes de pilha dupla.
Propriedades dos parâmetros
Tipo: String [ ]
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-NoWait
Execute o comando de forma assíncrona
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ResourceGroupName
O nome do grupo de recursos.
O nome não distingue maiúsculas de minúsculas.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-SshPublicKey
A configuração SSH para os sistemas operacionais que executam os nós no cluster Kubernetes.
Em alguns casos, a especificação de chaves públicas pode ser necessária para produzir um ambiente de trabalho.
Propriedades dos parâmetros
Tipo: ISshPublicKey [ ]
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-SubscriptionId
O ID da assinatura de destino.
O valor deve ser um UUID.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: (Get-AzContext).Subscription.Id
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Tag
Tags de recursos.
Propriedades dos parâmetros
Tipo: Hashtable
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
CreateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: Wi
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas