Data Object Description

Properties

Name	Type	Description
autoNegotiateSupported*	xsd:boolean	If set the flag indicates if the physical network adapter supports autonegotiate. *Since* vSphere API 4.1
device	xsd:string	The device name of the physical network adapter.
dpuId*	xsd:string	The identifier of the DPU by which the physical NIC is backed. When physical NIC is not backed by DPU, dpuId will be unset. *Since* 8.0.0.1
driver*	xsd:string	The name of the driver. From command line: esxcli network nic get
driverVersion*	xsd:string	The version of the physical network adapter operating system driver. *Since* 8.0.0.1
enhancedNetworkingStackSupported*	xsd:boolean	If set the flag indicates whether a physical nic supports Enhanced Networking Stack driver *Since* vSphere API 6.7
ensInterruptSupported*	xsd:boolean	If set the flag indicates whether a physical nic supports Enhanced Networking Stack interrupt mode *Since* vSphere API 7.0
fcoeConfiguration*	FcoeConfig	The FCoE configuration of the physical network adapter. *Since* vSphere API 5.0
firmwareVersion*	xsd:string	The version of the firmware running in the network adapter. *Since* 8.0.0.1
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.
mac	xsd:string	The media access control (MAC) address of the physical network adapter. *Since* VI API 2.5
pci	xsd:string	Device hash of the PCI device corresponding to this physical network adapter.
rdmaDevice*	xsd:string	Associated RDMA device, if any. *Since* vSphere API 7.0
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
spec	PhysicalNicSpec	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	Deprecated. As of vSphere API 8.0. VMDirectPath Gen 2 is no longer supported and there is no replacement. 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	Deprecated. As of vSphere API 8.0. VMDirectPath Gen 2 is no longer supported and there is no replacement. 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 vSphere Distributed Switch have a particular ProductSpec in order for network passthrough to be possible. *Since* vSphere API 4.1
wakeOnLanSupported	xsd:boolean	Flag indicating whether the NIC is wake-on-LAN capable *Since* VI API 2.5
Properties inherited from DynamicData
None

Name

Type

Description

autoNegotiateSupported*

xsd:boolean

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

Since vSphere API 4.1

device

xsd:string

The device name of the physical network adapter.

dpuId*

xsd:string

The identifier of the DPU by which the physical NIC is backed. When physical NIC is not backed by DPU, dpuId will be unset.

Since 8.0.0.1

driver*

xsd:string

The name of the driver. From command line: esxcli network nic get

driverVersion*

xsd:string

The version of the physical network adapter operating system driver.

Since 8.0.0.1

enhancedNetworkingStackSupported*

xsd:boolean

If set the flag indicates whether a physical nic supports Enhanced Networking Stack driver

Since vSphere API 6.7

ensInterruptSupported*

xsd:boolean

If set the flag indicates whether a physical nic supports Enhanced Networking Stack interrupt mode

Since vSphere API 7.0

fcoeConfiguration*

FcoeConfig

The FCoE configuration of the physical network adapter.

Since vSphere API 5.0

firmwareVersion*

xsd:string

The version of the firmware running in the network adapter.

Since 8.0.0.1

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.

mac

xsd:string

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

Since VI API 2.5

pci

xsd:string

Device hash of the PCI device corresponding to this physical network adapter.

rdmaDevice*

xsd:string

Associated RDMA device, if any.

Since vSphere API 7.0

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

spec

PhysicalNicSpec

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

Deprecated. As of vSphere API 8.0. VMDirectPath Gen 2 is no longer supported and there is no replacement.

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

Deprecated. As of vSphere API 8.0. VMDirectPath Gen 2 is no longer supported and there is no replacement.

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 vSphere Distributed Switch have a particular ProductSpec in order for network passthrough to be possible.

Since vSphere API 4.1

wakeOnLanSupported

xsd:boolean

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

Since VI API 2.5

Properties inherited from DynamicData

None

Need not be set

Show WSDL type definition

         <complexType xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="PhysicalNic">
            <complexContent>
               <extension base="vim25:DynamicData">
                  <sequence>
                     <element name="key" type="xsd:string" minOccurs="0"/>
                     <element name="device" type="xsd:string"/>
                     <element name="pci" type="xsd:string"/>
                     <element name="driver" type="xsd:string" minOccurs="0"/>
                     <element name="driverVersion" type="xsd:string" minOccurs="0"/>
                     <element name="firmwareVersion" type="xsd:string" minOccurs="0"/>
                     <element name="linkSpeed" type="vim25:PhysicalNicLinkInfo" minOccurs="0"/>
                     <element name="validLinkSpecification" type="vim25:PhysicalNicLinkInfo" minOccurs="0" maxOccurs="unbounded"/>
                     <element name="spec" type="vim25:PhysicalNicSpec"/>
                     <element name="wakeOnLanSupported" type="xsd:boolean"/>
                     <element name="mac" type="xsd:string"/>
                     <element name="fcoeConfiguration" type="vim25:FcoeConfig" minOccurs="0"/>
                     <element name="vmDirectPathGen2Supported" type="xsd:boolean" minOccurs="0"/>
                     <element name="vmDirectPathGen2SupportedMode" type="xsd:string" minOccurs="0"/>
                     <element name="resourcePoolSchedulerAllowed" type="xsd:boolean" minOccurs="0"/>
                     <element name="resourcePoolSchedulerDisallowedReason" type="xsd:string" minOccurs="0" maxOccurs="unbounded"/>
                     <element name="autoNegotiateSupported" type="xsd:boolean" minOccurs="0"/>
                     <element name="enhancedNetworkingStackSupported" type="xsd:boolean" minOccurs="0"/>
                     <element name="ensInterruptSupported" type="xsd:boolean" minOccurs="0"/>
                     <element name="rdmaDevice" type="xsd:string" minOccurs="0"/>
                     <element name="dpuId" type="xsd:string" minOccurs="0"/>
                  </sequence>
               </extension>
            </complexContent>
         </complexType>

Data Object - PhysicalNic(vim.host.PhysicalNic)

Data Object Description