Edit

Share via


Enable-NetworkSwitchFeature

Enables features of a network switch.

Syntax

FeatureNameSet

Enable-NetworkSwitchFeature
    -CimSession <CimSession>
    -FeatureName <Int32>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NameSet

Enable-NetworkSwitchFeature
    -CimSession <CimSession>
    -Name <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InstanceIdSet

Enable-NetworkSwitchFeature
    -CimSession <CimSession>
    -InstanceId <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectSet

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

Description

The Enable-NetworkSwitchFeature cmdlet enables specified features of a network switch.

Examples

Example 1: Enable a feature by using its name

PS C:\>$Session = New-CimSession -ComputerName "NetworkSwitch08"
PS C:\> Enable-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 enables the feature named SSH for the switch NetworkSwitch08 by using the $Session object.

Example 2: Enable a feature by using its instance ID

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

This command enables a feature by using the instance ID to identify it. 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

-FeatureName

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

Parameter properties

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

Parameter sets

FeatureNameSet
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

-InstanceId

Specifies the instance ID of a feature to enable.

Parameter properties

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

Parameter sets

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

-Name

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

Parameter properties

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

Parameter sets

NameSet
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 a network switch feature to this cmdlet.

Outputs

Object