PowerCLI Reference

Add-VirtualSwitchPhysicalNetworkAdapter

Synopsis

This cmdlet adds a host physical NIC to a standard virtual switch.

Syntax

Add-VirtualSwitchPhysicalNetworkAdapter [-VMHostPhysicalNic] <PhysicalNic[]> [-VirtualSwitch] <VirtualSwitch> [-VirtualNicPortgroup <VirtualPortGroup[]>] [-VMHostVirtualNic <HostVirtualNic[]>] [-Server <VIServer[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Remove-VirtualSwitchPhysicalNetworkAdapter

Detailed Description

This cmdlet adds a host physical NIC to a standard virtual switch. If VMHost virtual network adapters are specified, the cmdlet migrates them to the virtual switch as well.

Note: If VMHost virtual network adapters are specified, the cmdlet migrates them to the respective port groups or creates new ones if VirtualNicPortgroup is not specified.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
VMHostPhysicalNicPhysicalNic[]Specifies the host physical network adapters that you want to add or migrate to the standard virtual switch.truefalse
VirtualSwitchVirtualSwitchSpecifies the standard virtual switch to which you want to migrate physical or virtual network adapters.truetrue (ByValue)
ConfirmSwitchParameterIf the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.falsefalse
ServerVIServer[]Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.falsefalse
VirtualNicPortgroupVirtualPortGroup[]Specifies the port groups to which to attach the host virtual network adapters. Accepts the same number of port groups as the number of virtual network adapters specified. The first adapter is attached to the first port group, the second adapter - to the second port group, and so on.falsefalse
VMHostVirtualNicHostVirtualNic[]Specifies the host virtual network adapters to be migrated along with the physical adapter, so that their connectivity is preserved.falsefalse
WhatIfSwitchParameterIndicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse

Return Type

None

Notes

Examples

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

$myVMHostNetworkAdapter = Get-VMhost "MyVMHost" | Get-VMHostNetworkAdapter -Physical -Name vmnic2
Get-VirtualSwitch "MyVirtualSwitch" | Add-VirtualSwitchPhysicalNetworkAdapter -VMHostPhysicalNic $myVMHostNetworkAdapter

Adds a VMHost physical network adapter to the specified distributed switch.

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

$myVMHost = Get-VMHost 'MyVMHost'
$myVDSwitch = Get-VDSwitch 'MyVDSwitch'
$physicalNic = Get-VMHostNetworkAdapter -VMHost $myVMHost -VirtualSwitch $myVDSwitch -Name 'vmnic0'
$virtualNic = Get-VMHostNetworkAdapter -VMHost $myVMHost -VirtualSwitch $myVDSwitch -Name 'vmk0'
$myStandardSwitch = Get-VirtualSwitch -VMHost $myVMHost -Name 'vSwitch0'
Add-VirtualSwitchPhysicalNetworkAdapter -VirtualSwitch $myStandardSwitch -VMHostPhysicalNic $physicalNic -VMHostVirtualNic $virtualNic

Migrates VMHost physical and virtual network adapters from a distributed virtual switch to a standard virtual switch.


Copyright © VMware, Inc. All rights reserved.