< Back

Add-VDSwitchPhysicalNetworkAdapter

Sun Jan 19, 2020 7:22 pm

NAME 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>]





DESCRIPTION

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





PARAMETERS

-DistributedSwitch <DistributedSwitch>

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



Required? true

Position? 2

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? 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.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? 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.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-VMHostPhysicalNic <PhysicalNic[]>

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



Required? true

Position? 1

Default value None

Accept pipeline input? False

Accept wildcard characters? true



-VMHostVirtualNic <HostVirtualNic[]>

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

connectivity is preserved.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



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



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

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

modified.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

None







NOTES









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



RELATED LINKS

Online Version: https://code.vmware.com/doc/preview?id= ... apter.html

Remove-VDSwitchPhysicalNetworkAdapter