New-AksHciNetworkSetting
Synopsis
Create an object for a new virtual network for the AKS host.
Syntax
DHCP virtual network configurations
For DHCP configurations without a VLAN:
New-AksHciNetworkSetting -name <String>
-vswitchName <String>
-vipPoolStart <IP address>
-vipPoolEnd <IP address>
For DHCP configurations with a VLAN:
New-AksHciNetworkSetting -name <String>
-vswitchName <String>
-vipPoolStart <IP address>
-vipPoolEnd <IP address>
-vlanID <int>
Static IP virtual network configurations
For static IP configurations without a VLAN:
New-AksHciNetworkSetting -name <String>
-vswitchName <String>
-gateway <String>
-dnsServers <String[]>
-ipAddressPrefix <String>
-vipPoolStart <IP address>
-vipPoolEnd <IP address>
-k8sNodeIpPoolStart <IP address>
-k8sNodeIpPoolEnd <IP address>
For static IP configurations with a VLAN:
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
Create a virtual network to set the DHCP or static IP address for the load balancer and the Kubernetes node VM in the AKS host. This cmdlet will return a VirtualNetwork object, which can be used later in the configuration steps when deploying the AKS host.
Examples
Note
The values given in the examples below need to be customized for your environment.
Deploy with a static IP environment without a 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>
Set-AksHciConfig -workingDir c:\clusterstorage\volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Deploy with a static IP environment and a 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"
Deploy with a static IP environment without a 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>
Set-AksHciConfig -workingDir c:\clusterstorage\volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Deploy with a DHCP environment and a 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"
Parameters
-name
The descriptive name of your vnet. The name must be all lowercase letters and numbers.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-vswitchName
The name of your external switch. To get a list of the names of your available switches, run the command 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
The IP address of the default gateway of the subnet.
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
Required when creating a network with a static IP. An array of IP addresses pointing to the DNS servers to be used for the subnet. A minimum of one and a maximum of 3 servers can be provided. i.e. "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
The address prefix to use for Static IP assignment.
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
The start IP address of the VIP pool. The address must be within the range either served by the DHCP server or within the range provided in the Subnet CIDR. The IP addresses in the VIP pool will be used for the API Server and for Kubernetes services. If you're using DHCP, make sure your virtual IP addresses are a part of the DHCP IP reserve. If you're using static IP, make sure your virtual IPs are from the same subnet.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-vipPoolEnd
The end IP address of the VIP pool. The address must be within the range either served by the DHCP server or within the range provided in the Subnet CIDR. The IP addresses in the VIP pool will be used for the API Server and for Kubernetes services. If you're using DHCP, make sure your virtual IP addresses are a part of the DHCP IP reserve. If you're using static IP, make sure your virtual IPs are from the same subnet.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-k8sNodeIpPoolStart
The start IP address of a VM pool. The address must be in range of the subnet. This is required for static IP deployments.
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
The end IP address of a VM pool. The address must be in range of the subnet. This is required for static IP deployments.
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
The vLAN ID for the network specified. If omitted the network will not be tagged.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Next steps
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for