Update-AzNetworkCloudAgentPool

Módulo:

Az.NetworkCloud Module

Corrija as propriedades do pool de agentes de cluster do Kubernetes fornecido ou atualize as tags associadas ao pool de agentes de cluster do Kubernetes. As propriedades e a atualização de etiquetas podem ser feitas de forma independente.

Sintaxe

UpdateExpanded (Predefinição)

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

UpdateViaJsonString

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

UpdateViaJsonFilePath

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

UpdateViaIdentityKubernetesClusterExpanded

Update-AzNetworkCloudAgentPool
    -Name <String>
    -KubernetesClusterInputObject <INetworkCloudIdentity>
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
    [-Count <Int64>]
    [-Tag <Hashtable>]
    [-UpgradeSettingDrainTimeout <Int64>]
    [-UpgradeSettingMaxSurge <String>]
    [-UpgradeSettingMaxUnavailable <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaIdentityExpanded

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

Descrição

Corrija as propriedades do pool de agentes de cluster do Kubernetes fornecido ou atualize as tags associadas ao pool de agentes de cluster do Kubernetes. As propriedades e a atualização de etiquetas podem ser feitas de forma independente.

Exemplos

Exemplo 1: Atualizar o pool de agentes do cluster 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>

Este 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 de SSH.

Propriedades dos parâmetros

Tipo:	ISshPublicKey[]
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

UpdateExpanded

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaIdentityKubernetesClusterExpanded

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaIdentityExpanded

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

-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

-Count

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

UpdateExpanded

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaIdentityKubernetesClusterExpanded

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaIdentityExpanded

Posto:	Named
Obrigatório:	False
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

-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

-InputObject

Parâmetro de identidade

Propriedades dos parâmetros

Tipo:	INetworkCloudIdentity
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

UpdateViaIdentityExpanded

Posto:	Named
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-JsonFilePath

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

Propriedades dos parâmetros

Tipo:	String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

UpdateViaJsonFilePath

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 Update

Propriedades dos parâmetros

Tipo:	String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

UpdateViaJsonString

Posto:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-KubernetesClusterInputObject

Parâmetro de identidade

Propriedades dos parâmetros

Tipo:	INetworkCloudIdentity
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

UpdateViaIdentityKubernetesClusterExpanded

Posto:	Named
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-KubernetesClusterName

O nome do cluster Kubernetes.

Propriedades dos parâmetros

Tipo:	String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

UpdateExpanded

Posto:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaJsonString

Posto:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaJsonFilePath

Posto:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Name

O nome do pool de agentes de cluster do Kubernetes.

Propriedades dos parâmetros

Tipo:	String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	AgentPoolName

Conjuntos de parâmetros

UpdateExpanded

Posto:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaJsonString

Posto:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaJsonFilePath

Posto:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaIdentityKubernetesClusterExpanded

Posto:	Named
Obrigatório:	True
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 diferencia 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

UpdateExpanded

Posto:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaJsonString

Posto:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaJsonFilePath

Posto:	Named
Obrigatório:	True
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

UpdateExpanded

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaJsonString

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaJsonFilePath

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Tag

As etiquetas de recursos do Azure que vão substituir as existentes.

Propriedades dos parâmetros

Tipo:	Hashtable
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

UpdateExpanded

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaIdentityKubernetesClusterExpanded

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaIdentityExpanded

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	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.

Propriedades dos parâmetros

Tipo:	Int64
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

UpdateExpanded

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaIdentityKubernetesClusterExpanded

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaIdentityExpanded

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-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

Tipo:	String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

UpdateExpanded

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaIdentityKubernetesClusterExpanded

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaIdentityExpanded

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-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

Tipo:	String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

UpdateExpanded

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaIdentityKubernetesClusterExpanded

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

UpdateViaIdentityExpanded

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.

Entradas

INetworkCloudIdentity

Saídas

IAgentPool