New-AksHciClusterNetwork

發行項
04/27/2023

概要

建立虛擬網路以設定控制平面、負載平衡器、代理程式端點的 DHCP 或靜態 IP 位址，以及工作負載叢集的靜態 IP 範圍。

Syntax

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>

Description

建立虛擬網路以設定控制平面、負載平衡器、代理程式端點的 DHCP 或靜態 IP 位址，以及工作負載叢集中各節點的靜態 IP 範圍。此 Cmdlet 會傳回 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>

部署具有 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> -vlanID <int>

部署沒有 VLAN 的 DHCP 環境

$vnet = New-AksHciClusterNetwork -name MyClusterNetwork -vnetName "External" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254"

部署具有 VLAN 的 DHCP 環境

$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 之網路時的必要項目。此參數會建立 IP 位址陣列，指向要用於子網路的 DNS 伺服器。可以提供最少一部、最多三部伺服器，例如 "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 識別碼。如果省略，將不會標記網路。

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

後續步驟

AksHci PowerShell 參考

共用方式為