< Back
Get-HPESysInfoPCISlot
Post
NAME Get-HPESysInfoPCISlot
SYNOPSIS
Get all or specific PCI slot information.
SYNTAX
Get-HPESysInfoPCISlot [[-Username] <String>] [[-Password] <String>] [<CommonParameters>]
Get-HPESysInfoPCISlot [-Credential <PSCredential>] [<CommonParameters>]
DESCRIPTION
The Get-HPESysInfoPCISlot cmdlet provides detailed information about the PCI slots on the system such as location,
status, type, and characteristics.
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? 0
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 PCI slots on the system from the Get-HPESysInfoPCISlot object.PS C:\\> $pcis =
Get-HPESysInfoPCISlot -Username username -Password password
PS C:\\> $pcis | fl
PCISLOTS : {@{SlotLocation=PCI-E Slot 1; SlotStatus=InUse; SlotType=PCIExpressGen3; SlotLength=Long;
SlotLinkLanes=x16; SlotSupportsHotPlug=False}, @{SlotLocation=PCI-E
Slot 2; SlotStatus=InUse; SlotType=PCIExpressGen3; SlotLength=Short; SlotLinkLanes=x8;
SlotSupportsHotPlug=False}, @{SlotLocation=NVMe Drive Box 2 Bay 1;
SlotStatus=InUse; SlotType=Not Available; SlotLength=Other; SlotLinkLanes=x4;
SlotSupportsHotPlug=True}, @{SlotLocation=NVMe Slot ; SlotStatus=Empty;
SlotType=Not Available; SlotLength=Other; SlotLinkLanes=x4; SlotSupportsHotPlug=True}}
Status : OK
EXAMPLE 2
Get a Get-HPESysInfoPCISlot object and use array index to display information for specific PCI slots.PS C:\\> $pcis
= Get-HPESysInfoPCISlot -Credential $credential
PS C:\\> $pcis.PCISLOTS[0,2]
SlotLocation : PCI-E Slot 1
SlotStatus : InUse
SlotType : PCIExpressGen3
SlotLength : Long
SlotLinkLanes : x16
SlotSupportsHotPlug : False
SlotLocation : NVMe Drive Box 2 Bay 1
SlotStatus : InUse
SlotType : Not Available
SlotLength : Other
SlotLinkLanes : x4
SlotSupportsHotPlug : True
EXAMPLE 3
Get a Get-HPESysInfoPCISlot object and show the total number of PCI Slots and their locations.PS C:\\>
$pcis.PCISLOTS.Count
4
PS C:\\> $pcis.PCISLOTS.SlotLocation
PCI-E Slot 1
PCI-E Slot 2
NVMe Drive Box 2 Bay 1
NVMe Slot
RELATED LINKS
http://www.hpe.com/servers/powershell
SYNOPSIS
Get all or specific PCI slot information.
SYNTAX
Get-HPESysInfoPCISlot [[-Username] <String>] [[-Password] <String>] [<CommonParameters>]
Get-HPESysInfoPCISlot [-Credential <PSCredential>] [<CommonParameters>]
DESCRIPTION
The Get-HPESysInfoPCISlot cmdlet provides detailed information about the PCI slots on the system such as location,
status, type, and characteristics.
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? 0
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 PCI slots on the system from the Get-HPESysInfoPCISlot object.PS C:\\> $pcis =
Get-HPESysInfoPCISlot -Username username -Password password
PS C:\\> $pcis | fl
PCISLOTS : {@{SlotLocation=PCI-E Slot 1; SlotStatus=InUse; SlotType=PCIExpressGen3; SlotLength=Long;
SlotLinkLanes=x16; SlotSupportsHotPlug=False}, @{SlotLocation=PCI-E
Slot 2; SlotStatus=InUse; SlotType=PCIExpressGen3; SlotLength=Short; SlotLinkLanes=x8;
SlotSupportsHotPlug=False}, @{SlotLocation=NVMe Drive Box 2 Bay 1;
SlotStatus=InUse; SlotType=Not Available; SlotLength=Other; SlotLinkLanes=x4;
SlotSupportsHotPlug=True}, @{SlotLocation=NVMe Slot ; SlotStatus=Empty;
SlotType=Not Available; SlotLength=Other; SlotLinkLanes=x4; SlotSupportsHotPlug=True}}
Status : OK
EXAMPLE 2
Get a Get-HPESysInfoPCISlot object and use array index to display information for specific PCI slots.PS C:\\> $pcis
= Get-HPESysInfoPCISlot -Credential $credential
PS C:\\> $pcis.PCISLOTS[0,2]
SlotLocation : PCI-E Slot 1
SlotStatus : InUse
SlotType : PCIExpressGen3
SlotLength : Long
SlotLinkLanes : x16
SlotSupportsHotPlug : False
SlotLocation : NVMe Drive Box 2 Bay 1
SlotStatus : InUse
SlotType : Not Available
SlotLength : Other
SlotLinkLanes : x4
SlotSupportsHotPlug : True
EXAMPLE 3
Get a Get-HPESysInfoPCISlot object and show the total number of PCI Slots and their locations.PS C:\\>
$pcis.PCISLOTS.Count
4
PS C:\\> $pcis.PCISLOTS.SlotLocation
PCI-E Slot 1
PCI-E Slot 2
NVMe Drive Box 2 Bay 1
NVMe Slot
RELATED LINKS
http://www.hpe.com/servers/powershell