New-NetworkSwitchVlan

S'applique à: Windows 10 Technical Preview

New-NetworkSwitchVlan

Creates a VLAN for a network switch.

Syntaxe

Parameter Set: Default
New-NetworkSwitchVlan [-CimSession] <CimSession> [[-Caption] <String> ] [[-Description] <String> ] [-VlanID] <Int32> [-Name] <String> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]

Description détaillée

The New-NetworkSwitchVlan cmdlet creates a virtual local area network (VLAN) for a network switch.

Paramètres

-Caption<String>

Specifies a caption for the new VLAN.

Alias

none

Requis ?

false

Position ?

2

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

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

Alias

none

Requis ?

true

Position ?

1

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Description<String>

Specifies a description of the new VLAN.

Alias

none

Requis ?

false

Position ?

3

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-InformationAction<System.Management.Automation.ActionPreference>

Specifies how this cmdlet responds to an information event. Les valeurs acceptables pour ce paramètre sont les suivantes : 

-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend

Alias

infa

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-InformationVariable<System.String>

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

Alias

iv

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Name<String>

Specifies a name to use as the VLAN ElementName. This is a friendly name.

Alias

none

Requis ?

true

Position ?

5

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-VlanID<Int32>

Specifies a VLAN ID for the new VLAN.

Alias

none

Requis ?

true

Position ?

4

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez  . about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d'entrée correspond au type des objets que vous pouvez adresser à l'applet de commande.

  • None

Sorties

Le type de sortie correspond au type des objets que l'applet de commande émet.

  • None

    This cmdlet does not generate any output.

Exemples

Example 1: Create a VLAN

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 creates a VLAN for the switch NetworkSwitch08 by using the $Session object.

PS C:\> $Session = New-CimSession -ComputerName "NetworkSwitch08"
PS C:\> New-NetworkSwitchVlan -Name "Contoso07VLAN" -Caption "VLAN 07" -CimSession $Session

Rubriques connexes

Disable-NetworkSwitchVlan

Enable-NetworkSwitchVlan

Get-NetworkSwitchVlan

Remove-NetworkSwitchVlan

Set-NetworkSwitchVlanProperty