Add-VDSwitchPhysicalNetworkAdapter

Synopsis

Syntax

Related Commands

Online Version

Remove-VDSwitchPhysicalNetworkAdapter

Detailed Description

Parameters

Name	Type	Description	Required?	Pipeline Input	Default Value
VMHostPhysicalNic	PhysicalNic[]	Specifies the host physical network adapters that you want to add or migrate to the vSphere distributed switch.	true	False
DistributedSwitch	DistributedSwitch	Specifies the vSphere distributed switch to which you want to add the host physical network adapter.	true	True (ByValue)
Confirm	SwitchParameter	If 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.	false	False
Server	VIServer[]	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.	false	False
VirtualNicPortgroup	VDPortgroup[]	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.	false	False
VMHostVirtualNic	HostVirtualNic[]	Specifies the host virtual network adapters to be migrated along with the physical adapter, so that their connectivity is preserved.	false	False
WhatIf	SwitchParameter	Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.	false	False

Name

Type

Description

Required?

Pipeline Input

Default Value

VMHostPhysicalNic

PhysicalNic[]

Specifies the host physical network adapters that you want to add or migrate to the vSphere distributed switch.

true

False

DistributedSwitch

DistributedSwitch

Specifies the vSphere distributed switch to which you want to add the host physical network adapter.

true

True (ByValue)

Confirm

SwitchParameter

If 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.

false

False

Server

VIServer[]

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.

false

False

VirtualNicPortgroup

VDPortgroup[]

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.

false

False

VMHostVirtualNic

HostVirtualNic[]

Specifies the host virtual network adapters to be migrated along with the physical adapter, so that their connectivity is preserved.

false

False

WhatIf

SwitchParameter

Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.

false

False

Return Type

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.

PowerCLI Reference

Synopsis