New-AzNetworkCloudAgentPool

Sintaxe

CreateExpanded (Predefinição)

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

Descrição

Exemplos

Exemplo 1: Criar pool de agentes do cluster 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 dos parâmetros

Conjuntos de parâmetros

-AdministratorConfigurationSshPublicKey

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

Conjuntos de parâmetros

-AgentOptionHugepagesCount

O número de páginas enormes para alocar.

Propriedades dos parâmetros

Conjuntos de parâmetros

-AgentOptionHugepagesSize

O tamanho das páginas enormes para alocar.

Propriedades dos parâmetros

Conjuntos de parâmetros

-AsJob

Executar o comando como um trabalho

Propriedades dos parâmetros

Conjuntos de parâmetros

-AttachedNetworkConfigurationL2Network

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-AttachedNetworkConfigurationL3Network

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-AttachedNetworkConfigurationTrunkedNetwork

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-AvailabilityZone

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Count

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-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

Conjuntos de parâmetros

-ExtendedLocationName

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-ExtendedLocationType

O tipo de local estendido, por exemplo, CustomLocation.

Propriedades dos parâmetros

Conjuntos de parâmetros

-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

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 são suportados.

Propriedades dos parâmetros

Conjuntos de parâmetros

-JsonFilePath

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-JsonString

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-KubernetesClusterInputObject

Parâmetro de identidade

Propriedades dos parâmetros

Conjuntos de parâmetros

-KubernetesClusterName

O nome do cluster Kubernetes.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Label

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-Location

A geolocalização onde o recurso vive

Propriedades dos parâmetros

Conjuntos de parâmetros

-Mode

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-Name

O nome do pool de agentes de cluster do Kubernetes.

Propriedades dos parâmetros

Conjuntos de parâmetros

-NoWait

Execute o comando de forma assíncrona

Propriedades dos parâmetros

Conjuntos de parâmetros

-ResourceGroupName

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-SubscriptionId

O ID da assinatura de destino. O valor deve ser um UUID.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Tag

Tags de recursos.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Taint

As manchas aplicadas aos nós neste pool de agentes.

Propriedades dos parâmetros

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 dos parâmetros

Conjuntos de parâmetros

-UpgradeSettingMaxSurge

O número máximo ou a porcentagem de nós que são aumentados durante a atualização. Este valor pode ser definido como um número inteiro (por exemplo, «5») ou uma percentagem (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, os nós fracionários são arredondados para cima. Se não for especificado durante a criação, um valor de 1 é usado. Um dos MaxSurge e MaxUnavailable deve ser maior que 0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-UpgradeSettingMaxUnavailable

O número máximo ou a porcentagem de nós que podem estar indisponíveis durante a atualização. Este valor pode ser definido como um número inteiro (por exemplo, «5») ou uma percentagem (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, os nós fracionários são arredondados para cima. Se não for especificado durante a criação, um valor de 0 é usado. Um dos MaxSurge e MaxUnavailable deve ser maior que 0.

Propriedades dos parâmetros

Conjuntos de parâmetros

-VMSkuName

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-WhatIf

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

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

INetworkCloudIdentity

Saídas

IAgentPool