New-AzNetworkCloudKubernetesCluster

新しい Kubernetes クラスターを作成するか、既存の 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 クラスターを作成するか、既存の 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 グループ オブジェクト ID の一覧。

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-AdminUsername

Kubernetes ノードを実行するオペレーティング システムに適用される管理者のユーザー名。 指定しない場合は、サービスによってユーザー名が選択されます。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-AsJob

コマンドをジョブとして実行する

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-AttachedNetworkConfigurationL2Network

レイヤー 2 ネットワークと添付ファイルの関連構成の一覧。

パラメーターのプロパティ

型:

IL2NetworkAttachmentConfiguration[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-AttachedNetworkConfigurationL3Network

レイヤー 3 ネットワークと添付ファイルの関連する構成の一覧。

パラメーターのプロパティ

型:

IL3NetworkAttachmentConfiguration[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-AttachedNetworkConfigurationTrunkedNetwork

トランクされたネットワークと添付ファイルの関連する構成の一覧。

パラメーターのプロパティ

型:

ITrunkedNetworkAttachmentConfiguration[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-BgpAdvertisement

IP アドレス プールをコミュニティとピアに関連付け、IP の発表を可能にします。

パラメーターのプロパティ

型:

IBgpAdvertisement[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-BgpIPAddressPool

ロード バランサー サービスに割り当てることができる IP アドレスのプールの一覧。

パラメーターのプロパティ

型:

IIPAddressPool[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-BgpPeer

Kubernetes クラスターがピアリングする追加の BgpPeer エンティティの一覧。 すべてのピアリングを明示的に定義する必要があります。

パラメーターのプロパティ

型:

IServiceLoadBalancerBgpPeer[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-BgpServiceLoadBalancerConfigurationFabricPeeringEnabled

ロード バランサーがネットワーク ファブリックとピアリングするかどうかを指定するインジケーター。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ControlPlaneNodeConfigurationAdminPublicKey

Kubernetes クラスター内のノードを実行するオペレーティング システムの SSH 構成。 場合によっては、作業環境を生成するために公開キーの指定が必要になる場合があります。

パラメーターのプロパティ

型:

ISshPublicKey[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ControlPlaneNodeConfigurationAdminUsername

Kubernetes ノードを実行するオペレーティング システムに適用される管理者のユーザー名。 指定しない場合は、サービスによってユーザー名が選択されます。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ControlPlaneNodeConfigurationAvailabilityZone

コントロール プレーン内のノードのプロビジョニングに使用するネットワーク クラウド クラスターの可用性ゾーンの一覧。 指定しない場合は、すべての可用性ゾーンが使用されます。

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ControlPlaneNodeConfigurationCount

この構成を使用する仮想マシンの数。

パラメーターのプロパティ

型:Int64
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ControlPlaneNodeConfigurationVMSkuName

作成時に指定された VM SKU の名前。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DefaultProfile

DefaultProfile パラメーターは機能しません。 別のサブスクリプションに対してコマンドレットを実行する場合は、使用可能な場合は SubscriptionId パラメーターを使用します。

パラメーターのプロパティ

型:PSObject
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzureRMContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ExtendedLocationName

リソースが作成される拡張された場所のリソース ID。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ExtendedLocationType

拡張された場所の種類 (CustomLocation など)。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-IfMatch

変換の ETag。 現在のリソースを常に上書きするには、この値を省略します。 同時変更が誤って上書きされないように、最後に表示された ETag 値を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-IfNoneMatch

新しいレコード セットの作成を許可するが、既存のリソースを更新できないようにするには、'*' に設定します。 その他の値はサポートされていないため、サーバーからエラーが発生します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-InitialAgentPoolConfiguration

重要なシステム サービスとワークロードを実行するために、この Kubernetes クラスターで作成されたエージェント プール。 このフィールドのこのデータは作成時にのみ使用され、Kubernetes クラスターの作成後、フィールドは空になります。 作成後、エージェント プールの管理は agentPools サブリソースを使用して行われます。

パラメーターのプロパティ

型:

IInitialAgentPoolConfiguration[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-JsonFilePath

作成操作に指定された Json ファイルのパス

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateViaJsonFilePath
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-JsonString

作成操作に指定された Json 文字列

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateViaJsonString
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-KubernetesVersion

このクラスターの Kubernetes バージョン。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-L2ServiceLoadBalancerConfigurationIPAddressPool

ロード バランサー サービスに割り当てることができる IP アドレスのプールの一覧。

パラメーターのプロパティ

型:

IIPAddressPool[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Location

リソースが存在する地理的な場所

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ManagedResourceGroupConfigurationLocation

マネージド リソース グループの場所。 指定しない場合は、親リソースの場所が選択されます。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ManagedResourceGroupConfigurationName

マネージド リソース グループの名前。 指定しない場合、一意の名前が自動的に生成されます。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Name

Kubernetes クラスターの名前。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:KubernetesClusterName

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-NetworkConfigurationCloudServicesNetworkId

関連付けられている Cloud Services ネットワークのリソース ID。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-NetworkConfigurationCniNetworkId

コンテナー ネットワーク インターフェイス ネットワークの作成に使用されるレイヤー 3 ネットワークのリソース ID。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-NetworkConfigurationDnsServiceIP

Kubernetes DNS サービスに割り当てられた IP アドレス。 これは、サービス CIDR で指定された Kubernetes サービス アドレス範囲内にある必要があります。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-NetworkConfigurationPodCidr

ポッド IP の割り当て元となる CIDR 表記 IP 範囲。 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークでは、2 つの CIDR (各 IP ファミリ (IPv4/IPv6) に 1 つ) が必要です。

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-NetworkConfigurationServiceCidr

サービス IP の割り当て元となる CIDR 表記 IP 範囲。 単一スタック ネットワークでは、1 つの IPv4 CIDR が必要です。 デュアルスタック ネットワークでは、2 つの CIDR (各 IP ファミリ (IPv4/IPv6) に 1 つ) が必要です。

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-NoWait

コマンドを非同期的に実行する

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ResourceGroupName

リソース グループの名前。 名前は大文字と小文字を区別しません。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SshPublicKey

Kubernetes クラスター内のノードを実行するオペレーティング システムの SSH 構成。 場合によっては、作業環境を生成するために公開キーの指定が必要になる場合があります。

パラメーターのプロパティ

型:

ISshPublicKey[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SubscriptionId

ターゲット サブスクリプションの ID。 値は UUID である必要があります。

パラメーターのプロパティ

型:String
規定値:(Get-AzContext).Subscription.Id
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Tag

リソース タグ。

パラメーターのプロパティ

型:Hashtable
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:wi

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、about_CommonParametersを参照してください。

出力

IKubernetesCluster