你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Update-AzNetworkCloudAgentPool

模块:

Az.NetworkCloud

修补提供的 Kubernetes 群集代理池的属性，或更新与 Kubernetes 群集代理池关联的标记。 属性和标记更新可以独立完成。

语法

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

说明

修补提供的 Kubernetes 群集代理池的属性，或更新与 Kubernetes 群集代理池关联的标记。 属性和标记更新可以独立完成。

示例

示例 1：更新 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>

此命令更新 Kubernetes 群集代理池的属性。

参数

-AdministratorConfigurationSshPublicKey

SshPublicKey 表示用于通过 SSH 向资源进行身份验证的公钥。 若要构造，请参阅 ADMINISTRATORCONFIGURATIONSSHPUBLICKEY 属性的 NOTES 部分，并创建哈希表。

类型:	ISshPublicKey[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AsJob

以作业身份运行命令

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Count

使用此配置的虚拟机数。

类型:	Int64
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

DefaultProfile 参数不起作用。 如果对其他订阅执行 cmdlet，请使用 SubscriptionId 参数。

类型:	PSObject
别名:	AzureRMContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InputObject

要构造的标识参数，请参阅 INPUTOBJECT 属性的 NOTES 部分并创建哈希表。

类型:	INetworkCloudIdentity
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-KubernetesClusterName

Kubernetes 群集的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Name

Kubernetes 群集代理池的名称。

类型:	String
别名:	AgentPoolName
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-NoWait

异步运行命令

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

资源组的名称。 名称不区分大小写。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SubscriptionId

目标订阅的 ID。 该值必须是 UUID。

类型:	String
Position:	Named
默认值:	(Get-AzContext).Subscription.Id
必需:	False
接受管道输入:	False
接受通配符:	False

-Tag

将替换现有标记的 Azure 资源标记。

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UpgradeSettingDrainTimeout

在继续升级代理池之前，节点耗尽完成的最长时间（以秒为单位）。 如果在创建期间未指定，则使用值 1800 秒。

类型:	Int64
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UpgradeSettingMaxSurge

升级期间激增的最大节点数或百分比。 这可以设置为整数（例如'5'）或百分比（例如'50%'）。 如果指定了百分比，则它是升级时代理池大小总数的百分比。 对于百分比，小数节点向上舍入。 如果在创建期间未指定，则使用值 1。 MaxSurge 和 MaxUnavailable 之一必须大于 0。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UpgradeSettingMaxUnavailable

在升级期间不可用的最大节点数或百分比。 这可以设置为整数（例如'5'）或百分比（例如'50%'）。 如果指定了百分比，则它是升级时代理池大小总数的百分比。 对于百分比，小数节点向上舍入。 如果在创建过程中未指定，则使用值 0。 MaxSurge 和 MaxUnavailable 之一必须大于 0。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

INetworkCloudIdentity

输出

IAgentPool