Edit

Share via

Enable-NetworkSwitchEthernetPort

Module:
NetworkSwitchManager Module

Enables an Ethernet port on a network switch.

Syntax

DeviceIdSet 

Enable-NetworkSwitchEthernetPort
    -CimSession <CimSession>
    -DeviceID <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

PortNumberSet 

Enable-NetworkSwitchEthernetPort
    -CimSession <CimSession>
    -PortNumber <Int32>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectSet 

Enable-NetworkSwitchEthernetPort
    -CimSession <CimSession>
    -InputObject <CimInstance[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Enable-NetworkSwitchEthernetPort cmdlet enables an Ethernet port on a network switch.

Examples

Example 1: Enable a port by using a device ID

PS C:\>$Session = New-CimSession -ComputerName "NetworkSwitch08"
PS C:\> Enable-NetworkSwitchEthernetPort -DeviceID "Ethernet17" -CimSession $Session

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 enables ports for the device that has the ID Ethernet17 by using the $Session object.

Example 2: Enable a port by using a port number

PS C:\>Enable-NetworkSwitchEthernetPort -Port 21 -CimSession $Session

This command enables port 21. The command includes a CimSession, similar to the first example.

Parameters

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

Parameter properties

Type:CimSession
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DeviceID

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

DeviceIdSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InputObject

Specifies the input object that is used in a pipeline command.

Parameter properties

Type:

CimInstance[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

InputObjectSet
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-PortNumber

Specifies a port to enable.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

PortNumberSet
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

CimInstance

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

Outputs

Object