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

New-AzNetworkCloudAgentPool

模块:

Az.NetworkCloud

创建新的 Kubernetes 群集代理池或更新现有池的属性。

语法

New-AzNetworkCloudAgentPool
   -KubernetesClusterName <String>
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Count <Int64>
   -Location <String>
   -Mode <AgentPoolMode>
   -VMSkuName <String>
   [-AdministratorConfigurationAdminUsername <String>]
   [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
   [-AgentOptionHugepagesCount <Int64>]
   [-AgentOptionHugepagesSize <HugepagesSize>]
   [-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
   [-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
   [-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
   [-AvailabilityZone <String[]>]
   [-ExtendedLocationName <String>]
   [-ExtendedLocationType <String>]
   [-Label <IKubernetesLabel[]>]
   [-Tag <Hashtable>]
   [-Taint <IKubernetesLabel[]>]
   [-UpgradeSettingDrainTimeout <Int64>]
   [-UpgradeSettingMaxSurge <String>]
   [-UpgradeSettingMaxUnavailable <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

创建新的 Kubernetes 群集代理池或更新现有池的属性。

示例

示例 1：创建 Kubernetes 群集的代理池

$networkAttachment = @{
        AttachedNetworkId = "l3NetworkId"
    }
    $labels = @{
        Key = "key"
        Value = "value"
    }
    $taints = @{
        Key = "key"
        Value = "value"
    }
    $sshPublicKey = @{
        KeyData = "ssh-rsa aaaKyfsdx= fakekey@vm"
    }

    New-AzNetworkCloudAgentPool -KubernetesClusterName clusterName -Name agentPoolName -ResourceGroupName resourceGroup -Count count -Location location -Mode agentPoolMode -VMSkuName vmSkuName -SubscriptionId subscriptionId -AdministratorConfigurationAdminUsername adminUsername -AdministratorConfigurationSshPublicKey $sshPublicKey -AgentOptionHugepagesCount hugepagesCount -AgentOptionHugepagesSize hugepagesSize -AttachedNetworkConfigurationL3Network $networkAttachment -AvailabilityZone availabilityZones -ExtendedLocationName clusterExtendedLocation -ExtendedLocationType "CustomLocation " -Tag @{tags = "tag"} -Label $labels -Taint $taints -UpgradeSettingMaxSurge maxSurge

Location  Name           SystemDataCreatedAt SystemDataCreatedBy    SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy
--------       ----                -------------------              -------------------                   -----------------------                    ------------------------                ------------
westus3  agentpool1 07/18/2023 17:44:02 <identity>                            User                                            07/18/2023 17:46:45         <identity>

此命令为给定的 Kubernetes 群集创建代理池。

参数

-AdministratorConfigurationAdminUsername

将应用于运行 Kubernetes 节点的作系统的管理员的用户名。 如果未提供，服务将选择用户名。

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

-AdministratorConfigurationSshPublicKey

在 Kubernetes 群集中运行节点的作系统的 SSH 配置。 在某些情况下，可能需要公钥规范才能生成工作环境。 若要构造，请参阅 ADMINISTRATORCONFIGURATIONSSHPUBLICKEY 属性的 NOTES 部分，并创建哈希表。

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

-AgentOptionHugepagesCount

要分配的巨页数。

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

-AgentOptionHugepagesSize

要分配的巨页的大小。

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

-AsJob

以作业身份运行命令

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

-AttachedNetworkConfigurationL2Network

第 2 层网络和相关附件配置的列表。 若要构造，请参阅 notes 部分，了解ATTACHEDNETWORKCONFIGURATIONL2NETWORK属性并创建哈希表。

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

-AttachedNetworkConfigurationL3Network

第 3 层网络和相关附件配置的列表。 若要构造，请参阅有关ATTACHEDNETWORKCONFIGURATIONL3NETWORK属性的 NOTES 部分，并创建哈希表。

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

-AttachedNetworkConfigurationTrunkedNetwork

中继网络和相关附件配置的列表。 若要构造，请参阅 ATTACHEDNETWORKCONFIGURATIONTRUNKEDNETWORK 属性的 NOTES 部分，并创建哈希表。

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

-AvailabilityZone

用于在此代理池中预配节点的网络云群集的可用性区域列表。 如果未指定，将使用所有可用性区域。

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

-Confirm

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

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

-Count

使用此配置的虚拟机数。

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

-DefaultProfile

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

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

-ExtendedLocationName

要在其中创建资源的扩展位置的资源 ID。

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

-ExtendedLocationType

扩展的位置类型，例如 CustomLocation。

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

-KubernetesClusterName

Kubernetes 群集的名称。

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

-Label

应用于此代理池中的节点的标签。 若要构造，请参阅 LABEL 属性的 NOTES 部分并创建哈希表。

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

-Location

资源所在的地理位置

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

-Mode

选择此代理池作为系统池或用户池的方式。 系统池运行 Kubernetes 群集的功能和关键服务，而用户池则专用于用户工作负荷。 每个 Kubernetes 群集必须至少包含一个具有至少一个节点的系统节点池。

类型:	AgentPoolMode
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

资源标记。

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

-Taint

应用于此代理池中的节点的污点。 若要构造，请参阅 TAINT 属性的 NOTES 部分并创建哈希表。

类型:	IKubernetesLabel[]
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

-VMSkuName

确定为节点 VM 分配的资源大小的 VM SKU 的名称。

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

-WhatIf

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

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

输出

IAgentPool