|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Ping-NcHost
NAME
Ping-NcHost
SYNOPSIS
Ping an IP address to verify whether the interface is alive.
SYNTAX
Ping-NcHost [-Host] <String> [-Node] <String> [-Count <Int32>] [-WaitSeconds
<Int32>] [-Raw] [-Controller <NcController[]>] [<CommonParameters>]
Ping-NcHost [-Host] <String> -InterfaceOwner <String> -Interface <String> [-
Count <Int32>] [-WaitSeconds <Int32>] [-Raw] [-UseSourcePort] [-Controller <
NcController[]>] [<CommonParameters>]
DESCRIPTION
Ping an IP address to verify whether the interface is alive.
PARAMETERS
-Host <String>
The address of the destination.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Node <String>
Specifies the node from which the ping request is to be sent.
Required? true
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Count <Int32>
The number of pings to try before giving up. Default is 20.
Required? false
Position? named
Default value 20
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-WaitSeconds <Int32>
The number of seconds to wait between pings. Default is 1.
Required? false
Position? named
Default value 1
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Raw
Specify to get an unwrapped boolean value.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Controller <NcController[]>
A clustered Data ONTAP controller to receive this cmdlet, as embodied by
an NcController object. This parameter is returned by the Connect-NcCo
ntroller cmdlet. If not specified, the value in the global variable Cur
rentNcController is used. In the latter case, if CurrentNcController co
ntains a collection of NcController objects, this cmdlet is invoked on e
ach controller in succession.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-InterfaceOwner <String>
Specifies the name of an interface owner. It may be a node or Vserver n
ame.
Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Interface <String>
Specifies the interface from which the ping request is to be sent.
Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-UseSourcePort
If true, send out ping via the port which is hosting the lif. Only appl
icable when interface parameter when specified.
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
DataONTAP.C.Types.Net.PingHostResult
NOTES
Category: net
API: net-cluster-ping
Family: cluster
-------------- Example 1 --------------
C:\PS>Ping-NcHost -Host 10.61.167.22 -Node Cerebus-03 -Raw
Ping a host by IP address and write the raw boolean to the pipeline.
True
-------------- Example 2 --------------
C:\PS>Get-NcNode | Ping-NcHost 10.61.167.22 -Count 1
Ensure each node can ping a host.
Host Success Node
---- ------- ----
10.61.167.22 True Cerebus-03
10.61.167.22 True Cerebus-04
10.61.167.22 True Cerebus-05
10.61.167.22 True Cerebus-06
-------------- Example 3 --------------
C:\PS>Ping-NcHost -Host 10.61.167.22 -InterfaceOwner Lionetti01 -Interface L
ionetti01_mgmt
Ping a host from a specific interface defined on a vserver.
NcController : cerebus
Host : 10.61.167.22
Success : True
Node :
InterfaceOwner : Lionetti01
Interface : Lionetti01_mgmt
RELATED LINKS
Get-NcNetInterface
Get-NcNode
| Copyright © 2013 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|