Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP 7-mode documentation.

Cmdlet: New-NcNetPortIfgrp


NAME
New-NcNetPortIfgrp

SYNOPSIS
Create a new network interface group (ifgrp).

SYNTAX
New-NcNetPortIfgrp [-Name] <String> [-Node] <String> [-DistributionFunction]
<String> [-Mode] <String> [-Controller <NcController[]>] [-WhatIf] [-Confir
m] [<CommonParameters>]


DESCRIPTION
Create a new network interface group (ifgrp).


PARAMETERS
-Name <String>
The name of the ifgrp to create. Must use the format <letter><number><l
etter>.

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

-Node <String>
The node that will own the new ifgrp.

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

-DistributionFunction <String>
The traffic distribution function of the new ifgrp. Values include mac,
ip, sequential, port.

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

-Mode <String>
The link policy of the new ifgrp. Values include multimode, multimode_l
acp, singlemode.

Required? true
Position? 4
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

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


NOTES


Category: net
API: net-port-ifgrp-create
Family: cluster

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

C:\PS>New-NcNetPortIfgrp i0b -Node fas3070cluster01-02 -DistributionFunction
mac -Mode singlemode


Create a new ifgrp.


NcController : 10.61.172.155
DistributionFunction : mac
DownPorts :
IfgrpName : i0b
MacAddress : 02:a0:98:0a:d4:7e
Mode : singlemode
Node : fas3070cluster01-02
PortParticipation : none
Ports :
UpPorts :



RELATED LINKS
Get-NcNetPortIfgrp
Remove-NcNetPortIfgrp
Add-NcNetPortIfgrpPort







 Data ONTAP® PowerShell Toolkit