Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP Cluster-mode documentation.

Cmdlet: Ping-NaFcpInfo


NAME
Ping-NaFcpInfo

SYNOPSIS
Send an ELS ECHO frame to a Fibre Channel address or WWPN. The cmdlet pings
the address or WWPN count times and returns the number of successful pings a
nd times.

SYNTAX
Ping-NaFcpInfo [-FcpAdapter] <String> [-FcpPortId] <UInt32> [[-PingCount] <I
nt32>] [[-Payload] <String>] [-Controller <NaController>] [<CommonParameters
>]

Ping-NaFcpInfo [-FcpAdapter] <String> [-FcpWwpn] <String> [[-PingCount] <Int
32>] [[-Payload] <String>] [-Controller <NaController>] [<CommonParameters>]


DESCRIPTION
Send an ELS ECHO frame to a Fibre Channel address or WWPN. The cmdlet pings
the address or WWPN count times and returns the number of successful pings a
nd times.


PARAMETERS
-FcpAdapter <String>
Adapter to send the ping request from.

Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false

-FcpPortId <UInt32>
The Fibre Channel address to ping.

Required? true
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false

-PingCount <Int32>
The number of pings. Default is 3. Max is 16.

Required? false
Position? 3
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Payload <String>
Additional data to send in the payload of the ELS ECHO frame. The payloa
d can be up to 255 characters long.

Required? false
Position? 4
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Controller <NaController>
The Data ONTAP controller object, embodied by an NaController object. T
his parameter is returned by the Connect-NaController cmdlet. If not sp
ecified, the value in the global variable CurrentNaController is used.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-FcpWwpn <String>
The Fibre Channel WWPN to ping. The format of a WWPN is XX:XX:XX:XX:XX:X
X:XX:XX where X is a hexadecimal digit.

Required? true
Position? 2
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
DataONTAP.Types.Fcp.PingFcpInfo


NOTES


Category: fcp
API: fcp-ping-info

-------------- Example 1 --------------

C:\PS>Ping-NaFcpInfo -FcpAdapter 0d -FcpWwpn 50:0a:09:80:87:09:3b:1f -PingCo
unt 5


Ping the WWPN 50:0a:09:80:87:09:3b:1f from FCP adapter 0d.


FramesReceived : 5
FramesTransmitted : 5
RoundTripMaxTime : 8
RoundTripMaxTimeTS : 00:00:00.0000080
RoundTripMeanTime : 8
RoundTripMeanTimeTS : 00:00:00.0000080
RoundTripMinTime : 8
RoundTripMinTimeTS : 00:00:00.0000080



RELATED LINKS
Ping-NaFcp







 Data ONTAP® PowerShell Toolkit