Get-NetworkSwitchEthernetPort

Gets port information for a network switch.
Get-NetworkSwitchEthernetPort [-DeviceId [<String>]] [-InformationAction {SilentlyContinue | Stop | Continue |Inquire | Ignore | Suspend}] [-InformationVariable [<System.String>]] -CimSession* <CimSession> [<CommonParameters>]
Get-NetworkSwitchEthernetPort [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore |Suspend}] [-InformationVariable [<System.String>]] -CimSession* <CimSession> -FullDuplexEnabled* [<CommonParameters>]
Get-NetworkSwitchEthernetPort [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore |Suspend}] [-InformationVariable [<System.String>]] -CimSession* <CimSession> -FullDuplexDisabled*[<CommonParameters>]
Get-NetworkSwitchEthernetPort [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore |Suspend}] [-InformationVariable [<System.String>]] -CimSession* <CimSession> -PortNumber* <Int32>[<CommonParameters>]

The Get-NetworkSwitchEthernetPort cmdlet gets port information for a network switch.

Parameters
-CimSession <CimSession>

  • This value is required

Specifies the CimSession that this cmdlet uses to connect to the network switch.

-DeviceId [<String>]

Specifies a device ID. This cmdlet gets information for the port that this parameter specifies.

-FullDuplexDisabled <SwitchParameter>

  • This value is required

Indicates that this cmdlet returns only ports that have FullDuplex disabled.

-FullDuplexEnabled <SwitchParameter>

  • This value is required

Indicates that this cmdlet returns only ports that have FullDuplex enabled.

-InformationAction [<System.Management.Automation.ActionPreference>]

Specifies how this cmdlet responds to an information event. The acceptable values for this parameter are:

— SilentlyContinue– Stop– Continue — Inquire — Ignore — Suspend

-InformationVariable [<System.String>]

Specifies a variable in which to store an information event message.

-PortNumber <Int32>

  • This value is required

Specifies a port number. This cmdlet gets the port that the parameter specifies.

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,ErrorAction, ErrorVariable, WarningAction, WarningVariable,OutBuffer, PipelineVariable, and OutVariable.

Inputs

None

Outputs

CimInstance[]

This cmdlet returns an array of CimInstance objects that correspond to Ethernet ports on a network switch.

Examples
  1. Get all the ports for a device:
    PS C:> $Session = New-CimSession -ComputerName "NetworkSwitch08"
    PS C:>  Get-NetworkSwitchEthernetPort -CimSession $Session
    

    The first command creates a CimSession for a network switch, and then stores it in the $Session variable. For more information about CimSession objects, type Get-Help New-CimSession.

    The second command gets the ports for NetworkSwitch08 by using the $Session object.

  2. Get a specific port:
    PS C:> Get-NetworkSwitchEthernetPort -PortNumber 21 -CimSession $Session
    
       Name            PortNumber DeviceID       FullDuplex    AutoSense     PortType  MaxDataSize
       ----            ---------- --------       ----------    ---------     --------  -----------
       Ethernet17              21 Ethernet17           True        False            0         9214

    This command gets port 21. The example shows the console output for the command. The command includes a CimSession, similar to the first example.

  3. Get a port with a specified ID:
    PS C:> Get-NetworkSwitchEthernetPort -DeviceID "Ethernet17" -CimSession $Session
    

    This command gets the port for the device that has the ID Ethernet17. The command includes a CimSession, similar to the first example.

Related Links

Disable-NetworkSwitchEthernetPort
Enable-NetworkSwitchEthernetPort