Disable-NetworkSwitchFeature

Disables features of a network switch.

Syntax

Disable-NetworkSwitchFeature
       -CimSession <CimSession>
       [-Confirm]
       -FeatureName <Int32>
       [-WhatIf]
       [<CommonParameters>]
Disable-NetworkSwitchFeature
       -CimSession <CimSession>
       [-Confirm]
       -InputObject <CimInstance[]>
       [-WhatIf]
       [<CommonParameters>]
Disable-NetworkSwitchFeature
       -CimSession <CimSession>
       [-Confirm]
       -InstanceId <String>
       [-WhatIf]
       [<CommonParameters>]
Disable-NetworkSwitchFeature
       -CimSession <CimSession>
       [-Confirm]
       -Name <String>
       [-WhatIf]
       [<CommonParameters>]

Description

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

Examples

Example 1: Disable a feature by using its name

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

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.

Example 2: Disable a feature by using an instance ID

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

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

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

Type:CimSession
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FeatureName

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.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

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

Type:CimInstance[]
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-InstanceId

Specifies the instance ID of a feature to disable.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

CimInstance[]

You can pipe an array of CimInstance objects that correspond to a feature to this cmdlet.

Outputs

None

This cmdlet does not generate any output.