Compartir a través de


Update-AzNetworkCloudAgentPool

Revise las propiedades del grupo de agentes de clúster de Kubernetes proporcionado o actualice las etiquetas asociadas al grupo de agentes de clúster de Kubernetes. Las propiedades y las actualizaciones de etiquetas se pueden realizar de forma independiente.

Sintaxis

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

Revise las propiedades del grupo de agentes de clúster de Kubernetes proporcionado o actualice las etiquetas asociadas al grupo de agentes de clúster de Kubernetes. Las propiedades y las actualizaciones de etiquetas se pueden realizar de forma independiente.

Ejemplos

Ejemplo 1: Actualización del grupo de agentes del clúster de 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 actualiza las propiedades de un grupo de agentes de clúster de Kubernetes.

Parámetros

-AdministratorConfigurationSshPublicKey

SshPublicKey representa la clave pública que se usa para autenticarse con un recurso a través de SSH. Para construir, consulte la sección NOTES de las propiedades ADMINISTRATORCONFIGURATIONSSHPUBLICKEY y cree una tabla hash.

Tipo:ISshPublicKey[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AsJob

Ejecución del comando como trabajo

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Count

Número de máquinas virtuales que usan esta configuración.

Tipo:Int64
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

El parámetro DefaultProfile no es funcional. Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.

Tipo:PSObject
Alias:AzureRMContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Parámetro de identidad Para construir, vea la sección NOTES para las propiedades INPUTOBJECT y crear una tabla hash.

Tipo:INetworkCloudIdentity
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-KubernetesClusterName

Nombre del clúster de Kubernetes.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Nombre del grupo de agentes de clúster de Kubernetes.

Tipo:String
Alias:AgentPoolName
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NoWait

Ejecutar el comando de forma asincrónica

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ResourceGroupName

Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SubscriptionId

Identificador de la suscripción de destino. El valor debe ser un UUID.

Tipo:String
Posición:Named
Valor predeterminado:(Get-AzContext).Subscription.Id
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Tag

Etiquetas de recursos de Azure que reemplazarán las existentes.

Tipo:Hashtable
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UpgradeSettingDrainTimeout

Tiempo máximo en segundos permitido para que se complete un purgado de nodos antes de continuar con la actualización del grupo de agentes. Si no se especifica durante la creación, se usa un valor de 1800 segundos.

Tipo:Int64
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UpgradeSettingMaxSurge

Número máximo o porcentaje de nodos que se sobrecargan durante la actualización. Esto puede establecerse en un entero (por ejemplo, "5") o en un porcentaje (por ejemplo, "50%"). Si se especifica un porcentaje, es el porcentaje del tamaño total del grupo de agentes en el momento de la actualización. En porcentajes, los nodos fraccionarios se redondean hacia arriba. Si no se especifica durante la creación, se usa un valor de 1. Uno de MaxSurge y MaxUnavailable debe ser mayor que 0.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UpgradeSettingMaxUnavailable

Número máximo o porcentaje de nodos que pueden no estar disponibles durante la actualización. Esto puede establecerse en un entero (por ejemplo, "5") o en un porcentaje (por ejemplo, "50%"). Si se especifica un porcentaje, es el porcentaje del tamaño total del grupo de agentes en el momento de la actualización. En porcentajes, los nodos fraccionarios se redondean hacia arriba. Si no se especifica durante la creación, se usa un valor de 0. Uno de MaxSurge y MaxUnavailable debe ser mayor que 0.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

INetworkCloudIdentity

Salidas

IAgentPool