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

New-AzNetworkCloudKubernetesCluster

模块:

Az.NetworkCloud

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

语法

New-AzNetworkCloudKubernetesCluster
   -KubernetesClusterName <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -ControlPlaneNodeConfigurationCount <Int64>
   -ControlPlaneNodeConfigurationVMSkuName <String>
   -ExtendedLocationName <String>
   -ExtendedLocationType <String>
   -InitialAgentPoolConfiguration <IInitialAgentPoolConfiguration[]>
   -KubernetesVersion <String>
   -Location <String>
   -NetworkConfigurationCloudServicesNetworkId <String>
   -NetworkConfigurationCniNetworkId <String>
   [-AadConfigurationAdminGroupObjectId <String[]>]
   [-AdminUsername <String>]
   [-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
   [-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
   [-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
   [-BgpAdvertisement <IBgpAdvertisement[]>]
   [-BgpIPAddressPool <IIPAddressPool[]>]
   [-BgpPeer <IServiceLoadBalancerBgpPeer[]>]
   [-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled <FabricPeeringEnabled>]
   [-ControlPlaneNodeConfigurationAdminPublicKey <ISshPublicKey[]>]
   [-ControlPlaneNodeConfigurationAdminUsername <String>]
   [-ControlPlaneNodeConfigurationAvailabilityZone <String[]>]
   [-L2ServiceLoadBalancerConfigurationIPAddressPool <IIPAddressPool[]>]
   [-ManagedResourceGroupConfigurationLocation <String>]
   [-ManagedResourceGroupConfigurationName <String>]
   [-NetworkConfigurationDnsServiceIP <String>]
   [-NetworkConfigurationPodCidr <String[]>]
   [-NetworkConfigurationServiceCidr <String[]>]
   [-SshPublicKey <ISshPublicKey[]>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

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

示例

示例 1：创建 Kubernetes 群集

$tagHash = @{tags = "tag1" }
$agentPoolConfiguration = @{
    count = 1
    mode = "System"
    name = "agentPoolName"
    vmSkuName = "vmSkuName"
    administratorConfiguration = "administratorConfiguration"
}
$sshPublicKey = @{
    KeyData = "ssh-rsa aaaKyfsdx= fakekey@vm"
}
New-AzNetworkCloudKubernetesCluster -ResourceGroupName resourceGroupName `
                -KubernetesClusterName default -Location location `
                -ExtendedLocationName extendedLocationName `
                -ExtendedLocationType "CustomLocation" `
                -KubernetesVersion kubernetesVersion `
                -AadConfigurationAdminGroupObjectId adminGroupObjectIds `
                -AdminUsername "azureuser" `
                -SshPublicKey $sshPublicKey `
                -InitialAgentPoolConfiguration $agentPoolConfiguration `
                -NetworkConfigurationCloudServicesNetworkId cloudServicesNetworkId `
                -NetworkConfigurationCniNetworkId cniNetworkId `
                -SubscriptionId subscriptionId `
                -Tag $tagHash

Location Name    SystemDataCreatedAt SystemDataCreatedBy    SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy             SystemDataLastModifiedByType ResourceGroupName
-------- ----    ------------------- -------------------    ----------------------- ------------------------ ------------------------             ---------------------------- -----------------
eastus   default 08/09/2023 20:23:17 <identity>             User                    08/09/2023 20:44:27      <identity>                            Application                 resourceGroupName

此命令创建 Kubernetes 群集。

参数

-AadConfigurationAdminGroupObjectId

Azure Active Directory 组对象 ID 的列表，这些 ID 将在 Kubernetes 群集上具有管理角色。

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

-AdminUsername

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

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

-BgpAdvertisement

IP 地址池与社区和对等方关联，允许宣布 IP。 若要构造，请参阅 BGPADVERTISEMENT 属性的 NOTES 部分并创建哈希表。

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

-BgpIPAddressPool

可分配给负载均衡器服务的 IP 地址池的列表。 若要构造，请参阅 BGPIPADDRESSPOOL 属性的 NOTES 部分并创建哈希表。

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

-BgpPeer

Kubernetes 群集将与之对等的其他 BgpPeer 实体的列表。 必须显式定义所有对等互连。 若要构造，请参阅 BGPPEER 属性的 NOTES 部分并创建哈希表。

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

-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled

用于指定负载均衡器是否与网络构造对等互连的指示器。

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

-Confirm

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

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

-ControlPlaneNodeConfigurationAdminPublicKey

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

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

-ControlPlaneNodeConfigurationAdminUsername

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

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

-ControlPlaneNodeConfigurationAvailabilityZone

要用于在控制平面中预配节点的网络云群集的可用性区域列表。 如果未指定，将使用所有可用性区域。

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

-ControlPlaneNodeConfigurationCount

使用此配置的虚拟机数。

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

-ControlPlaneNodeConfigurationVMSkuName

创建期间提供的 VM SKU 的名称。

类型:	String
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
必需:	True
接受管道输入:	False
接受通配符:	False

-ExtendedLocationType

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

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

-InitialAgentPoolConfiguration

使用此 Kubernetes 群集创建的代理池，用于运行关键系统服务和工作负荷。 此字段中的此数据仅在创建过程中使用，在创建 Kubernetes 群集后，该字段将为空。 创建后，使用 agentPools 子资源完成代理池的管理。 若要构造，请参阅 INITIALAGENTPOOLCONFIGURATION 属性的 NOTES 部分，并创建哈希表。

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

-KubernetesClusterName

Kubernetes 群集的名称。

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

-KubernetesVersion

此群集的 Kubernetes 版本。

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

-L2ServiceLoadBalancerConfigurationIPAddressPool

可分配给负载均衡器服务的 IP 地址池的列表。 若要构造，请参阅 NOTES 部分，了解L2SERVICELOADBALANCERCONFIGURATIONIPADDRESSPOOL属性并创建哈希表。

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

-Location

资源所在的地理位置

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

-ManagedResourceGroupConfigurationLocation

托管资源组的位置。 如果未指定，则选择父资源的位置。

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

-ManagedResourceGroupConfigurationName

托管资源组的名称。 如果未指定，则自动生成唯一名称。

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

-NetworkConfigurationCloudServicesNetworkId

关联的云服务网络的资源 ID。

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

-NetworkConfigurationCniNetworkId

用于创建容器网络接口网络的第 3 层网络的资源 ID。

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

-NetworkConfigurationDnsServiceIP

分配给 Kubernetes DNS 服务的 IP 地址。 它必须位于服务 CIDR 中指定的 Kubernetes 服务地址范围内。

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

-NetworkConfigurationPodCidr

CIDR 表示法 IP 范围，从中分配 Pod IP。 单堆栈网络需要一个 IPv4 CIDR。 对于双堆栈网络，每个 IP 系列（IPv4/IPv6）都有两个CIDR。

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

-NetworkConfigurationServiceCidr

要从中分配服务 IP 的 CIDR 表示法 IP 范围。 单堆栈网络需要一个 IPv4 CIDR。 对于双堆栈网络，每个 IP 系列（IPv4/IPv6）都有两个CIDR。

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

-NoWait

异步运行命令

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

-ResourceGroupName

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

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

-SshPublicKey

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

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

-SubscriptionId

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

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

-Tag

资源标记。

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

-WhatIf

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

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

输出

IKubernetesCluster