Disable-NetworkSwitchEthernetPort

[アーティクル]
11/16/2015

適用対象: Windows 10 Technical Preview

Disable-NetworkSwitchEthernetPort

Disables an Ethernet port on a network switch.

構文

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

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

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

詳細説明

The Disable-NetworkSwitchEthernetPort cmdlet disables an Ethernet port on 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 disables a port on a device that this parameter specifies.

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 to disable.

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) を参照してください。

<WorkflowParameters>

入力

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

CimInstance[]

You can pipe an array of CimInstance objects that correspond to an Ethernet port to this cmdlet.

出力

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

None

This cmdlet does not generate any output.

使用例

Example 1: Disable a port

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.

This command disables port 21 for NetworkSwitch08 by using the $Session object.

PS C:\> $Session = New-CimSession -ComputerName "NetworkSwitch08"
PS C:\> Disable-NetworkSwitchEthernetPort -CimSession $Session -PortNumber 21

Example 2: Disable a port by using a device ID

This command disables an Ethernet port with device ID Ethernet17 on a network switch. The command uses a CimSession, similar to the first example.

PS C:\> Disable-NetworkSwitchEthernetPort -CimSession $Session -DeviceId "Ethernet17"

Disable-NetworkSwitchEthernetPort