Set-NetworkSwitchPortMode

S'applique à: Windows 10 Technical Preview

Set-NetworkSwitchPortMode

Sets the port mode on a network switch.

Syntaxe

Parameter Set: AccessSet
Set-NetworkSwitchPortMode -AccessMode -CimSession <CimSession> -VlanID <Int32> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: RouteSet
Set-NetworkSwitchPortMode -CimSession <CimSession> -IpAddress <String> -RouteMode -SubnetAddress <String> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: TrunkSet
Set-NetworkSwitchPortMode -CimSession <CimSession> -TrunkMode -VlanIDs <UInt16[]> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>] [ <WorkflowParameters>]

Description détaillée

The Set-NetworkSwitchPortMode cmdlet sets the port mode to access, trunk or route on a network switch.

Paramètres

-AccessMode

Indicates that this cmdlet sets the port to access mode.

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

-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

-InformationVariable<System.String>

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

-IpAddress<String>

Specifies an IP address to set for the port in route mode.

-RouteMode

Indicates that this cmdlet sets the port to route mode.

-SubnetAddress<String>

Specifies the subnet mask to set for the port in route mode.

-TrunkMode

Indicates that this cmdlet sets the port to trunk mode.

-VlanID<Int32>

Specifies the virtual local area network (VLAN) ID of the VLAN to set for the port in access mode.

-VlanIDs<UInt16[]>

Specifies the VLAN IDs of the VLANs to set for the port in trunk mode.

<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 correspond to a network switch port 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 a port to trunk mode

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 sets NetworkSwitch08 to use trunk mode by using the $Session object. The command specifies IDs for three VLANs.

PS C:\> $Session = New-CimSession -ComputerName "NetworkSwitch08"
PS C:\> Set-NetworkSwitchPortMode -CimSession $Session -TrunkMode -VlanIDs 2,17,22 

Example 2: Set a port to route mode

This command sets the port to route mode. The command specifies its IP address and the subnet mask. The command includes a CimSession, similar to the first example.

PS C:\> Set-NetworkSwitchPortMode -CimSession $Session -IpAddress "10.14.1.1" -RouteMode -SubnetAddress "255.255.0.0"

Rubriques connexes

Get-NetworkSwitchEthernetPort