Disable-NetworkSwitchEthernetPort

S'applique à: Windows 10 Technical Preview

Disable-NetworkSwitchEthernetPort

Disables an Ethernet port on a network switch.

Syntaxe

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>]

Description détaillée

The Disable-NetworkSwitchEthernetPort cmdlet disables an Ethernet port on a network switch.

Paramètres

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

-DeviceID<String>

Specifies a device ID. This cmdlet disables a port on a device that this parameter specifies.

-InformationAction<System.Management.Automation.ActionPreference>

Specifies how this cmdlet responds to an information event. Les valeurs acceptables pour ce paramètre sont les suivantes : 

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

-InformationVariable<System.String>

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

-PortNumber<Int32>

Specifies a port to disable.

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez  . about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

<WorkflowParameters>

Entrées

Le type d'entrée correspond au type des objets que vous pouvez adresser à l'applet de commande.

• CimInstance[]

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

Sorties

Le type de sortie correspond au type des objets que l'applet de commande émet.

• None

  This cmdlet does not generate any output.

Exemples

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"

Rubriques connexes

Enable-NetworkSwitchEthernetPort

Get-NetworkSwitchEthernetPort