Get-NetworkSwitchEthernetPort

아티클
11/16/2015

적용 대상: 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.

별칭	none
필수 여부	true
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

-DeviceId<String>

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

별칭	none
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

-FullDuplexDisabled

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

별칭	none
필수 여부	true
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

-FullDuplexEnabled

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

별칭	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

별칭	infa
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

-InformationVariable<System.String>

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

별칭	iv
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

-PortNumber<Int32>

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

별칭	none
필수 여부	true
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 TechNet의 about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216)

입력

입력 형식은 cmdlet으로 파이프할 수 있는 개체의 형식입니다.

None

출력

출력 형식은 cmdlet 실행 시 출력되는 개체의 형식입니다.

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

Get-NetworkSwitchEthernetPort