Disable-NetworkSwitchEthernetPort

Disables an Ethernet port on a network switch.
Disable-NetworkSwitchEthernetPort [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore |Suspend}] [-InformationVariable [<System.String>]] -CimSession* <CimSession> -DeviceID* <String> [<CommonParameters>]
Disable-NetworkSwitchEthernetPort [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore |Suspend}] [-InformationVariable [<System.String>]] -CimSession* <CimSession> -PortNumber* <Int32>[<CommonParameters>]
Disable-NetworkSwitchEthernetPort [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore |Suspend}] [-InformationVariable [<System.String>]] -CimSession* <CimSession> [<CommonParameters>]

The Disable-NetworkSwitchEthernetPort cmdlet disables an Ethernet port on 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>

  • This value is required

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

<CommonParameters>

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

Inputs

CimInstance[]

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

Outputs

None

This cmdlet does not generate any output.

Examples
  1. Disable a port:
    PS C:> $Session = New-CimSession -ComputerName "NetworkSwitch08"
    PS C:>  Disable-NetworkSwitchEthernetPort -CimSession $Session -PortNumber 21
    

    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.

  2. Disable a port by using a device ID:
    PS C:> Disable-NetworkSwitchEthernetPort -CimSession $Session -DeviceId "Ethernet17"
    

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

Related Links

Enable-NetworkSwitchEthernetPort
Get-NetworkSwitchEthernetPort