Get-NetworkSwitchFeature

Gets features of a network switch.

Syntax

Get-NetworkSwitchFeature
   -CimSession <CimSession>
   [-Disabled]
   [<CommonParameters>]
Get-NetworkSwitchFeature
   -CimSession <CimSession>
   [-Enabled]
   [<CommonParameters>]
Get-NetworkSwitchFeature
   -CimSession <CimSession>
   [-Name <String>]
   [<CommonParameters>]

Description

The Get-NetworkSwitchFeature cmdlet gets features of a network switch.

Examples

Example 1: Get all features

PS C:\>$Session = New-CimSession -ComputerName "NetworkSwitch08"
PS C:\> Get-NetworkSwitchFeature -CimSession $Session
Name                                IsEnabled InstanceID             PSComputerName        
----                                --------- ----------             --------------        
SSH                                      True Contoso:Feature:2       10.19.26.49         
Tacacs                                   True Contoso:Feature:3       10.19.26.49         
BGP                                     False Contoso:Feature:4       10.19.26.49         
VLAN                                     True Contoso:Feature:5       10.19.26.49         
LACP                                     True Contoso:Feature:6       10.19.26.49         
DHCP                                    False Contoso:Feature:7       10.19.26.49         
LLDP                                     True Contoso:Feature:8       10.19.26.49

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 gets the features for the switch NetworkSwitch08 by using the $Session object. This example shows representative results.

Example 2: Get all enabled features

PS C:\>Get-NetworkSwitchFeature -CimSession $Session -Enabled

This command gets all the enabled features on a network switch. The command includes a CimSession, similar to the first example.

Example 3: Get all disabled features

PS C:\>Get-NetworkSwitchFeature -CimSession $Session -Disabled

This command gets all the disabled features on a network switch. The command includes a CimSession, similar to the first example.

Example 4: Get features by using a name

PS C:\>Get-NetworkSwitchFeature -CimSession $Session -FeatureName "*BGP*"

This command gets all features that contain the string BGP on a network switch. 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
-Disabled

Indicates that this cmdlet gets only disabled features.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Enabled

Indicates that this cmdlet gets only enabled features.

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

Optional Parameters

-Name

Specifies the name of a feature to get. Use wildcard characters to specify multiple features.

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

Inputs

None

Outputs

CimInstance[]

This cmdlet returns an array of CimInstance objects that represent network switch features.