Set-NetworkSwitchVlanProperty

Article
11/16/2015

S'applique à: Windows 10 Technical Preview

Set-NetworkSwitchVlanProperty

Modifies properties on a VLAN on a network switch.

Syntaxe

Parameter Set: InputObjectSet
Set-NetworkSwitchVlanProperty -CimSession <CimSession> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-Property <Hashtable> ] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: VlanIdSet
Set-NetworkSwitchVlanProperty -CimSession <CimSession> -VlanId <Int32[]> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-Property <Hashtable> ] [ <CommonParameters>] [ <WorkflowParameters>]

Description détaillée

The Set-NetworkSwitchVlanProperty cmdlet modifies settable properties on a virtual local area network (VLAN) on a network switch.

Paramètres

-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 ?	named
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

-Property<Hashtable>

Specifies a hash table of name/value pairs. The cmdlet sets the properties that this parameter specifies.

Alias	none
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-VlanId<Int32[]>

Specifies an array of VLAN IDs of VLANs to modify.

Alias	none
Requis ?	true
Position ?	named
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).

<WorkflowParameters>

Entrées

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

CimInstance[]

You can pipe an array of CimInstance objects that represent VLANs to this cmdlet.

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: Set properties for 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 and third commands assign values to the $VlanName variable and the $Description variable. These are the values of the key/value pairs.

The final command modifies the properties of the VLAN identified by the VLAN ID 5 to include the name/value pairs specified by the Property parameter. The command uses standard syntax to create a hash table that contains the name/value pairs. The command operates on the network switch named NetworkSwitch08 by using the $Session object.

PS C:\> $Session = New-CimSession -ComputerName "NetworkSwitch08"
PS C:\> $VlanName = "Contoso VLAN 07"
PS C:\> $Description = "This VLAN is used to create a virtual Contoso company LAN"
PS C:\> Set-NetworkSwitchVlanProperty -VlanId 12 -Property @{ElementName = $VlanName; Description = $Description} -CimSession $Session