New-AksHciClusterNetwork
構文
仮想ネットワークを作成し、DHCP または静的 IP アドレスを、ワークロード クラスター用のコントロール プレーン、ロード バランサー、エージェント エンドポイント、および静的 IP 範囲に対して設定します。
構文
DHCP 仮想ネットワークの構成
VLAN を使用しない DHCP 構成の場合:
New-AksHciClusterNetwork -name <String>
-vswitchName <String>
-vipPoolStart <IP address>
-vipPoolEnd <IP address>
VLAN を使用した DHCP 構成の場合:
New-AksHciClusterNetwork -name <String>
-vswitchName <String>
-vipPoolStart <IP address>
-vipPoolEnd <IP address>
-vlanID <int>
静的 IP 仮想ネットワークの構成
VLAN を使用しない静的 IP 構成の場合:
New-AksHciClusterNetwork -name <String>
-vswitchName <String>
-gateway <String>
-dnsServers <String[]>
-ipAddressPrefix <String>
-vipPoolStart <IP address>
-vipPoolEnd <IP address>
-k8sNodeIpPoolStart <IP address>
-k8sNodeIpPoolEnd <IP address>
VLAN を使用した静的 IP 構成の場合:
New-AksHciClusterNetwork -name <String>
-vswitchName <String>
-gateway <String>
-dnsServers <String[]>
-ipAddressPrefix <String>
-vipPoolStart <IP address>
-vipPoolEnd <IP address>
-k8sNodeIpPoolStart <IP address>
-k8sNodeIpPoolEnd <IP address>
-vlanID <int>
説明
仮想ネットワークを作成し、DHCP または静的 IP アドレスを、ワークロード クラスター内のノード用のコントロール プレーン、ロード バランサー、エージェント エンドポイント、および静的 IP 範囲に対して設定します。 このコマンドレットは、新しいワークロード クラスターの作成時に、構成手順の後半で使用できる VirtualNetwork オブジェクトを返します。 仮想ネットワークは必要な数だけ作成できます。
例
静的 IP または DHCP を使用して仮想ネットワークを構成するには、下の例を使用します。 環境に合わせて、例に示されている値をカスタマイズする必要があります。 静的 IP または DHCP を使用して仮想ネットワークを構成したら、New-AksHciCluster を実行してクラスターをデプロイします。
VLAN を使用しない静的 IP 環境でのデプロイ
$vnet = New-AksHciClusterNetwork -name <String> -vswitchName <String> -gateway <String> -dnsServers <String[]> -ipAddressPrefix <String> -vipPoolStart <IP address> -vipPoolEnd <IP address> -k8sNodeIpPoolStart <IP address> -k8sNodeIpPoolEnd <IP address>
静的 IP 環境と VLAN でのデプロイ
$vnet = New-AksHciClusterNetwork -name <String> -vswitchName <String> -gateway <String> -dnsServers <String[]> -ipAddressPrefix <String> -vipPoolStart <IP address> -vipPoolEnd <IP address> -k8sNodeIpPoolStart <IP address> -k8sNodeIpPoolEnd <IP address> -vlanID <int>
VLAN を使用しない DHCP 環境でのデプロイ
$vnet = New-AksHciClusterNetwork -name MyClusterNetwork -vnetName "External" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254"
DHCP 環境と VLAN でのデプロイ
$vnet = New-AksHciClusterNetwork -name MyClusterNetwork -vnetName "External" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" -vlanID 7
パラメーター
-name
仮想ネットワークのわかりやすい名前。 使用可能な仮想ネットワークの名前の一覧を取得するには、コマンド Get-AksHciClusterNetwork を実行します。
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-vswitchName
お使いの外部スイッチの名前。 使用可能なスイッチの名前の一覧を取得するには、コマンド Get-VMSwitch を実行します。
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-gateway
サブネットの既定のゲートウェイの IP アドレス。
Type: System.String
Parameter Sets: (StaticIP)
Aliases:
Required: False (This is required when creating a network with a static IP.)
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-dnsServers
静的 IP を使用してネットワークを作成するときに必要です。 このパラメーターは、サブネットに使用する DNS サーバーを指す IP アドレスの配列を作成します。 最小 1 台、最大 3 台のサーバーを指定できます。たとえば、"8.8.8.8"、"192.168.1.1" などです。
Type: System.String[]
Parameter Sets: (StaticIP)
Aliases:
Required: False (This is required when creating a network with a static IP.)
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ipAddressPrefix
静的 IP の割り当てに使用するアドレス プレフィックス。
Type: System.String
Parameter Sets: (StaticIP)
Aliases:
Required: False (This is required when creating a network with a static IP.)
Position: Named
Default value: external
Accept pipeline input: False
Accept wildcard characters: False
-vipPoolStart
VIP プールの開始 IP アドレス。 アドレスは、DHCP サーバーによって提供される範囲内、またはサブネット CIDR 内で提供される範囲内である必要があります。 VIP プール内の IP アドレスは、API サーバーおよび Kubernetes サービスに使用されます。 DHCP を使用している場合は、ご自身の仮想 IP アドレスが DHCP IP 予約に含まれることを確認します。 静的 IP を使用している場合は、ご自身の仮想 IP が同じサブネットに含まれることを確認します。
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-vipPoolEnd
VIP プールの終了 IP アドレス。 アドレスは、DHCP サーバーによって提供される範囲内、またはサブネット CIDR 内で提供される範囲内である必要があります。 VIP プール内の IP アドレスは、API サーバーおよび Kubernetes サービスに使用されます。 DHCP を使用している場合は、ご自身の仮想 IP アドレスが DHCP IP 予約に含まれることを確認します。 静的 IP を使用している場合は、ご自身の仮想 IP が同じサブネットに含まれることを確認します。
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-k8sNodeIpPoolStart
VM プールの開始 IP アドレス。 アドレスは、サブネットの範囲内である必要があります。 これは、静的 IP デプロイに必要です。
Type: System.String
Parameter Sets: (StaticIP)
Aliases:
Required: False (This is required when creating a network with a static IP.)
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-k8sNodeIpPoolEnd
VM プールの終了 IP アドレス。 アドレスは、サブネットの範囲内である必要があります。 これは、静的 IP デプロイに必要です。
Type: System.String
Parameter Sets: (StaticIP)
Aliases:
Required: False (This is required when creating a network with a static IP.)
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-vlanID
ネットワークの VLAN ID を指定します。 省略した場合、ネットワークはタグ付けされません。
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False (This parameter is required if you configure a virtual network with a VLAN.)
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
次のステップ
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示