|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Get-NcNetPort
NAME
Get-NcNetPort
SYNOPSIS
Get network ports.
SYNTAX
Get-NcNetPort [[-Name] <String[]>] [-Node <String[]>] [-LinkStatus <String[]
>] [-Role <String[]>] [-Attributes <NetPortInfo>] [-Controller <NcController
[]>] [<CommonParameters>]
Get-NcNetPort -Template [-Controller <NcController[]>] [<CommonParameters>]
Get-NcNetPort -Query <NetPortInfo> [-Attributes <NetPortInfo>] [-Controller
<NcController[]>] [<CommonParameters>]
DESCRIPTION
Get network ports.
PARAMETERS
-Name <String[]>
The name of one or more ports to get. Data ONTAP wildcards are permitte
d.
Required? false
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Node <String[]>
Restrict results to the specified nodes(s). Data ONTAP wildcards are pe
rmitted.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-LinkStatus <String[]>
Restrict results to the specified link status. Data ONTAP wildcards are
permitted.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Role <String[]>
Restrict results to the specified port role(s). Data ONTAP wildcards ar
e permitted.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Attributes <NetPortInfo>
For improved scalability in large clusters, provide a NetPortInfo object
with various fields set to indicate which fields to return on all objec
ts. Undesired fields should remain set to null. Use "Get-NcNetPort -Te
mplate" to get the initially empty NetPortInfo object. If not specified
, all data is returned for each object.
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
-Template
Specify to get an empty NetPortInfo object for use with advanced queries
involving the Query attribute.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Query <NetPortInfo>
For advanced queries, provide a NetPortInfo object with various fields s
et to indicate which records to retrieve. Other fields should remain se
t to null. Use "Get-NcNetPort -Template" to get the initially empty Net
PortInfo object.
Required? true
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.NetPortInfo
NOTES
Category: net
API: net-port-get-iter
Family: cluster
-------------- Example 1 --------------
C:\PS>Get-NcNetPort e1d -Node Cerebus-05
Get the details for port 'e1d' on node 'Cerebus-05'.
Node : Cerebus-05
Port : e1d
NcController : cerebus
Name : e1d
AdministrativeDuplex : full
AdministrativeFlowcontrol : full
AdministrativeSpeed : auto
AutorevertDelay :
IfgrpDistributionFunction :
IfgrpMode :
IfgrpNode :
IfgrpPort :
IsAdministrativeAutoNegotiate : True
IsAdministrativeUp : True
IsOperationalAutoNegotiate : True
LinkStatus : up
MacAddress : 00:15:17:ef:bc:2f
Mtu : 1500
OperationalDuplex : full
OperationalFlowcontrol : full
OperationalSpeed : 1000
PortType : physical
Role : data
VlanId :
VlanNode :
VlanPort :
AutorevertDelaySpecified : False
IsAdministrativeAutoNegotiateSpecified : True
IsAdministrativeUpSpecified : True
IsOperationalAutoNegotiateSpecified : True
MtuSpecified : True
VlanIdSpecified : False
-------------- Example 2 --------------
C:\PS>$attr = Get-NcNetPort -Template
$attr.LinkStatus = ""
Get-NcNetPort -Attributes $attr | select Node,Port,LinkStatus
Get and show (only) the link status for each port.
Node Port LinkStatus
---- ---- ----------
Cerebus-03 e0a up
Cerebus-03 e0b up
Cerebus-03 e0c up
Cerebus-03 e0d up
Cerebus-03 e1a up
Cerebus-03 e1b up
Cerebus-03 e1c up
Cerebus-03 e1d up
Cerebus-04 e0a up
Cerebus-04 e0b up
Cerebus-04 e0c up
Cerebus-04 e0d up
Cerebus-04 e1a up
Cerebus-04 e1b up
Cerebus-04 e1c up
Cerebus-04 e1d up
Cerebus-05 e0a up
Cerebus-05 e0b up
Cerebus-05 e0c up
Cerebus-05 e0d up
Cerebus-05 e1a up
Cerebus-05 e1b up
Cerebus-05 e1c up
Cerebus-05 e1d up
RELATED LINKS
Set-NcNetPort
| Copyright © 2013 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|