Get-NetworkSwitchEthernetPort

適用対象: Windows 10 Technical Preview

Get-NetworkSwitchEthernetPort

Gets port information for a network switch.

構文

Parameter Set: DeviceIDSet
Get-NetworkSwitchEthernetPort -CimSession <CimSession> [-DeviceId <String> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]

Parameter Set: FullDuplexDisabledSet
Get-NetworkSwitchEthernetPort -CimSession <CimSession> -FullDuplexDisabled [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]

Parameter Set: FullDuplexEnabledSet
Get-NetworkSwitchEthernetPort -CimSession <CimSession> -FullDuplexEnabled [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]

Parameter Set: PortNumberSet
Get-NetworkSwitchEthernetPort -CimSession <CimSession> -PortNumber <Int32> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]

詳細説明

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

パラメーター

-CimSession<CimSession>

Specifies the CimSession that this cmdlet uses to connect to the network switch. For more information about CimSession objects, type Get-Help New-CimSession.

Aliases

none

必須/オプション

true

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-DeviceId<String>

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

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-FullDuplexDisabled

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

Aliases

none

必須/オプション

true

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-FullDuplexEnabled

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

Aliases

none

必須/オプション

true

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-InformationAction<System.Management.Automation.ActionPreference>

Specifies how this cmdlet responds to an information event. このパラメーターに指定できる値は、次のとおりです。

-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend

Aliases

infa

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-InformationVariable<System.String>

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

Aliases

iv

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-PortNumber<Int32>

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

Aliases

none

必須/オプション

true

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

<CommonParameters>

このコマンドレットは共通のパラメーターをサポートしています(-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable)。詳細については、TechNet の「 「about_CommonParameters」 (https://go.microsoft.com/fwlink/p/?LinkID=113216) を参照してください。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

  • None

出力

出力型は、コマンドレットが出力するオブジェクトの型です。

  • CimInstance[]

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

使用例

Example 1: Get all the ports for a device

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.

PS C:\> $Session = New-CimSession -ComputerName "NetworkSwitch08"
PS C:\> Get-NetworkSwitchEthernetPort -CimSession $Session

Example 2: Get a specific port

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

PS C:\> Get-NetworkSwitchEthernetPort -PortNumber 21 -CimSession $Session

Example 3: Get a port with a specified ID

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

PS C:\> Get-NetworkSwitchEthernetPort -DeviceID "Ethernet17" -CimSession $Session

関連項目

Disable-NetworkSwitchEthernetPort

Enable-NetworkSwitchEthernetPort