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
Azure PowerShell