Data Object - PhysicalNic

Property of
HostNetworkInfo, HostProxySwitch, HostVirtualSwitch
Extends
DynamicData
See also
PhysicalNicLinkInfo, PhysicalNicSpec

Data Object Description

This data object type describes the physical network adapter as seen by the primary operating system.

Properties

Name Type Description
autoNegotiateSupported*xsd:boolean

If set the flag indicates if the physical network adapter supports autonegotiate.

Since vSphere API 4.1
devicexsd:string

The device name of the physical network adapter.
driver*xsd:string

The name of the driver.
key*xsd:string

The linkable identifier.
linkSpeed*PhysicalNicLinkInfo

The current link state of the physical network adapter. If this object is not set, then the link is down.
macxsd:string

The media access control (MAC) address of the physical network adapter.

Since VI API 2.5
pcixsd:string

Device hash of the PCI device corresponding to this physical network adapter.
resourcePoolSchedulerAllowed*xsd:boolean

Flag indicating whether the NIC allows resource pool based scheduling for network I/O control.

Since vSphere API 4.1
resourcePoolSchedulerDisallowedReason*xsd:string[]

If resourcePoolSchedulerAllowed is false, this property advertises the reason for disallowing resource scheduling on this NIC. The reasons may be one of PhysicalNicResourcePoolSchedulerDisallowedReason

Since vSphere API 4.1
specPhysicalNicSpec

The specification of the physical network adapter.
validLinkSpecification*PhysicalNicLinkInfo[]

The valid combinations of speed and duplexity for this physical network adapter. The speed and the duplex settings usually must be configured as a pair. This array lists all the valid combinations available for a physical network adapter.

Autonegotiate is not listed as one of the combinations supported. If is implicitly supported by the physical network adapter unless autoNegotiateSupported is set to false.

vmDirectPathGen2Supported*xsd:boolean

Flag indicating whether the NIC supports VMDirectPath Gen 2. Note that this is only an indicator of the capabilities of this NIC, not of the whole host.

If the host software is not capable of VMDirectPath Gen 2, this property will be unset, as the host cannot provide information on the NIC capability.
See vmDirectPathGen2Supported

Since vSphere API 4.1
vmDirectPathGen2SupportedMode*xsd:string

If vmDirectPathGen2Supported is true, this property advertises the VMDirectPath Gen 2 mode supported by this NIC (chosen from PhysicalNicVmDirectPathGen2SupportedMode). A mode may require that the associated vNetwork Distributed Switch have a particular ProductSpec in order for network passthrough to be possible.

Since vSphere API 4.1
wakeOnLanSupportedxsd:boolean

Flag indicating whether the NIC is wake-on-LAN capable

Since VI API 2.5
Properties inherited from DynamicData
dynamicProperty, dynamicType
*Need not be set
Show WSDL type definition