Get-NetworkSwitchFeature

Gets features of a network switch.
Get-NetworkSwitchFeature [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}][-InformationVariable [<System.String>]] [-Name [<String>]] -CimSession* <CimSession> [<CommonParameters>]
Get-NetworkSwitchFeature [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}][-InformationVariable [<System.String>]] -CimSession* <CimSession> -Enabled* [<CommonParameters>]
Get-NetworkSwitchFeature [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}][-InformationVariable [<System.String>]] -CimSession* <CimSession> -Disabled* [<CommonParameters>]

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

Parameters
-CimSession <CimSession>

  • This value is required

Specifies the CimSession that this cmdlet uses to connect to the network switch.

-Disabled <SwitchParameter>

  • This value is required

Indicates that this cmdlet gets only disabled features.

-Enabled <SwitchParameter>

  • This value is required

Indicates that this cmdlet gets only enabled features.

-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

-InformationVariable [<System.String>]

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

-Name [<String>]

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

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,ErrorAction, ErrorVariable, WarningAction, WarningVariable,OutBuffer, PipelineVariable, and OutVariable.

Inputs

None

Outputs

CimInstance[]

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

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

  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.

  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.

  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.

Related Links

Disable-NetworkSwitchFeature
Enable-NetworkSwitchFeature