通过

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

New-AzNetworkCloudKubernetesCluster

模块:
Az.NetworkCloud Module

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

语法

CreateExpanded (默认值) 

New-AzNetworkCloudKubernetesCluster
    -Name <String>
    -ResourceGroupName <String>
    -ControlPlaneNodeConfigurationCount <Int64>
    -ControlPlaneNodeConfigurationVMSkuName <String>
    -ExtendedLocationName <String>
    -ExtendedLocationType <String>
    -InitialAgentPoolConfiguration <IInitialAgentPoolConfiguration[]>
    -KubernetesVersion <String>
    -Location <String>
    -NetworkConfigurationCloudServicesNetworkId <String>
    -NetworkConfigurationCniNetworkId <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AadConfigurationAdminGroupObjectId <String[]>]
    [-AdminUsername <String>]
    [-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
    [-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
    [-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
    [-BgpAdvertisement <IBgpAdvertisement[]>]
    [-BgpIPAddressPool <IIPAddressPool[]>]
    [-BgpPeer <IServiceLoadBalancerBgpPeer[]>]
    [-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled <String>]
    [-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>]

CreateViaJsonFilePath 

New-AzNetworkCloudKubernetesCluster
    -Name <String>
    -ResourceGroupName <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonString 

New-AzNetworkCloudKubernetesCluster
    -Name <String>
    -ResourceGroupName <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-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[]

默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-AdminUsername

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-AsJob

以作业身份运行命令

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-AttachedNetworkConfigurationL2Network

第 2 层网络和相关附件配置的列表。

参数属性

类型:

IL2NetworkAttachmentConfiguration[]

默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-AttachedNetworkConfigurationL3Network

第 3 层网络和相关附件配置的列表。

参数属性

类型:

IL3NetworkAttachmentConfiguration[]

默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-AttachedNetworkConfigurationTrunkedNetwork

中继网络和相关附件配置的列表。

参数属性

类型:

ITrunkedNetworkAttachmentConfiguration[]

默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-BgpAdvertisement

IP 地址池与社区和对等方关联，允许宣布 IP。

参数属性

类型:

IBgpAdvertisement[]

默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-BgpIPAddressPool

可分配给负载均衡器服务的 IP 地址池的列表。

参数属性

类型:

IIPAddressPool[]

默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-BgpPeer

Kubernetes 群集将与之对等的其他 BgpPeer 实体的列表。 必须显式定义所有对等互连。

参数属性

类型:

IServiceLoadBalancerBgpPeer[]

默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Confirm

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ControlPlaneNodeConfigurationAdminPublicKey

在 Kubernetes 群集中运行节点的操作系统的 SSH 配置。 在某些情况下，可能需要公钥规范才能生成工作环境。

参数属性

类型:

ISshPublicKey[]

默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ControlPlaneNodeConfigurationAdminUsername

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ControlPlaneNodeConfigurationAvailabilityZone

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

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ControlPlaneNodeConfigurationCount

使用此配置的虚拟机数。

参数属性

类型:Int64
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ControlPlaneNodeConfigurationVMSkuName

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DefaultProfile

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

参数属性

类型:PSObject
默认值:None
支持通配符:False
不显示:False
别名:AzureRMContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ExtendedLocationName

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ExtendedLocationType

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-IfMatch

转换的 ETag。 省略此值以始终覆盖当前资源。 指定最后一次看到的 ETag 值，以防止意外覆盖并发更改。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-IfNoneMatch

设置为“*”以允许创建新记录集，但要防止更新现有资源。 其他值将导致服务器出错，因为它们不受支持。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-InitialAgentPoolConfiguration

使用此 Kubernetes 群集创建的代理池，用于运行关键系统服务和工作负荷。 此字段中的此数据仅在创建过程中使用，在创建 Kubernetes 群集后，该字段将为空。 创建后，使用 agentPools 子资源完成代理池的管理。

参数属性

类型:

IInitialAgentPoolConfiguration[]

默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-JsonFilePath

提供给“创建”操作的 Json 文件的路径

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateViaJsonFilePath
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-JsonString

提供给“创建”操作的 Json 字符串

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateViaJsonString
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-KubernetesVersion

此群集的 Kubernetes 版本。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-L2ServiceLoadBalancerConfigurationIPAddressPool

可分配给负载均衡器服务的 IP 地址池的列表。

参数属性

类型:

IIPAddressPool[]

默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Location

资源所在的地理位置

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ManagedResourceGroupConfigurationLocation

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ManagedResourceGroupConfigurationName

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Name

Kubernetes 群集的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:KubernetesClusterName

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-NetworkConfigurationCloudServicesNetworkId

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-NetworkConfigurationCniNetworkId

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-NetworkConfigurationDnsServiceIP

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-NetworkConfigurationPodCidr

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

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-NetworkConfigurationServiceCidr

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

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-NoWait

异步运行命令

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ResourceGroupName

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SshPublicKey

在 Kubernetes 群集中运行节点的操作系统的 SSH 配置。 在某些情况下，可能需要公钥规范才能生成工作环境。

参数属性

类型:

ISshPublicKey[]

默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SubscriptionId

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

参数属性

类型:String
默认值:(Get-AzContext).Subscription.Id
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Tag

资源标记。

参数属性

类型:Hashtable
默认值:None
支持通配符:False
不显示:False

参数集

CreateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输出

IKubernetesCluster