PowerCLI Reference

Add-VDSwitchPhysicalNetworkAdapter

Synopsis

This cmdlet adds host physical network adapters to a vSphere distributed switch.

Syntax

Add-VDSwitchPhysicalNetworkAdapter [-VMHostPhysicalNic] <PhysicalNic[]> [-DistributedSwitch] <DistributedSwitch> [-Server <VIServer[]>] [-VirtualNicPortgroup <VDPortgroup[]>] [-VMHostVirtualNic <HostVirtualNic[]>] [-Confirm] [-WhatIf] [<CommonParameters>]

Related Commands

Online Version
Remove-VDSwitchPhysicalNetworkAdapter

Detailed Description

This cmdlet adds host physical network adapters to a vSphere distributed switch.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
VMHostPhysicalNicPhysicalNic[]Specifies the host physical network adapters that you want to add or migrate to the vSphere distributed switch.trueFalse
DistributedSwitchDistributedSwitchSpecifies the vSphere distributed switch to which you want to add the host physical network adapter.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
VirtualNicPortgroupVDPortgroup[]Specifies the port groups to which to attach the host virtual network adapters. Accepts either one port group, or the same number of port groups as the number of virtual network adapters specified. If one port group is specified, all adapters are attached to that port group. If the same number of port groups as the number of virtual network adapters are 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 --------------------------

$vmhostNetworkAdapter = Get-VMHost "MyVMHost" | Get-VMHostNetworkAdapter -Physical -Name vmnic2
Get-VDSwitch "MyVDSwitch" | Add-VDSwitchPhysicalNetworkAdapter -VMHostPhysicalNic $vmhostNetworkAdapter

Retrieves the specified physical network adapter from the specified host and adds it to the specified vSphere distributed switch.

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

$myVMHost = Get-VMHost "MyVMHost"
$physicalNic = Get-VMHostNetworkAdapter -VMHost $myVMHost -Name "vmnic0"
$virtualNic = Get-VMHostNetworkAdapter -VMHost $myVMHost -Name "vmk0"
Get-VDSwitch -Name "MyVDSwitch" | Add-VDSwitchPhysicalNetworkAdapter -VMHostPhysicalNic $physicalNic -VMHostVirtualNic $virtualNic -VirtualNicPortgroup 'MyVDPortGroup'

Migrates a host physical network adapter and a virtual network adapter to a vSphere distributed switch.


Copyright © VMware, Inc. All rights reserved.