Get-Port
SYNOPSIS
Gets a list of ports or the specified director and port on a PowerMax array.
SYNTAX
All (Default)
Get-Port [-Unisphere] <UnisphereServer> [-ArrayId] <String> [-Type <string>] [-Aclx <Boolean>] [-IscsiTarget <Boolean>] [-EnabledProtocol <string>]
[-Identify] [<CommonParameters>]
ById
Get-Port [-Unisphere] <UnisphereServer> [-ArrayId] <String> -Id <String> [<CommonParameters>]
ByDirectorPortId
Get-Port [-Unisphere] <UnisphereServer> [-ArrayId] <String> -Director <String> -Port <String>
[<CommonParameters>]
DESCRIPTION
Gets the list of ports on a PowerMax array. Provides the ability to query by port type, by Access Logix enabled state, and by a specific director and port on the array.
EXAMPLES
Example 1
PS C:\> Get-Port -Unisphere $unisphere -ArrayId 000123456789
Where $unisphere is a Unisphere server instance. Returns a list of all ports in the PowerMax array 000123456789.
Example 2
PS C:\> Get-Port -Unisphere $unisphere -ArrayId 000123456789 -Aclx $True
Where $unisphere is a Unisphere server instance. Returns a list of all ports with Access Logix enabled.
Example 3
PS C:\> Get-Port -Unisphere $unisphere -ArrayId 000123456789 -IscsiTarget $True
Where $unisphere is a Unisphere server instance. Returns a list of all ports that are designated as an iSCSI target.
Example 4
PS C:\> Get-Port -Unisphere $unisphere -ArrayId 000123456789 -Type OSHostFibreChannel
Where $unisphere is a Unisphere server instance. Returns a list of Fiber Channel ports in the PowerMax array 000123456789. Note that ‘FibreChannel’ is an alias to the actual type ‘OSHostFibreChannel’ which can also be used. Another alias for ‘OSHostFibreChannel’ is ‘FC’.
Example 5
PS C:\> Get-Port -Unisphere $unisphere -ArrayId 000123456789 -Type GigE
Where $unisphere is a Unisphere server instance. Returns a list of Gigabit Ethernet ports in the PowerMax array 000123456789. Note that ‘GigE’ is an alias to the actual type ‘OSHostGigE’ which can also be used.
Example 6
PS C:\> Get-Port -Unisphere $unisphere -ArrayId 000123456789 -EnabledProtocol SCSIFC
Where $unisphere is a Unisphere server instance. Returns a list of OR ports in the PowerMax array 000123456789 that have their Enabled Protocol set to ‘SCSIFC’. Note that this is only applicable for V4 arrays, which support OR ports with configurable protocols.
Example 7
PS C:\> Get-Port -Unisphere $unisphere -ArrayId 000123456789 -Id FA-1D:8
Where $unisphere is a Unisphere server instance. Returns information of director FA-1D port 8 on the PowerMax array 000123456789.
Example 8
PS C:\> Get-Port -Unisphere $unisphere -ArrayId 000123456789 -Director FA-1D -Port 8
Where $unisphere is a Unisphere server instance. Returns information of director FA-1D port 8 on the PowerMax array 000123456789.
PARAMETERS
-Unisphere
The Unisphere server instance.
Type: UnisphereServer
Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-ArrayId
The PowerMax array ID.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-Type
Port type. Query by the ‘Type’ field. The query is case insensitive.
Type: String
Parameter Sets: All
Aliases:
Accepted values: OSHostGigE, OSHostFibreChannel, RDF, OSHostAndRDF
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnabledProtocol
Enabled protocol on the port. Only available on V4 arrays. Query by the ‘EnabledProtocol’ field. The query is case insensitive.
Type: String
Parameter Sets: All
Aliases:
Accepted values: None, RDFFC, RDFGigE, HostFICON, SCSIFC, iSCSI, NCMeFC, NVMeTCP
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Director
The director ID.
Type: String
Parameter Sets: ByDirectorPortId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-Port
The port ID.
Type: String
Parameter Sets: ByDirectorPortId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-Id
Director:Port ID.
Type: String
Parameter Sets: ById
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-Aclx
Filter by Access Logix state. By default all ports are returned.
Type: Boolean
Parameter Sets: All
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IscsiTarget
Filter by iSCSI target state. By default all ports are returned.
Type: Boolean
Parameter Sets: All
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Identify
Returns the list of ports in
Type: SwitchParameter
Parameter Sets: All
Aliases: List
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.