New-AzAksNodePool

構文

defaultParameterSet

New-AzAksNodePool
    -ResourceGroupName <String>
    -ClusterName <String>
    -Name <String>
    [-Count <Int32>]
    [-OsDiskSize <Int32>]
    [-OSDiskType <String>]
    [-VmSize <String>]
    [-VnetSubnetID <String>]
    [-WorkloadRuntime <String>]
    [-MaxPodCount <Int32>]
    [-MessageOfTheDay <String>]
    [-OsType <String>]
    [-PodIPAllocationMode <String>]
    [-OsSKU <String>]
    [-EnableNodePublicIp]
    [-NodePublicIPPrefixID <String>]
    [-ScaleSetPriority <String>]
    [-ScaleSetEvictionPolicy <String>]
    [-VmSetType <String>]
    [-AvailabilityZone <String[]>]
    [-Force]
    [-EnableEncryptionAtHost]
    [-EnableUltraSSD]
    [-GatewayPublicIPPrefixSize <Int32>]
    [-GPUDriver <String>]
    [-LinuxOSConfig <LinuxOSConfig>]
    [-KubeletConfig <KubeletConfig>]
    [-PPG <String>]
    [-SpotMaxPrice <Double>]
    [-EnableFIPS]
    [-GpuInstanceProfile <String>]
    [-HostGroupID <String>]
    [-PodSubnetID <String>]
    [-KubernetesVersion <String>]
    [-MinCount <Int32>]
    [-MaxCount <Int32>]
    [-EnableAutoScaling]
    [-Mode <String>]
    [-NodeLabel <Hashtable>]
    [-Tag <Hashtable>]
    [-NodeTaint <String[]>]
    [-AksCustomHeader <Hashtable>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-NetworkProfile <AgentPoolNetworkProfile>]
    [-ScaleDownMode <String>]
    [-EnableSecureBoot]
    [-EnableVtpm]
    [-SshAccess <String>]
    [-MaxSurge <String>]
    [-MaxUnavailable <String>]
    [-DrainTimeoutInMinute <Int32>]
    [-NodeSoakDurationInMinute <Int32>]
    [-UndrainableNodeBehavior <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-SubscriptionId <String>]
    [<CommonParameters>]

ParentObjectParameterSet

New-AzAksNodePool
    -Name <String>
    -ClusterObject <PSKubernetesCluster>
    [-Count <Int32>]
    [-OsDiskSize <Int32>]
    [-OSDiskType <String>]
    [-VmSize <String>]
    [-VnetSubnetID <String>]
    [-WorkloadRuntime <String>]
    [-MaxPodCount <Int32>]
    [-MessageOfTheDay <String>]
    [-OsType <String>]
    [-PodIPAllocationMode <String>]
    [-OsSKU <String>]
    [-EnableNodePublicIp]
    [-NodePublicIPPrefixID <String>]
    [-ScaleSetPriority <String>]
    [-ScaleSetEvictionPolicy <String>]
    [-VmSetType <String>]
    [-AvailabilityZone <String[]>]
    [-Force]
    [-EnableEncryptionAtHost]
    [-EnableUltraSSD]
    [-GatewayPublicIPPrefixSize <Int32>]
    [-GPUDriver <String>]
    [-LinuxOSConfig <LinuxOSConfig>]
    [-KubeletConfig <KubeletConfig>]
    [-PPG <String>]
    [-SpotMaxPrice <Double>]
    [-EnableFIPS]
    [-GpuInstanceProfile <String>]
    [-HostGroupID <String>]
    [-PodSubnetID <String>]
    [-KubernetesVersion <String>]
    [-MinCount <Int32>]
    [-MaxCount <Int32>]
    [-EnableAutoScaling]
    [-Mode <String>]
    [-NodeLabel <Hashtable>]
    [-Tag <Hashtable>]
    [-NodeTaint <String[]>]
    [-AksCustomHeader <Hashtable>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-NetworkProfile <AgentPoolNetworkProfile>]
    [-ScaleDownMode <String>]
    [-EnableSecureBoot]
    [-EnableVtpm]
    [-SshAccess <String>]
    [-MaxSurge <String>]
    [-MaxUnavailable <String>]
    [-DrainTimeoutInMinute <Int32>]
    [-NodeSoakDurationInMinute <Int32>]
    [-UndrainableNodeBehavior <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-SubscriptionId <String>]
    [<CommonParameters>]

説明

例

例 1: 既定のパラメーターを使用してノード プールを作成する

New-AzAksNodePool -ResourceGroupName myResourceGroup -ClusterName myCluster -Name mydefault

例 2: AKS Windows Serverコンテナーを作成する

$cred = ConvertTo-SecureString -String "****" -AsPlainText -Force
New-AzAksCluster -ResourceGroupName myResourceGroup -Name myCluster -WindowsProfileAdminUserName azureuser -WindowsProfileAdminUserPassword $cred -NetworkPlugin azure -NodeVmSetType VirtualMachineScaleSets
New-AzAksNodePool -ResourceGroupName myResourceGroup -ClusterName myCluster -Name win1 -OsType Windows -VmSetType VirtualMachineScaleSets

例 3: LinuxOSConfig と KubeletConfig を使用してノード プールを作成する。

$linuxOsConfigJsonStr = @'
            {
             "transparentHugePageEnabled": "madvise",
             "transparentHugePageDefrag": "defer+madvise",
             "swapFileSizeMB": 1500,
             "sysctls": {
              "netCoreSomaxconn": 163849,
              "netIpv4TcpTwReuse": true,
              "netIpv4IpLocalPortRange": "32000 60000"
             }
            }
'@
$linuxOsConfig = [Microsoft.Azure.Management.ContainerService.Models.LinuxOSConfig] ($linuxOsConfigJsonStr | ConvertFrom-Json)
$kubeletConfigStr = @'
            {
             "failSwapOn": false
            }
'@
$kubeletConfig = [Microsoft.Azure.Management.ContainerService.Models.KubeletConfig] ($kubeletConfigStr | ConvertFrom-Json)

New-AzAksNodePool -ResourceGroupName myResourceGroup -ClusterName myAKSCluster -Name mypool -LinuxOSConfig $linuxOsConfig -KubeletConfig $kubeletConfig

パラメーター

-AksCustomHeader

Aks カスタム ヘッダー

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

パラメーター セット

-AvailabilityZone

ノードの可用性ゾーン。 VirtualMachineScaleSets AgentPoolType を使用する必要があります。

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

パラメーター セット

-ClusterName

管理対象クラスター・リソースの名前。

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

パラメーター セット

-ClusterObject

ノード プールを作成するクラスター オブジェクトを指定します。

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

パラメーター セット

-Confirm

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

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

パラメーター セット

-Count

ノード プールの既定のノード数。

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

パラメーター セット

-DefaultProfile

Azureとの通信に使用される資格情報、アカウント、テナント、サブスクリプション。

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

パラメーター セット

-DrainTimeoutInMinute

ノードのドレイン タイムアウト。 ポッドの削除とノードごとのグレースフル終了を待機する時間 (分単位)。 この削除待機時間は、ポッドの中断予算の待機を優先します。 この時間を超えると、アップグレードは失敗します。 指定されていない場合、既定値は 30 分です。

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

パラメーター セット

-EnableAutoScaling

自動スケーラーを有効にするかどうか

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

パラメーター セット

-EnableEncryptionAtHost

ホスト ベースの OS とデータ ドライブを有効にするかどうか

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

パラメーター セット

-EnableFIPS

FIPS 対応 OS を使用するかどうか

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

パラメーター セット

-EnableNodePublicIp

ノードのパブリック IP を有効にするかどうかを指定します。

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

パラメーター セット

-EnableSecureBoot

セキュア ブートは、署名されたオペレーティング システムとドライバーのみが起動できるようにする、トラステッド起動の機能です。 詳細については、aka.ms/aks/trustedlaunch を参照してください。 指定しない場合、既定値は false です。

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

パラメーター セット

-EnableUltraSSD

UltraSSD を有効にするかどうか

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

パラメーター セット

-EnableVtpm

vTPM は、ノード上でローカルに保持されているキーと測定値用に専用のセキュリティで保護されたコンテナーを構成するための信頼できる起動機能です。 詳細については、aka.ms/aks/trustedlaunch を参照してください。 指定しない場合、既定値は false です。

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

パラメーター セット

-Force

ノード プールが既に存在する場合でも作成する

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

パラメーター セット

-GatewayPublicIPPrefixSize

ゲートウェイ エージェント プールは、静的エグレス ゲートウェイごとに 1 つのパブリック IPPrefix を関連付けて、パブリック エグレスを提供します。 パブリック IPPrefix のサイズは、ユーザーが選択する必要があります。 エージェント プール内の各ノードには、IPPrefix から 1 つの IP が割り当てられます。 IPPrefix サイズは、ゲートウェイ エージェント プールのサイズの上限として機能します。 パブリック IPPrefix サイズAzure制限があるため、有効な値の範囲は [28, 31] です (/31 = 2 ノード/IP、/30 = 4 ノード/IP、/29 = 8 ノード/IP、/28 = 16 ノード/IP)。 既定値は 31 です。

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

パラメーター セット

-GPUDriver

GPU ドライバーをインストールするかどうか。 指定されていない場合、既定値は Install です。

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

パラメーター セット

-GpuInstanceProfile

サポートされている GPU VM SKU の GPU MIG インスタンス プロファイルを指定するために使用される GpuInstanceProfile。

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

パラメーター セット

-HostGroupID

仮想マシンをプロビジョニングする専用ホスト グループの完全修飾リソース ID。作成シナリオでのみ使用され、設定後の変更は許可されません。

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

パラメーター セット

-IfMatch

要求は、エンティティがこの文字列と一致する場合にのみ続行する必要があります。

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

パラメーター セット

-IfNoneMatch

要求は、この文字列に一致するエンティティがない場合にのみ続行する必要があります。

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

パラメーター セット

-KubeletConfig

エージェント プール ノード上の Kubelet 構成。

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

パラメーター セット

-KubernetesVersion

クラスターの作成に使用する Kubernetes のバージョン。

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

パラメーター セット

-LinuxOSConfig

Linux エージェント ノードの OS 構成。

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

パラメーター セット

-MaxCount

自動スケーリング用のノードの最大数

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

パラメーター セット

-MaxPodCount

ノードで実行できるポッドの最大数。

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

パラメーター セット

-MaxSurge

アップグレード中に急増したノードの最大数または割合。

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

パラメーター セット

-MaxUnavailable

アップグレード中に同時に使用できないノードの最大数または割合。 これは、整数 (例: '1') またはパーセンテージ (例: '5%') に設定できます。 パーセンテージを指定すると、アップグレード時のエージェント・プール・サイズの合計に対するパーセンテージになります。 パーセンテージの場合、小数部のノードは切り上げられます。 指定しない場合、既定値は 0 です。 ベスト プラクティスを含む詳細については、以下を参照してください。

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

パラメーター セット

-MessageOfTheDay

Base64 でエンコードされた Linux ノードの日のメッセージ。 デコード後に /etc/motd に書き込まれる base64 でエンコードされた文字列。 これにより、Linux ノードに対するその日のメッセージをカスタマイズできます。 Windows ノードには指定しないでください。 静的文字列である必要があります (つまり、生で出力され、スクリプトとして実行されません)。

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

パラメーター セット

-MinCount

自動スケーリング用のノードの最小数。

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

パラメーター セット

-Mode

プール モード

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

パラメーター セット

-Name

ノード プールの名前。

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

パラメーター セット

-NetworkProfile

エージェント プールのネットワーク関連の設定。

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

パラメーター セット

-NodeLabel

Kubernetes ネットワークの構築に使用されるノード プール ラベル。

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

パラメーター セット

-NodePublicIPPrefixID

ノード プールのパブリック IP プレフィックスのリソース ID。

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

パラメーター セット

-NodeSoakDurationInMinute

ノードのソーク期間。 ノードをドレインした後、再イメージ化して次のノードに進む前に待機する時間 (分単位)。 指定しない場合、既定値は 0 分です。

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

パラメーター セット

-NodeTaint

ノード プールの作成とスケーリング中に新しいノードに追加されたノード テイント

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

パラメーター セット

-OsDiskSize

ノード プールの既定のノード数。

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

パラメーター セット

-OSDiskType

VM でサポートされていて、要求された OSDiskSizeGB より大きいキャッシュ ディスクがある場合、既定値は "エフェメラル" です。 それ以外の場合、既定値は 'Managed' です。 作成後に変更できない場合があります。 詳細については、「エフェメラル OS を参照してください。

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

パラメーター セット

-OsSKU

OS SKU の指定に使用する OsSKU。 OSType が Linux の場合、既定値は Ubuntu です。 OSType がWindowsされている場合、Kubernetes <= 1.24 または Windows2022 の場合、Kubernetes >= 1.25 の場合、既定値は Windows2019 です。

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

パラメーター セット

-OsType

os 型を指定するために使用する OsType。 Linux とWindowsから選択します。 既定値は Linux です。

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

パラメーター セット

-PodIPAllocationMode

ポッド IP 割り当てモード。 エージェント プール内のポッドの IP 割り当てモード。 podSubnetId と共に使用する必要があります。 既定値は "DynamicIndividual" です。

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

パラメーター セット

-PodSubnetID

起動時にポッドが参加するサブネットの ID。

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

パラメーター セット

-PPG

近接通信配置グループの ID。

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

パラメーター セット

-ResourceGroupName

リソース グループの名前。

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

パラメーター セット

-ScaleDownMode

エージェント プールをスケーリングするときに使用するスケール ダウン モード。 これは、クラスターオートスケーラーの動作にも影響します。 指定しない場合は、既定で Delete に設定されます。

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

パラメーター セット

-ScaleSetEvictionPolicy

優先順位の低い仮想マシン スケール セットの削除ポリシーを指定するために使用される ScaleSetEvictionPolicy。 既定値は [削除] です。

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

パラメーター セット

-ScaleSetPriority

仮想マシン スケール セットの優先順位を指定するために使用される ScaleSetPriority。 既定値は標準です。

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

パラメーター セット

-SpotMaxPrice

スポット インスタンスに対して支払う最大価格 (米ドル)。 使用できる値は、0 より大きい任意の 10 進値、または既定の価格がオンデマンドで up-to されることを示す -1 です。

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

パラメーター セット

-SshAccess

エージェント プールの sSH アクセス方法。

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

パラメーター セット

-SubscriptionId

サブスクリプションの ID。 既定では、コマンドレットは現在のコンテキストで設定されているサブスクリプションで実行されます。 ユーザーが別のサブスクリプションを指定した場合、現在のコマンドレットはユーザーが指定したサブスクリプションで実行されます。 サブスクリプションのオーバーライドは、現在のコマンドレットのライフサイクル中にのみ有効になります。 コンテキスト内のサブスクリプションは変更されず、後続のコマンドレットには影響しません。

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

パラメーター セット

-Tag

エージェント プールの仮想マシン スケール セットに保持されるタグ。

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

パラメーター セット

-UndrainableNodeBehavior

アップグレード中の、読み取り不可能なノードの動作。 ノードを使用できない最も一般的な原因はポッド中断予算 (PDB) ですが、ポッドの終了猶予期間が残りのノードごとのドレイン タイムアウトを超えたり、ポッドがまだ実行中の状態であるなど、他の問題が原因で、セッション不可能なノードが発生する可能性もあります。

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

パラメーター セット

-VmSetType

ノード プールの種類を表します。 使用可能な値は、'VirtualMachineScaleSets'、'AvailabilitySet' です。

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

パラメーター セット

-VmSize

仮想マシンのサイズ。 既定値は、クォータと容量に基づいて AKS リソース プロバイダーによって動的に選択されます。

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

パラメーター セット

-VnetSubnetID

VNet SubnetID は、VNet のサブネット識別子を指定します。

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

パラメーター セット

-WhatIf

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

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

パラメーター セット

-WorkloadRuntime

ノードが実行できるワークロードの種類。

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

パラメーター セット

CommonParameters

入力

PSKubernetesCluster

出力

PSNodePool