Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Disable-NetworkSwitchFeature

Disable-NetworkSwitchFeature

networkswitchvlan.psm1, networkswitchglobalsettingdata.psm1, networkswitchfeature.psm1, networkswitchethernetport.psm1, networkswitchconfiguration.psm1

Synopsis

Disables features of a network switch.

Syntax

Disable-NetworkSwitchFeature [-InformationAction] [-InformationVariable] [-CimSession] [-FeatureName] [<CommonParameters>]

Disable-NetworkSwitchFeature [-InformationAction] [-InformationVariable] [-CimSession] [-Name] [<CommonParameters>]

Disable-NetworkSwitchFeature [-InformationAction] [-InformationVariable] [-CimSession] [-InstanceId] [<CommonParameters>]

Disable-NetworkSwitchFeature [-InformationAction] [-InformationVariable] [-CimSession] [<CommonParameters>]

Detailed Description

The Disable-NetworkSwitchFeature cmdlet disables specified features of a network switch.

Parameters

-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

Required?

true

Position

named

Default value

none

Accept pipeline input?

false

Accept wildcard characters?

false

-FeatureName <Int32>

Specifies a feature name, an integer, of a feature to disable. A feature name might not be unique. This cmdlet disables all features with the same name.

Aliases

none

Required?

true

Position

named

Default value

none

Accept pipeline input?

false

Accept wildcard characters?

false

-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

Aliases

infa

Required?

false

Position

named

Default value

none

Accept pipeline input?

false

Accept wildcard characters?

false

-InformationVariable <System.String>

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

Aliases

iv

Required?

false

Position

named

Default value

none

Accept pipeline input?

false

Accept wildcard characters?

false

-InstanceId <String>

Specifies the instance ID of a feature to disable.

Aliases

none

Required?

true

Position

named

Default value

none

Accept pipeline input?

false

Accept wildcard characters?

false

-Name <String>

Specifies the name of a feature to disable. This parameter supports wildcard characters.

Aliases

none

Required?

true

Position

named

Default value

none

Accept pipeline input?

false

Accept wildcard characters?

false

Input Type

CimInstance[]

Return Type

None

Notes

None

Examples

Example 1: Disable a feature by using its name

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 disables the feature named SSH for the network switch NetworkSwitch08 by using the $Session object.

PS C:\>$Session = New-CimSession -ComputerName "NetworkSwitch08"
PS C:\> Disable-NetworkSwitchFeature -CimSession $Session -Name "SSH"

Example 2: Disable a feature by using an instance ID

This command disables a feature by using the instance ID to identify it. The command includes a CimSession, similar to the first example.

PS C:\>Disable-NetworkSwitchFeature -CimSession $Session -InstanceID "Contoso:Feature:2"

Enable-NetworkSwitchFeature
Get-NetworkSwitchFeature