Get-Initiator
SYNOPSIS
Gets details of the initiators on a PowerStore cluster. Supports PowerStore version 3.0 and above.
SYNTAX
ById (default)
Get-Initiator [-Cluster] <Cluster> [[-Id] <String[]>] [<CommonParameters>]
ByHostId
Get-Initiator [-Cluster] <Cluster> [-HostId] <String[]> [<CommonParameters>]
ByProtocol
Get-Initiator [-Cluster] <Cluster> [-Protocol] <String> [<CommonParameters>]
DESCRIPTION
Gets details of the initiators on a PowerStore cluster. The options include listing all initiators on the cluster, getting initiators by ID, getting initiators by their attached Host ID, and getting initiators by their connection protocol.
EXAMPLES
Example 1
PS C:\> Get-Initiator -Cluster $cluster
Where $cluster is a PowerStore cluster instance. Returns a list of all initiators on the PowerStore cluster.
Example 2
PS C:\> Get-Initiator -Cluster $cluster -Id id1,id2
Where $cluster is a PowerStore cluster instance. Returns initiators with IDs id1 and id2 on the PowerStore cluster.
Example 3
PS C:\> Get-Initiator -Cluster $cluster -HostId id1,id2
Where $cluster is a PowerStore cluster instance. Returns all initiators attached to hosts with IDs id1 and id2 on the PowerStore cluster.
Example 4
PS C:\> Get-Initiator -Cluster $cluster -Protocol FC
Where $cluster is a PowerStore cluster instance. Returns all initiators with fibre channel as their port type on the PowerStore cluster.
PARAMETERS
-Cluster
The PowerStore cluster instance.
Type: Cluster
Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-Id
The initiator ID(s) to retrieve.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-HostId
The host ID(s) to find matching initiators for.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Protocol
The protocol (port type) to find matching initiators for.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Default value: None
Accepted values: iSCSI, FC, NVMe, NVMe_vVol
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.