Compartilhar via


Update-AzNetworkCloudAgentPool

Corrija as propriedades do pool de agentes de cluster do Kubernetes fornecido ou atualize as marcas associadas ao pool de agentes de cluster do Kubernetes. As propriedades e as atualizações de marca podem ser feitas de forma independente.

Sintaxe

Update-AzNetworkCloudAgentPool
      -KubernetesClusterName <String>
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
      [-Count <Int64>]
      [-Tag <Hashtable>]
      [-UpgradeSettingDrainTimeout <Int64>]
      [-UpgradeSettingMaxSurge <String>]
      [-UpgradeSettingMaxUnavailable <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzNetworkCloudAgentPool
      -InputObject <INetworkCloudIdentity>
      [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
      [-Count <Int64>]
      [-Tag <Hashtable>]
      [-UpgradeSettingDrainTimeout <Int64>]
      [-UpgradeSettingMaxSurge <String>]
      [-UpgradeSettingMaxUnavailable <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Corrija as propriedades do pool de agentes de cluster do Kubernetes fornecido ou atualize as marcas associadas ao pool de agentes de cluster do Kubernetes. As propriedades e as atualizações de marca podem ser feitas de forma independente.

Exemplos

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

Update-AzNetworkCloudAgentPool -Name agentPoolName -KubernetesClusterName clusterName -ResourceGroupName resourceGroup -Count updatedCount -Tag @{tags = "newTag"} -UpgradeSettingMaxSurge updatedMaxSurge

Location Name           SystemDataCreatedAt SystemDataCreatedBy    SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy
--------      ----                -------------------               -------------------                  -----------------------                   ------------------------                  --
westus3  agentpool1 07/17/2023 18:14:59 <identity>                           Application                              07/18/2023 17:06:24           <identity>

Esse comando atualiza as propriedades de um pool de agentes de cluster do Kubernetes.

Parâmetros

-AdministratorConfigurationSshPublicKey

SshPublicKey representa a chave pública usada para autenticar com um recurso por meio do SSH. Para construir, consulte a seção NOTES para propriedades ADMINISTRATORCONFIGURATIONSSHPUBLICKEY 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

-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

-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

-Count

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

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
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

-InputObject

Parâmetro de identidade Para construir, consulte a seção NOTES para propriedades INPUTOBJECT e crie uma tabela de hash.

Tipo:INetworkCloudIdentity
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
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

-Name

O nome do pool de agentes de cluster do Kubernetes.

Tipo:String
Aliases:AgentPoolName
Cargo:Named
Valor padrão:None
Obrigatório:True
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

-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

As marcas de recurso do Azure que substituirão as existentes.

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

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

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

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

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

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

Tipo:String
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

Entradas

Saídas