共用方式為

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

Description

建立新的 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

將在 Kubernetes 叢集上具有系統管理角色的 Azure Active Directory 群組物件標識符清單。

類型: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

要在其中建立資源之擴充位置的資源標識碼。

類型: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位址集區清單。 若要建構，請參閱L2SERVICELOADBALANCERCONFIGURATIONIPADDRESSPOOL屬性的 NOTES 一節，並建立哈希表。

類型: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

相關聯雲端服務網路的資源標識符。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-NetworkConfigurationCniNetworkId

第 3 層網路的資源識別碼，用於建立容器網路介面網路。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-NetworkConfigurationDnsServiceIP

指派給 Kubernetes DNS 服務的 IP 位址。 它必須位於服務 CIDR 中指定的 Kubernetes 服務地址範圍內。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-NetworkConfigurationPodCidr

要從中指派 Pod IP 的 CIDR 表示法IP範圍。 單一堆棧網路應該會有一個 IPv4 CIDR。 兩個 CIDR，每個 IP 系列一個 （IPv4/IPv6），預期雙堆棧網路。

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-NetworkConfigurationServiceCidr

要從中指派服務IP的CIDR表示法IP範圍。 單一堆棧網路應該會有一個 IPv4 CIDR。 兩個 CIDR，每個 IP 系列一個 （IPv4/IPv6），預期雙堆棧網路。

類型: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

目標訂用帳戶的標識碼。 此值必須是 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

輸出