< Back
Get-NetworkSwitchFeature
Post
NAME Get-NetworkSwitchFeature
SYNOPSIS
Gets features of a network switch.
SYNTAX
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>]
DESCRIPTION
The Get-NetworkSwitchFeature cmdlet gets 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.
Required? true
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Disabled <SwitchParameter>
Indicates that this cmdlet gets only disabled features.
Required? true
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Enabled <SwitchParameter>
Indicates that this cmdlet gets only enabled features.
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
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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Name [<String>]
Specifies the name of a feature to get. Use wildcard characters to specify multiple features.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
OUTPUTS
CimInstance[]
This cmdlet returns an array of CimInstance objects that represent network switch features.
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.
RELATED LINKS
Disable-NetworkSwitchFeature
Enable-NetworkSwitchFeature
SYNOPSIS
Gets features of a network switch.
SYNTAX
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>]
DESCRIPTION
The Get-NetworkSwitchFeature cmdlet gets 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.
Required? true
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Disabled <SwitchParameter>
Indicates that this cmdlet gets only disabled features.
Required? true
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Enabled <SwitchParameter>
Indicates that this cmdlet gets only enabled features.
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
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.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Name [<String>]
Specifies the name of a feature to get. Use wildcard characters to specify multiple features.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
OUTPUTS
CimInstance[]
This cmdlet returns an array of CimInstance objects that represent network switch features.
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.
RELATED LINKS
Disable-NetworkSwitchFeature
Enable-NetworkSwitchFeature