New-AzNetworkCloudAgentPool

Sintaxe

CreateExpanded (Default)

New-AzNetworkCloudAgentPool
    -Name <String>
    -KubernetesClusterName <String>
    -ResourceGroupName <String>
    -Count <Int64>
    -Location <String>
    -Mode <String>
    -VMSkuName <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AdministratorConfigurationAdminUsername <String>]
    [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
    [-AgentOptionHugepagesCount <Int64>]
    [-AgentOptionHugepagesSize <String>]
    [-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
    [-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
    [-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
    [-AvailabilityZone <String[]>]
    [-ExtendedLocationName <String>]
    [-ExtendedLocationType <String>]
    [-Label <IKubernetesLabel[]>]
    [-Tag <Hashtable>]
    [-Taint <IKubernetesLabel[]>]
    [-UpgradeSettingDrainTimeout <Int64>]
    [-UpgradeSettingMaxSurge <String>]
    [-UpgradeSettingMaxUnavailable <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonString

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

CreateViaJsonFilePath

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

CreateViaIdentityKubernetesClusterExpanded

New-AzNetworkCloudAgentPool
    -Name <String>
    -KubernetesClusterInputObject <INetworkCloudIdentity>
    -Count <Int64>
    -Location <String>
    -Mode <String>
    -VMSkuName <String>
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AdministratorConfigurationAdminUsername <String>]
    [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
    [-AgentOptionHugepagesCount <Int64>]
    [-AgentOptionHugepagesSize <String>]
    [-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
    [-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
    [-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
    [-AvailabilityZone <String[]>]
    [-ExtendedLocationName <String>]
    [-ExtendedLocationType <String>]
    [-Label <IKubernetesLabel[]>]
    [-Tag <Hashtable>]
    [-Taint <IKubernetesLabel[]>]
    [-UpgradeSettingDrainTimeout <Int64>]
    [-UpgradeSettingMaxSurge <String>]
    [-UpgradeSettingMaxUnavailable <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1: criar o pool de agentes do cluster do Kubernetes

$networkAttachment = @{
        AttachedNetworkId = "l3NetworkId"
    }
    $labels = @{
        Key = "key"
        Value = "value"
    }
    $taints = @{
        Key = "key"
        Value = "value"
    }
    $sshPublicKey = @{
        KeyData = "ssh-rsa aaaKyfsdx= fakekey@vm"
    }

    New-AzNetworkCloudAgentPool -KubernetesClusterName clusterName -Name agentPoolName -ResourceGroupName resourceGroup -Count count -Location location -Mode agentPoolMode -VMSkuName vmSkuName -SubscriptionId subscriptionId -AdministratorConfigurationAdminUsername adminUsername -AdministratorConfigurationSshPublicKey $sshPublicKey -AgentOptionHugepagesCount hugepagesCount -AgentOptionHugepagesSize hugepagesSize -AttachedNetworkConfigurationL3Network $networkAttachment -AvailabilityZone availabilityZones -ExtendedLocationName clusterExtendedLocation -ExtendedLocationType "CustomLocation " -Tag @{tags = "tag"} -Label $labels -Taint $taints -UpgradeSettingMaxSurge maxSurge

Location  Name           SystemDataCreatedAt SystemDataCreatedBy    SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy
--------       ----                -------------------              -------------------                   -----------------------                    ------------------------                ------------
westus3  agentpool1 07/18/2023 17:44:02 <identity>                            User                                            07/18/2023 17:46:45         <identity>

Parâmetros

-AdministratorConfigurationAdminUsername

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

-AdministratorConfigurationSshPublicKey

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

-AgentOptionHugepagesCount

O número de páginas enormes a serem alocadas.

Propriedades do parâmetro

Conjuntos de parâmetros

-AgentOptionHugepagesSize

O tamanho das páginas enormes a serem alocadas.

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

-AvailabilityZone

A lista de zonas de disponibilidade do cluster de Nuvem de Rede usada para o provisionamento de nós neste pool de agentes. Se não for especificado, todas as zonas de disponibilidade serão usadas.

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

-Count

O número de máquinas virtuais que usam essa configuraçã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

-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

-KubernetesClusterInputObject

Parâmetro de identidade

Propriedades do parâmetro

Conjuntos de parâmetros

-KubernetesClusterName

O nome do cluster do Kubernetes.

Propriedades do parâmetro

Conjuntos de parâmetros

-Label

Os rótulos aplicados aos nós neste pool de agentes.

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

-Mode

A seleção de como esse pool de agentes é utilizado, seja como um pool de sistemas ou um pool de usuários. Os pools de sistema executam os recursos e os serviços críticos para o Cluster do Kubernetes, enquanto os pools de usuários são dedicados a cargas de trabalho do usuário. Cada cluster do Kubernetes deve conter pelo menos um pool de nós do sistema com pelo menos um nó.

Propriedades do parâmetro

Conjuntos de parâmetros

-Name

O nome do pool de agentes de cluster do Kubernetes.

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

-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

-Taint

Os taints aplicados aos nós neste pool de agentes.

Propriedades do parâmetro

Conjuntos de parâmetros

-UpgradeSettingDrainTimeout

O tempo máximo em segundos permitido para que um dreno de nó seja concluído antes de prosseguir com a atualização do pool de agentes. Se não for especificado durante a criação, um valor de 1800 segundos será usado.

Propriedades do parâmetro

Conjuntos de parâmetros

-UpgradeSettingMaxSurge

O número máximo ou percentual de nós que são aumentados durante a atualização. Isso pode ser definido como um inteiro (por exemplo, '5') ou uma porcentagem (por exemplo, '50%'). Se uma porcentagem for especificada, será a porcentagem do tamanho total do pool de agentes no momento da atualização. Para porcentagens, nós fracionários são arredondados para cima. Se não for especificado durante a criação, um valor de 1 será usado. Um dos MaxSurge e MaxUnavailable deve ser maior que 0.

Propriedades do parâmetro

Conjuntos de parâmetros

-UpgradeSettingMaxUnavailable

O número máximo ou percentual de nós que podem ficar indisponíveis durante a atualização. Isso pode ser definido como um inteiro (por exemplo, '5') ou uma porcentagem (por exemplo, '50%'). Se uma porcentagem for especificada, será a porcentagem do tamanho total do pool de agentes no momento da atualização. Para porcentagens, nós fracionários são arredondados para cima. Se não for especificado durante a criação, um valor de 0 será usado. Um dos MaxSurge e MaxUnavailable deve ser maior que 0.

Propriedades do parâmetro

Conjuntos de parâmetros

-VMSkuName

O nome da SKU da VM que determina o tamanho dos recursos alocados para VMs de nó.

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

Entradas

INetworkCloudIdentity

Saídas

IAgentPool