NAME
Get-NetworkSwitchVlan
SYNOPSIS
Gets VLANs for a network switch.SYNTAX
Get-NetworkSwitchVlan [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]
[-InformationVariable
] -Caption -CimSession [ ] Get-NetworkSwitchVlan [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]
[-InformationVariable
] [-Name ] -CimSession [ ] Get-NetworkSwitchVlan [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]
[-InformationVariable
] -CimSession -VlanId [ ] Get-NetworkSwitchVlan [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]
[-InformationVariable
] -CimSession -InstanceId [ ] Get-NetworkSwitchVlan [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]
[-InformationVariable
] -CimSession -Description [ ] DESCRIPTION
The Get-NetworkSwitchVlan cmdlet gets available virtual local area networks (VLANs) for a network switch.
PARAMETERS
-Caption
Specifies the caption of a VLAN to get. Required? true Position? named Default value none Accept pipeline input? false Accept wildcard characters? false-CimSession
Specifies the CimSession that this cmdlet uses to connect to the network switch. For more information aboutCimSession objects, type Get-Help New-CimSession.
Required? true Position? named Default value none Accept pipeline input? false Accept wildcard characters? false-Description
Specifies the description of a VLAN to get. Required? true Position? named Default value none Accept pipeline input? false Accept wildcard characters? false-InformationAction [
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 [
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] -InstanceId
Specifies the instance ID of a VLAN to get. Required? true Position? named Default value none Accept pipeline input? false Accept wildcard characters? false-Name [
] Specifies the name of a VLAN to get. This ElementName is a friendly name. It is not necessarily unique.
Required? false Position? named Default value none Accept pipeline input? false Accept wildcard characters? false-VlanId
Specifies the VLAN ID of the VLAN to get. Required? true Position? named Default value none Accept pipeline input? false Accept wildcard characters? falseThis cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216). INPUTS
NoneOUTPUTS
CimInstance[] This cmdlet returns an array of CimInstance objects for network switch VLANs.Example 1: Get all VLANs for a network switch
PS C:\>$Session = New-CimSession -ComputerName "NetworkSwitch08"
PS C:\> Get-NetworkSwitchVlan -CimSession $Session
Caption Description Name InstanceID VlanID PSComputerName
------- ----------- ----------- ---------- ------ --------------
Vlan_description default Contoso:NetworkVL... 1 10.19.246.18 Vlan_description VLAN0002 Contoso:NetworkVL... 2 10.19.246.18The 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 all VLAN for the switch NetworkSwitch08 by using the $Session object.
Example 2: Get a VLAN by using a name
PS C:\>Get-NetworkSwitchVlan -CimSession $Session -Name "VLAN22"
Caption Description Name InstanceID VlanID PSComputerName
------- ----------- ----------- ---------- ------ --------------
Vlan_description VLAN22 Contoso:NetworkVL... 1 10.19.236.49 This command gets the VLAN named VLAN22. The command includes a CimSession, similar to the first example.RELATED LINKS
Disable-NetworkSwitchVlan
Enable-NetworkSwitchVlan
New-NetworkSwitchVlan
Remove-NetworkSwitchVlan
Set-NetworkSwitchVlanProperty