Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP 7-mode documentation.

Cmdlet: New-NcNetPortVlan


NAME
New-NcNetPortVlan

SYNOPSIS
Create a new VLAN interface.

SYNTAX
New-NcNetPortVlan [-Node] <String> [-VlanName] <String> [-Controller <NcCont
roller[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

New-NcNetPortVlan [-ParentInterface] <String> [-Node] <String> -VlanId <UInt
16[]> [-Controller <NcController[]>] [-WhatIf] [-Confirm] [<CommonParameters
>]


DESCRIPTION
Create a new VLAN interface. The changes are persistent across reboots.


PARAMETERS
-Node <String>
The node that owns the port or ifgrp.

Required? true
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-VlanName <String>
Name of vlan interface. The name must be of the format <parent-inteface
>-<vlanid>.

Required? true
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-Controller <NcController[]>
A clustered Data ONTAP controller to receive this cmdlet, as embodied by
an NcController object. This parameter is returned by the Connect-NcCo
ntroller cmdlet. If not specified, the value in the global variable Cur
rentNcController is used. In the latter case, if CurrentNcController co
ntains a collection of NcController objects, this cmdlet is invoked on e
ach controller in succession.

Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false

-WhatIf


Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Confirm


Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-ParentInterface <String>
The name of the port or ifgrp to modify.

Required? true
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-VlanId <UInt16[]>
The VLAN IDs to add. Range: [1..4094]

Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS
DataONTAP.C.Types.Net.VlanInfo


NOTES


Category: net
API: net-vlan-create
Family: cluster

-------------- Example 1 --------------

C:\PS>New-NcNetPortVlan i0b -Node fas3070cluster01-02 -VlanId 1,2,3


Add VLAN tags 1,2,3 to ifgrp "i0b".


InterfaceName ParentInterface VlanID Node
------------- --------------- ------ ----
i0b-1 i0b 1 fas3070cluster01-02
i0b-2 i0b 2 fas3070cluster01-02
i0b-3 i0b 3 fas3070cluster01-02


-------------- Example 2 --------------

C:\PS>New-NcNetPortVlan i0b-4 fas3070cluster01-02


Create VLAN 'iob-4' to node 'fas3070cluster01-02'.


InterfaceName ParentInterface VlanID Node
------------- --------------- ------ ----
i0b-4 i0b 4 fas3070cluster01-02



RELATED LINKS
Get-NcNetPortVlan
Remove-NcNetPortVlan







 Data ONTAP® PowerShell Toolkit