New-AksHciNetworkSetting

概要

為 AKS 主機建立新虛擬網路的物件。

Syntax

DHCP 虛擬網路設定

針對沒有 VLAN 的 DHCP 設定:

New-AksHciNetworkSetting -name <String>
                         -vswitchName <String>
                         -vipPoolStart <IP address>
                         -vipPoolEnd <IP address>

針對具有 VLAN 的 DHCP 設定:

New-AksHciNetworkSetting -name <String>
                         -vswitchName <String>
                         -vipPoolStart <IP address>
                         -vipPoolEnd <IP address>
                         -vlanID <int>

靜態 IP 虛擬網路設定

針對沒有 VLAN 的靜態 IP 設定:

New-AksHciNetworkSetting -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-AksHciNetworkSetting -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

建立虛擬網路,在 AKS 主機中設定負載平衡器和 Kubernetes 節點 VM 的 DHCP 或靜態 IP 位址。 此 Cmdlet 會傳回 VirtualNetwork 物件,此物件可供稍後在部署 AKS 主機時的設定步驟中使用。

範例

注意

您必須為環境自訂以下範例所提供的值。

使用沒有 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>
Set-AksHciConfig -workingDir c:\clusterstorage\volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

使用靜態 IP 環境和 VLAN 進行部署

$vnet = New-AksHciNetworkSetting -name myVnet1 -vswitchName "External" -k8sNodeIpPoolStart "172.16.10.1" -k8sNodeIpPoolEnd "172.16.10.255" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" -ipAddressPrefix "172.16.0.0/16" -gateway "172.16.0.1" -dnsServers "172.16.0.1" -vlanID 7
Set-AksHciConfig -workingDir c:\clusterstorage\volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

使用沒有 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>
Set-AksHciConfig -workingDir c:\clusterstorage\volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

使用 DHCP 環境和 VLAN 進行部署

$vnet = New-AksHciNetworkSetting -name dhcpvnet -vswitchName "External" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" -vlanID 7
Set-AksHciConfig -workingDir c:\clusterstorage\volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"

參數

-name

vnet 的描述性名稱。 名稱必須全部是小寫字母和數字。

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 伺服器。 可以提供最少 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 識別碼。 如果省略,將不會標記網路。

Type: System.Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

後續步驟

AksHci PowerShell 參考