Data ONTAP PowerShell Toolkit: Cmdlet Get-NaFcpInitiator

Overview
Categories
Cmdlets
APIs
Release notes
License
Data ONTAP® PowerShell Toolkit
Cmdlet: Get-NaFcpInitiator


NAME
    Get-NaFcpInitiator
    
SYNOPSIS
    Get the list of initiators currently connected to the specified Fibre Channe
    l target adapter.
    
SYNTAX
    Get-NaFcpInitiator [[-Adapter] <String>] [-Controller <NaController>] [-Warn
    ingAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters
    >]
    
    
DESCRIPTION
    Get the list of initiators currently connected to the specified Fibre Channe
    l target adapter, or if none specified, a list of initiators connected to an
    y FC target adapter. Information returned for each initiator includes the po
    rtname of initiators that are currently logged in with the the FC target ada
    pters. If the portname is in an initiator group, then the group name is also
     included.  Also the Fibre Channel host address and the nodename/portname of
     the initiators are included as well. Connectivity of adapters running on be
    half of partners are not included in the list when requesting for all adapte
    rs.  If listing for all adapters and an error occurred for while retrieving 
    connection status for an adapter, status for that adapter will not be return
    ed, and the API will continue on with the rest of the adapters without error
    ing out.  You can get the error msg for that adapter, by specifically specif
    ying that adapter.
    

PARAMETERS
    -Adapter <String>
        Adapter to get initiator list for.  If no adapter is specified, informat
        ion is returned for all initiators connected through any fcp adapter in 
        the system.
        
        Required?                    false
        Position?                    1
        Default value                
        Accept pipeline input?       true (ByValue, ByPropertyName)
        Accept wildcard characters?  false
        
    -Controller <NaController>
        The DataONTAP controller object, embodied by an NaController object.  Th
        is parameter is returned by the Connect-NaController cmdlet.  If not spe
        cified, the value in the global variable CurrentNaController is used.
        
        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -WarningAction <ActionPreference>
        
        
        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -WarningVariable <String>
        
        
        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".
    
INPUTS
    
     
    
OUTPUTS
    NetApp.Ontapi.Filer.Fcp.FcpAdapterInitiatorsInfo
     
    
NOTES
    
    
        Category: fcp
        API: fcp-adapter-initiators-list-info
    
    --------------  Example 1 --------------
    
    C:\PS>Get-NaFcpInitiator
    
    
    Get all initiators connected to all FC target adapters.
    
    
    Adapter                                 FcpConnectedInitiators
    -------                                 ----------------------
    0c                                      {20:00:00:e0:8b:9d:c5:4d, 20:00:00:0
    ...
    0d                                      {20:01:00:e0:8b:bd:c5:4d, 20:00:00:0
    ...
    
    
    
RELATED LINKS
Data ONTAP® PowerShell Toolkit