New-NsxEdgeSubInterface

NAME New-NsxEdgeSubInterface



SYNOPSIS

Adds a new subinterface to an existing NSX Edge Services Gateway trunk mode

interface.





SYNTAX

New-NsxEdgeSubInterface -Interface <XmlElement> -TunnelId <Int32> -Name <String> [-PrimaryAddress <String>]

[-SubnetPrefixLength <String>] [-SecondaryAddresses <String[]>] [-MTU <Int32>] [-EnableSendICMPRedirects]

[-Connected] [-Connection <PSObject>] [<CommonParameters>]



New-NsxEdgeSubInterface -Interface <XmlElement> -TunnelId <Int32> [-Network <Object>] -Name <String>

[-PrimaryAddress <String>] [-SubnetPrefixLength <String>] [-SecondaryAddresses <String[]>] [-MTU <Int32>]

[-EnableSendICMPRedirects] [-Connected] [-Connection <PSObject>] [<CommonParameters>]



New-NsxEdgeSubInterface -Interface <XmlElement> -TunnelId <Int32> [-VLAN <Int32>] -Name <String> [-PrimaryAddress

<String>] [-SubnetPrefixLength <String>] [-SecondaryAddresses <String[]>] [-MTU <Int32>]

[-EnableSendICMPRedirects] [-Connected] [-Connection <PSObject>] [<CommonParameters>]





DESCRIPTION

NSX ESGs can host up to 10 interfaces and up to 200 subinterfaces, each of which

can be configured with multiple properties.



ESGs support interfaces connected to either VLAN backed port groups or NSX

Logical Switches.



Use New-NsxEdgeSubInterface to add a new subinterface.





PARAMETERS

-Interface <XmlElement>



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-TunnelId <Int32>



Required? true

Position? named

Default value 0

Accept pipeline input? false

Accept wildcard characters? false



-Network <Object>



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-VLAN <Int32>



Required? false

Position? named

Default value 0

Accept pipeline input? false

Accept wildcard characters? false



-Name <String>



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-PrimaryAddress <String>



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-SubnetPrefixLength <String>



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-SecondaryAddresses <String[]>



Required? false

Position? named

Default value @()

Accept pipeline input? false

Accept wildcard characters? false



-MTU <Int32>



Required? false

Position? named

Default value 0

Accept pipeline input? false

Accept wildcard characters? false



-EnableSendICMPRedirects [<SwitchParameter>]



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-Connected [<SwitchParameter>]



Required? false

Position? named

Default value True

Accept pipeline input? false

Accept wildcard characters? false



-Connection <PSObject>

PowerNSX Connection object



Required? false

Position? named

Default value $defaultNSXConnection

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



-------------------------- EXAMPLE 1 --------------------------



PS C:\\>Get an NSX Edge interface and configure a new subinterface in VLAN mode.



PS C:\\> $trunk = Get-NsxEdge $name | Get-NsxEdgeInterface "vNic3"



PS C:\\> $trunk | New-NsxEdgeSubinterface -Name "sub1" -PrimaryAddress $ip5

-SubnetPrefixLength 24 -TunnelId 1 -Vlan 123









-------------------------- EXAMPLE 2 --------------------------



PS C:\\>Get an NSX Edge interface and configure a new subinterface in Network mode.



PS C:\\> $trunk = Get-NsxEdge $name | Get-NsxEdgeInterface "vNic3"



PS C:\\> $trunk | New-NsxEdgeSubinterface -Name "sub1" -PrimaryAddress $ip5

-SubnetPrefixLength 24 -TunnelId 1 -Network $LS2











RELATED LINKS