< Back
Get-HPESysInfoPCIDevice
Post
NAME Get-HPESysInfoPCIDevice
SYNOPSIS
Get all or specific PCI device information.
SYNTAX
Get-HPESysInfoPCIDevice [[-Username] <String>] [[-Password] <String>] [<CommonParameters>]
Get-HPESysInfoPCIDevice [-Credential <PSCredential>] [<CommonParameters>]
DESCRIPTION
The Get-HPESysInfoPCIDevice cmdlet provides detailed information about the PCI devices on the system such as class
code, VID, DID, SVID, SDID, SegmentNumber, BugNumber, DeviceNumber, and FunctionNumber.
PARAMETERS
-Username [<String>]
Username to log onto the target iLO. Username needs to be provided as an input along with Password. This
parameter is required when the iLO security is enabled.
ParameterSetName: UsernamePasswordSet
Required? false
Position? 1
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Password [<String>]
Password to log onto the target iLO. Password needs to be provided along with Username. This parameter is
required when the iLO security is enabled.
ParameterSetName: UsernamePasswordSet
Required? false
Position? 1
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Credential [<PSCredential>]
Holds the target iLO Credential in a secure manner. This parameter is required when the iLO security is
enabled.
ParameterSetName: CredentialSet
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
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
None
OUTPUTS
System.Object
NOTES
Status
The value returned in the "Status" property reflects the data retrieval operation of a cmdlet. It does not
reflect the component status. When a cmdlet returns ???????Status: Error??????? or ???????Status: Warning???????, it indicates that
the operation to retrieve the data was not successful. The ???????StatusInfo??????? message specifies the reason for the
data retrieval operation failure. If the data retrieval operation is successful, "Status: OK" is returned for
the cmdlet, and the component status is displayed in the Health property and/or other properties of the PS
object.
EXAMPLE 1
Get information about the PCI devices on the system from Get-HPESysInfoPCIDevice object.PS C:\\> $pcid =
Get-HPESysInfoPCIDevice -Username username -Password password
PS C:\\> $pcid | fl
PCIDEVICES : {@{ProductName=HP Ethernet 1Gb 2-port 332i Adapter - NIC; PhysicalLocation=Embedded LOM 1;
PciSegBusDevFn=; PciIds=; PCIDeviceType=Embedded LOM;
PCIClassCode=}, @{ProductName=HP Ethernet 1Gb 2-port 332i Adapter - NIC; PhysicalLocation=Embedded
LOM 1; PciSegBusDevFn=; PciIds=; PCIDeviceType=Embedded
LOM; PCIClassCode=}, @{ProductName=Embedded SATA Controller #1; PhysicalLocation=Embedded SATA
Controller #1; PciSegBusDevFn=; PciIds=; PCIDeviceType=HDD
Not attached to a SA Controller; PCIClassCode=}, @{ProductName=Embedded SATA Controller #2;
PhysicalLocation=Embedded SATA Controller #2; PciSegBusDevFn=;
PciIds=; PCIDeviceType=HDD Not attached to a SA Controller; PCIClassCode=}}
Status : OK
EXAMPLE 2
Get a Get-HPESysInfoPCIDevice object and use array index to display information for a specific PCI device.PS C:\\>
$pcid = Get-HPESysInfoPCIDevice -Credential $credential
PS C:\\> $pcid.PCIDEVICES[1]
ProductName : HP Ethernet 1Gb 2-port 332i Adapter - NIC
PhysicalLocation : Embedded LOM 1
PciSegBusDevFn : @{SegmentNumber=0; BusNumber=22; DeviceNumber=0; FunctionNumber=1}
PciIds : @{VendorID=5348; DeviceID=5727; SubsystemVendorID=4156; SubsystemDeviceID=8936}
PCIDeviceType : Embedded LOM
PCIClassCode : @{ClassCode=2; SubclassCode=0}
EXAMPLE 3
Get a Get-HPESysInfoPCIDevice object and show the PCI Classcode of a particular PCI device.PS C:\\> $pcid =
Get-HPESysInfoPCIDevice
PS C:\\> $pcid.PCIDEVICES[1].PCIClasscode
ClassCode SubclassCode
--------- ------------
2 0
EXAMPLE 4
Get a Get-HPESysInfoPCIDevice object and list all the PCI devices from the PCI device array.PS C:\\> $pcid=
Get-HPESysInfoPCIDevice
PS C:\\> $pcid.PCIDEVICES | fl
ProductName : HP Ethernet 1Gb 2-port 332i Adapter - NIC
PhysicalLocation : Embedded LOM 1
PciSegBusDevFn : @{SegmentNumber=0; BusNumber=22; DeviceNumber=0; FunctionNumber=0}
PciIds : @{VendorID=5348; DeviceID=5727; SubsystemVendorID=4156; SubsystemDeviceID=8936}
PCIDeviceType : Embedded LOM
PCIClassCode : @{ClassCode=2; SubclassCode=0}
ProductName : HP Ethernet 1Gb 2-port 332i Adapter - NIC
PhysicalLocation : Embedded LOM 1
PciSegBusDevFn : @{SegmentNumber=0; BusNumber=22; DeviceNumber=0; FunctionNumber=1}
PciIds : @{VendorID=5348; DeviceID=5727; SubsystemVendorID=4156; SubsystemDeviceID=8936}
PCIDeviceType : Embedded LOM
PCIClassCode : @{ClassCode=2; SubclassCode=0}
ProductName : Embedded SATA Controller #1
PhysicalLocation : Embedded SATA Controller #1
PciSegBusDevFn : @{SegmentNumber=0; BusNumber=0; DeviceNumber=23; FunctionNumber=0}
PciIds : @{VendorID=32902; DeviceID=41346; SubsystemVendorID=5520; SubsystemDeviceID=235}
PCIDeviceType : HDD Not attached to a SA Controller
PCIClassCode : @{ClassCode=1; SubclassCode=6}
ProductName : Embedded SATA Controller #2
PhysicalLocation : Embedded SATA Controller #2
PciSegBusDevFn : @{SegmentNumber=0; BusNumber=0; DeviceNumber=17; FunctionNumber=5}
PciIds : @{VendorID=32902; DeviceID=41426; SubsystemVendorID=5520; SubsystemDeviceID=235}
PCIDeviceType : HDD Not attached to a SA Controller
PCIClassCode : @{ClassCode=1; SubclassCode=6}
EXAMPLE 5
Get a Get-HPESysInfoPCIDevice object. Use the Count variable to get the number of PCI devices. Use "Get-Member |
fl Name" to list the properties in a PCI device object. Finally, display the PCIDeviceType property of all PCI
devices.PS C:\\> $pcid= Get-HPESysInfoPCIDevice
PS C:\\> $pcid.PCIDEVICES.Count
4
PS C:\\> $pcid.PCIDEVICES| Get-Member | fl Name
Name : Equals
Name : GetHashCode
Name : GetType
Name : ToString
Name : PCIClassCode
Name : PCIDeviceType
Name : PciIds
Name : PciSegBusDevFn
Name : PhysicalLocation
Name : ProductName
PS C:\\> $pcid.PCIDEVICES.PCIDeviceType
Flexible LOM
Flexible LOM
Flexible LOM
Flexible LOM
Flexible LOM
Flexible LOM
Flexible LOM
Flexible LOM
Storage Array Controller
RELATED LINKS
http://www.hpe.com/servers/powershell
SYNOPSIS
Get all or specific PCI device information.
SYNTAX
Get-HPESysInfoPCIDevice [[-Username] <String>] [[-Password] <String>] [<CommonParameters>]
Get-HPESysInfoPCIDevice [-Credential <PSCredential>] [<CommonParameters>]
DESCRIPTION
The Get-HPESysInfoPCIDevice cmdlet provides detailed information about the PCI devices on the system such as class
code, VID, DID, SVID, SDID, SegmentNumber, BugNumber, DeviceNumber, and FunctionNumber.
PARAMETERS
-Username [<String>]
Username to log onto the target iLO. Username needs to be provided as an input along with Password. This
parameter is required when the iLO security is enabled.
ParameterSetName: UsernamePasswordSet
Required? false
Position? 1
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Password [<String>]
Password to log onto the target iLO. Password needs to be provided along with Username. This parameter is
required when the iLO security is enabled.
ParameterSetName: UsernamePasswordSet
Required? false
Position? 1
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Credential [<PSCredential>]
Holds the target iLO Credential in a secure manner. This parameter is required when the iLO security is
enabled.
ParameterSetName: CredentialSet
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
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
None
OUTPUTS
System.Object
NOTES
Status
The value returned in the "Status" property reflects the data retrieval operation of a cmdlet. It does not
reflect the component status. When a cmdlet returns ???????Status: Error??????? or ???????Status: Warning???????, it indicates that
the operation to retrieve the data was not successful. The ???????StatusInfo??????? message specifies the reason for the
data retrieval operation failure. If the data retrieval operation is successful, "Status: OK" is returned for
the cmdlet, and the component status is displayed in the Health property and/or other properties of the PS
object.
EXAMPLE 1
Get information about the PCI devices on the system from Get-HPESysInfoPCIDevice object.PS C:\\> $pcid =
Get-HPESysInfoPCIDevice -Username username -Password password
PS C:\\> $pcid | fl
PCIDEVICES : {@{ProductName=HP Ethernet 1Gb 2-port 332i Adapter - NIC; PhysicalLocation=Embedded LOM 1;
PciSegBusDevFn=; PciIds=; PCIDeviceType=Embedded LOM;
PCIClassCode=}, @{ProductName=HP Ethernet 1Gb 2-port 332i Adapter - NIC; PhysicalLocation=Embedded
LOM 1; PciSegBusDevFn=; PciIds=; PCIDeviceType=Embedded
LOM; PCIClassCode=}, @{ProductName=Embedded SATA Controller #1; PhysicalLocation=Embedded SATA
Controller #1; PciSegBusDevFn=; PciIds=; PCIDeviceType=HDD
Not attached to a SA Controller; PCIClassCode=}, @{ProductName=Embedded SATA Controller #2;
PhysicalLocation=Embedded SATA Controller #2; PciSegBusDevFn=;
PciIds=; PCIDeviceType=HDD Not attached to a SA Controller; PCIClassCode=}}
Status : OK
EXAMPLE 2
Get a Get-HPESysInfoPCIDevice object and use array index to display information for a specific PCI device.PS C:\\>
$pcid = Get-HPESysInfoPCIDevice -Credential $credential
PS C:\\> $pcid.PCIDEVICES[1]
ProductName : HP Ethernet 1Gb 2-port 332i Adapter - NIC
PhysicalLocation : Embedded LOM 1
PciSegBusDevFn : @{SegmentNumber=0; BusNumber=22; DeviceNumber=0; FunctionNumber=1}
PciIds : @{VendorID=5348; DeviceID=5727; SubsystemVendorID=4156; SubsystemDeviceID=8936}
PCIDeviceType : Embedded LOM
PCIClassCode : @{ClassCode=2; SubclassCode=0}
EXAMPLE 3
Get a Get-HPESysInfoPCIDevice object and show the PCI Classcode of a particular PCI device.PS C:\\> $pcid =
Get-HPESysInfoPCIDevice
PS C:\\> $pcid.PCIDEVICES[1].PCIClasscode
ClassCode SubclassCode
--------- ------------
2 0
EXAMPLE 4
Get a Get-HPESysInfoPCIDevice object and list all the PCI devices from the PCI device array.PS C:\\> $pcid=
Get-HPESysInfoPCIDevice
PS C:\\> $pcid.PCIDEVICES | fl
ProductName : HP Ethernet 1Gb 2-port 332i Adapter - NIC
PhysicalLocation : Embedded LOM 1
PciSegBusDevFn : @{SegmentNumber=0; BusNumber=22; DeviceNumber=0; FunctionNumber=0}
PciIds : @{VendorID=5348; DeviceID=5727; SubsystemVendorID=4156; SubsystemDeviceID=8936}
PCIDeviceType : Embedded LOM
PCIClassCode : @{ClassCode=2; SubclassCode=0}
ProductName : HP Ethernet 1Gb 2-port 332i Adapter - NIC
PhysicalLocation : Embedded LOM 1
PciSegBusDevFn : @{SegmentNumber=0; BusNumber=22; DeviceNumber=0; FunctionNumber=1}
PciIds : @{VendorID=5348; DeviceID=5727; SubsystemVendorID=4156; SubsystemDeviceID=8936}
PCIDeviceType : Embedded LOM
PCIClassCode : @{ClassCode=2; SubclassCode=0}
ProductName : Embedded SATA Controller #1
PhysicalLocation : Embedded SATA Controller #1
PciSegBusDevFn : @{SegmentNumber=0; BusNumber=0; DeviceNumber=23; FunctionNumber=0}
PciIds : @{VendorID=32902; DeviceID=41346; SubsystemVendorID=5520; SubsystemDeviceID=235}
PCIDeviceType : HDD Not attached to a SA Controller
PCIClassCode : @{ClassCode=1; SubclassCode=6}
ProductName : Embedded SATA Controller #2
PhysicalLocation : Embedded SATA Controller #2
PciSegBusDevFn : @{SegmentNumber=0; BusNumber=0; DeviceNumber=17; FunctionNumber=5}
PciIds : @{VendorID=32902; DeviceID=41426; SubsystemVendorID=5520; SubsystemDeviceID=235}
PCIDeviceType : HDD Not attached to a SA Controller
PCIClassCode : @{ClassCode=1; SubclassCode=6}
EXAMPLE 5
Get a Get-HPESysInfoPCIDevice object. Use the Count variable to get the number of PCI devices. Use "Get-Member |
fl Name" to list the properties in a PCI device object. Finally, display the PCIDeviceType property of all PCI
devices.PS C:\\> $pcid= Get-HPESysInfoPCIDevice
PS C:\\> $pcid.PCIDEVICES.Count
4
PS C:\\> $pcid.PCIDEVICES| Get-Member | fl Name
Name : Equals
Name : GetHashCode
Name : GetType
Name : ToString
Name : PCIClassCode
Name : PCIDeviceType
Name : PciIds
Name : PciSegBusDevFn
Name : PhysicalLocation
Name : ProductName
PS C:\\> $pcid.PCIDEVICES.PCIDeviceType
Flexible LOM
Flexible LOM
Flexible LOM
Flexible LOM
Flexible LOM
Flexible LOM
Flexible LOM
Flexible LOM
Storage Array Controller
RELATED LINKS
http://www.hpe.com/servers/powershell