New-VMHostNetworkAdapter

Synopsis

Creates a new HostVirtualNIC (Service Console or VMKernel) on the specified host.

Syntax

New-VMHostNetworkAdapter [-VMHost] <VMHost> [-PortGroup] <String> [-VirtualSwitch] <VirtualSwitch> [[-IP] <String>] [[-SubnetMask] <String>] [[-Mac] <String>] [-ConsoleNic] [-VMotionEnabled [<Boolean>]] [-FaultToleranceLoggingEnabled [<Boolean>]] [-IPv6ThroughDhcp] [-AutomaticIPv6] [-IPv6 <String[]>] [-Server <VIServer[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Remove-VMHostNetworkAdapter
Set-VMHostNetworkAdapter

Detailed Description

Creates a new HostVirtualNIC (Service Console or VMKernel) on the specified host. Creates a port group with a name specified by the PortGroup parameter on the virtual switch passed through the VirtualSwitch parameter. Adds either a Console NIC if ConsoleNIC is set, or a VMKernel NIC otherwise.

Parameters

NameDescriptionRequired?Pipeline InputDefault Value
VMHostSpecify the host to which you want to add the new adapter.truetrue (ByValue)
PortGroupSpecify the port group to which you want to add the new adapter.truefalse
VirtualSwitchIf the specified port group is non-existent, use this parameter to specify on which virtual switch you want to add the new network adapter.truefalse
IPSpecify an IP address for the new network adapter. All IP addresses are specified using IPv4 dot notation. If IP is not specified, DHCP mode is enabled. For VMKernel network adapters, the DHCP mode is supported only on vCenter Server 4.0, ESX 4.0, and later.falsefalse
SubnetMaskSpecify a subnet mask for the new network adapter.falsefalse
MacSpecify a media access control (MAC) address for the new virtual network adapter.falsefalse
ConsoleNicIf the value is $true, indicates that you want to create a service console virtual network adapter. If the value is $false, indicates that you want to create a virtual host/VMkernel network adapter. Not supported on ESXi.falsefalse
VMotionEnabledIndicate that you want to use the new virtual host/VMKernel network adapter for VMotion.falsefalse
FaultToleranceLoggingEnabledIndicate that the network adapter is enabled for Fault Tolerance (FT) logging.falsefalse
IPv6ThroughDhcpIndicate that the IPv6 address is obtained through DHCP.falsefalse
AutomaticIPv6Indicate that the IPv6 address is obtained through a router advertisement.falsefalse
IPv6Specify multiple static addresses using the following format: <IPv6>/<subnet_prefix_length> or <IPv6>. If you skip <subnet_prefix_length>, the default value of 64 is used.falsefalse
ServerThe -Server parameter is needed when the host is specified by name. In this case, the host with the specified name is searched on the specified Servers and a network adapter is added to it. If a VMHost object is passed to the VMHost parameter - the -Server parameter is not used.falsefalse
WhatIfIndicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse
ConfirmIndicate that the cmdlet asks for confirmation before running.falsefalse

Input Type

Return Type

VMware.VimAutomation.Types.Host.NIC.HostVirtualNic

Notes

To configure IPv6 settings, you must be working on ESX 4.0 or later and IPv
    6 must be enabled on the ESX system.

Examples

--------------  Example 1 --------------

C:\PS>$vs = Get-VirtualSwitch -VMHost 10.23.113.111 -Name "vSwitch0"

New-VMHostNetworkAdapter -VMHost 10.23.113.110 -PortGroup MyConsolePortGroup -Vi
rtualSwitch $vs -ConsoleNIC


Creates a Service Console port group at the vSwitch0 virtual switch. The IP addr
ess is obtained via DHCP.




--------------  Example 2 --------------

C:\PS>$vs = Get-VirtualSwitch -VMHost 10.23.113.111 -Name "vSwitch0"

New-VMHostNetworkAdapter -VMHost 10.23.113.110 -PortGroup MyVMKernelPortGroup -V
irtualSwitch $vs -IP 192.168.168.110 -SubnetMask 255.255.255.0


Creates a VMKernel port group at the vSwitch0 virtual switch and assigns a stati
c IP address.




--------------  Example 3 --------------

C:\PS>New-VMHostNetworkAdapter -VMHost $myHost -VirtualSwitch $virtualSwitch -Po
rtGroup "Service Console 1" -IP 192.168.0.1 -SubnetMask 255.255.255.0 -IPv6 "020
0:2342::1/32"


Creates a VMKernel NIC that has an IPv4 address and an IPv6 address.




--------------  Example 4 --------------

C:\PS>New-VMHostNetworkAdapter -VMHost $myHost -VirtualSwitch $virtualSwitch -Po
rtGroup "Serveice Console 1" -IP 192.168.0.1 -SubnetMask 255.255.255.0 -Automati
cIPv6


Creates a VMKernel NIC that obtains IPv6 automatically (by router advertisement)
 and takes the desired IPv4 address.




--------------  Example 5 --------------

C:\PS>New-VMHostNetworkAdapter -VMHost $myHost -VirtualSwitch $virtualSwitch -Po
rtGroup "Service Console 1" - -IPv6ThroughDhcp


Creates a VMKernel NIC that obtains the IPv4 and IPv6 addresses by DHCP.

Copyright © 1998 - 2009 VMware, Inc. All rights reserved.